1.  Install FortLM License Server

Typical Setup Example A: Install FortLM license server on a single, central Linux computer to serve license check-out and check-in requests from multiple client application installations.

Typical Example Setup B: Install FortLM license server on a single, central Windows computer to serve license check-out and check-in requests from multiple client application installations.

 

Install License Server On Linux:

Linux 64-bit AMD64 (x64) users please download seguesoft-foobar-fortlm-license-server-yyyy.mm.dd-linux_x64.tar.gz
To install license server on Linux, simply  extract it as shown below:

   tar -zvxf seguesoft-foobar-fortlm-license-server-yyyy.mm.dd-linux_x86.tar.gz

Install License Server On Windows:

Windows uses should download self-extractable installer such as "seguesoft-foobar--fortlm-license-server-yyyy.mm.dd-windows.exe".  Double click to install it.

2. Get the hostID of the server machine and request your official floating license file

For a workgroup floating license you (or your system administrator) will be setting up a single central license server dedicated to serve license checkout requests for all of your team members over your network. So you must send us the hostID of the license server computer (not the hostID seen when you start MasterYANG)!

Linux License Server:

Go into the directory where you extracted the server package, for example:

  cd seguesoft-foobar-fortlm-license-server-yyyy.mm.dd-linux_x64
./start.sh              

Windows License Server:

Select "All Programs -> SegueSoft NETCONFc (MasterYANG) FortLM License Server -> start.bat" to run. Alternatively you can open a DOS prompt and fire the following commands:

     cd C:\SegueSoft\FortLM_Foobar_License_Server

     start.bat

Running start.bat (or start.sh on Linux) first time you will receive an error message, along with the hostID of host computer as shown below: 

The license server host computer's hostID can also be obtained by running flmid command.

To request your official license file, please email This email address is being protected from spambots. You need JavaScript enabled to view it. with ALL of the following:
A) Your license server's hostID above,
B) Your license server platform installed: Windows license server or Linux license server 
C) Your product S/N found in your order confirmation email. 

3. Install the floating license file you received on the license server

After receiving your license file (usually named fortlm_license.lic) in an email attachment, save it  into your license server installation directory.

then open it in your favorite text editor and edit the SERVERLINE line:

              SERVER=hostname_or_IP; PORT=port_no; 

Replace hostname_or_IP with the host name or IP address of the license server computer, and replace port_no with a free port number (should be greater than 1024). Note if you use a hostname then that name must be reachable from your client computers. For example, if your server computer is configured with a hostname ‘calypso’ then from a client computer you at least should be able to ping using the hostname ‘calyso’, otherwise no network connection can be made.

For Example, after editing,  the line may look like:
              SERVER=192.168.2.2; PORT=4545;

or if using a host name:
              SERVER=myhost.myorg.com; PORT=4545; 

Keep all other fields unchanged and then save the file fortlm_license.lic as a text formatted (plain text)  file.

Note: It is recommended that customers use text-only editors such as vi on Linux or notepad on Windows to edit the original fortlm_license.lic file received from us. Only change the line mentioned above and leave everything else untouched. If you edit the file using non text only editors such as Windows Word or Open office then they may get errors like the signature is incorrect and the file has been edited incorrectly.  This is because the license file MUST be in TEXT ONLY format!

Note: If you change 'ANYIF=No;' to 'ANYIF=Yes;' then the server will listen on any interface on this server computer. In this scenario please make sure you still use SERVER=192.168.2.2; or SERVER=hostname_or_IP;  *NOT* SERVER=0.0.0.0;! Otherwise despite there would be no error messages generated when you start your license server, a client application who imports this license file will not be able to find the targeted license server to connect to.

4. Start FortLM license server

Now with a copy of customized fortlm_license.lic saved in your license server installation directory, you can start (or restart) the license server by running start.bat or start.sh (Linux).

Upon success, you should see a message similar as shown below:

 

Note you must make sure the port chosen is not blocked by your firewall. On Linux you can add the port chosen as an exception to firewall rules. On  Windows you MUST configure firewall to allow "flmserver" as an exception ("flmserver" is the actual program that starts the license server).

Alternatively you can start FortLM license server directly as shown below:

   /path-to/flmserver /path-to/fortlm_license.lic  /path-to/seguesoft_pub_key.pem

 

5. How to star FortLM license server automatically when computer starts?

On Linux, change your start.sh to use full path and invoke it in /etc/rc.d/rc.local

For example, your start.sh may look like (all in one line):

cd /path-to-license-server-installation-dir && start.sh &

By default the license check-in and check-out will be logged in the file
/tmp/NETCONFc_(or MasterYANG) _license_Server_Access_Log.txt

Note placing the start.sh command in /etc/rc.local is a convenient way to run it automatically when the server computer reboots. On some Linux distributions the /etc/rc.local may have been disabled by default or deprecated. In this case you may need to write a script and place it in /etc/init.d.

The script in init.d needs to be able to handle at least  a “start” and a “stop” arguments. To start the license server, you can use the command (rather than using start.sh):

/path-to-flmserver/flmserver /path-to-license-file/my-license.lic /path-to-public-key/seguesoft_pub_key.pem

To stop an active flmserver just run command “pkill flmserver”

 

On Windows

Windows system:
    You can install your License Server as a Windows Service.   To do that, select the program icon:
 
    "All Programs
         - SegueSoft NETCONFc (or MasterYANG) FortLM License Server
            --  Install License Server as a Service"
 
    Once you have installed the License Server as a service, it will be started automatically when computer starts.
 
    To start and stop the service manually, you can use Windows service controller (Control Panel | Administrative
    Tools | Services: 'SegueSoft NETCONFc (or MasterYANG) FortLM License Server').
 
    If the license server is started as a Windows service, you can find the license check-in and check-out logs in
    the log file named "SegueSoft_NETCONFc(or MasterYANG)_license_Server_Access_Log.txt", which can be
    found in the same directory where 'start.bat' is installed.

Another option is you can use Windows task scheduler to schedule a task that runs NETCONFc (or MasterYANG) License server automatically when computer starts.