Question QI-005 (continued)

Please note that the following instructions are for installation of a floating license on Windows computers only.

The installation instructions for various other license types and platforms may be found here.

From ADINA 9.1 onwards, the floating license program used is Reprise License Manager (RLM). RLM will host the floating license for versions 9.1 and later. Older versions (9.0 and earlier) will continue to use Sentinel License Manager (SLM) — instructions pertaining to the SLM are at the bottom of this page.

System ID for Floating License (for ADINA 9.1 onwards)

The ADINA floating license uses Reprise License Manager (RLM). The system ID for the floating license (based on the ethernet card ID) is obtained by running the "RLM Host ID" program on the license server machine.

  Start > Programs > ADINA System n.n
  > Floating License > RLM Host ID
  

As indicated, please send the hostid and host information to ADINA R & D (email: password@adina.com) to obtain the license file. After you run this program, you should also see a file 'rlmhostid.txt' that contains the RLM hostid and host information in the %ADINAHOME%\rlm directory.

Start Floating License Server

Typically, ADINA R & D will email you the license file based on the RLM Host ID that you provided. The license file will have a ".lic" extension which must not be changed.

Place the license file in the %ADINAHOME%\RLM directory of the license server machine.
%ADINAHOME% is the directory where you installed the ADINA System, typically it is "C:\ADINAnn".

To start the ADINA floating license server, open a Command Prompt window, navigate to the %ADINAHOME%\RLM directory and run the RLM server program.

  rlm -dlog rlm.log
  

Once the license server is started, you can check its status by running the rlmstat command.

  rlmstat -a
  
You can also check the status and perform administration of the RLM license server through the RLM Web Server described in the next section.


NOTE: Closing the command window that runs rlm will also terminate the rlm process. If leaving the command window open is not a good option, you can run the RLM server as a Windows Service. To install RLM as a service, you can run the following command or use the RLM Web Server (next section).
  rlm -install_service -dlog rlm.log
	

The rlm service needs to be started or stopped through the Control Panel. The default Startup Type setting is 'Manual'. If you want the rlm service to start automatically when the computer is restarted, set it to 'Automatic'.

If necessary, the rlm service can be deleted using the following command or through the RLM Web Server.

  rlm -delete_service
	

RLM Web Server

The RLM server contains an embedded Web Server which can be used to perform most administration of the RLM server. The Web Server can be accessed through a web browser on port 5054 (default) of the license server machine.

Access to the RLM Web Interface can be controlled via the RLM password file "rlm.pw" in the directory that contains the RLM server program "rlm.exe".

The "rlm.pw" file has one line for each user, formatted as follows:

  username:password:list-of-permissions
	
As the ADINA floating license administrator, you can first create a "rlm.pw" file that contains the list of users and permissions without any password.
  tom::all
  harry::status
	
You can then login to the RLM Web Server for each user and click on the "Change Password" button to assign password to each user. For example, if you assign a password to user "tom", the "rlm.pw" file will look like
  tom:WfqeEUTzbWMK88yp7uGBNvK9eRv:all
  harry::status
	
where "WfqeEUTzbWMK88yp7uGBNvK9eRv" is the encrypted password for user "tom" who can access all actions and user "harry" has no password and can only check the status of the RLM server program.

The "rlm.pw" file should be protected so that ordinary users do not have write access to the file.

Stop Floating License Server

To stop the ADINA Floating License Server, you can click on the "Shutdown" button in the RLM Web Server interface or run the following commands in a Command Prompt window.

  rlmdown adina
  rlmdown RLM
	

However, if you are running the RLM license server as a service on Windows, you will need to stop the service via the Windows Services control panel.

Common Problems

A client computer looks for the file 'license.dat' when trying to run ADINA
Log out of the Windows account and then log in again; this allows the System Environment Variables to be loaded properly. Then try to run ADINA or invoke the AUI.

If this does not work, confirm that the installation is for a floating license client (not node-locked) — the System Environment Variable 'ADINALCTYPE' should have the value 'NETWORK' for an industrial license, or 'EDUCATIONAL' for an academic license.

If the value of ADINALCTYPE is correct, use the RLM Web Server to check the status of the license server. If it does not load, there is an issue with your network setup. Common causes are firewall settings, or, in the case of the academic license, the client computer is not within the IP subnet definition of the floating license.

No license features listed in the RLM Web Server
Check your firewall and make sure that TCP/UDP Port 5053 and TCP Port 49117 are open.

RLM server already running for other programs
When there is already an instance of RLM running on a license server computer, the ADINA licenses can be combined into the pool of licenses administered by that instance of RLM. To do this, copy the adina.set and the *.lic license file from the %ADINAHOME%\RLM directory to the corresponding directory of the existing RLM server. (This ensures that the adina.set file, the *.lic license file and the rlm.exe program are all in the same directory.) Then use the RLM Web Server to reread all licenses. Note that ADINA uses RLM 10.1. If the existing RLM instance is an older version, you may wish to combine those licenses into ADINA's instead.

It is possible to have two RLM instances running on a single license server computer. In this case, it may be necessary to avoid conflicts in TCP Ports by assigning different ports to ADINA. TCP and UDP 5053 are used by RLM and TCP 49117 is used by ADINA. In addition, TCP 5054 is the default monitoring port, and will have to be assigned to another TCP Port to view the RLM Web Server for ADINA.

- TCP/UDP 5053 and 49117 may be changed in the corresponding HOST and ISV lines of the .lic ADINA license file using a text editor. Note that TCP 49117 is also set in the System Environment Variable 'adina_LICENSE', which therefore must be modified.

- TCP 5054 for the RLM Web Server monitor can be changed to NNNN by the command

  rlm -dlog rlm.log -ws NNNN
	

More details about RLM are found in the RLM License Administration Manual.




 System ID for Floating License (for ADINA 9.0 and earlier)

Older versions of ADINA use Sentinel License Manager (SLM). The system ID for the floating license is obtained by running the "EchoID" program.

  Start > Programs > ADINA System n.n > Floating License > Run EchoID
  

The Lock Code 1 ID is the system ID that you need to send to ADINA R & D (email: password@adina.com) to obtain the license file.

Start Floating License Server

The floating license file must be named "lservrc" and be placed in the %ADINAHOME%\Sentinel directory. Typically, %ADINAHOME% is the directory "C:\Program Files\ADINA\ADINA System n.n".

To start the ADINA floating license server, run

  Start > Programs > ADINA System n.n > Floating License > License Server
  

Click the Add button [A] to start the license server. When successfully started, the following message is displayed.

If the license server if already running and you click Add, the following error message is displayed.

In Windows 7, when you click the Add or Remove button, you may get the following error:

In this case, click OK, close the previous window, and then, instead of running

  Start > Programs > ADINA System n.n > Floating License > License Server
  
by the usual left mouse click, right-click and choose 'Run as administrator'. This will allow you to Add and Remove normally.

Stop Floating License Server

If you need to stop the license server, click the Remove button [B]. When the license server is successfully stopped, the following message is displayed.

Restart Floating License Server

If you need to restart the license server, click on the Remove button and then the Add button.

License Checking Utility

You can use the "WlmAdmin.exe" utility program to check the status of the licenses on the license server. This program is in the %ADINAHOME%\Sentinel directory.

You can query a server [A] by specifying the server name or IP address via menu:

  Edit > Define Server List
  
If the license server has been started and has license features, the list of features will be shown below the server [B]. Clicking on a feature name displays the detailed information for the license feature [C].

Total users [D] indicates the maximum number sessions that can be run for a licensed program at any one time on all machines combined. However, for educational licenses, an unlimited number of sessions can be run at any one time, regardless of the number indicated here.

End date [E] indicates when the license expires.

If the specified license server has not been started, the following error message is displayed.

Common Problems

No license features listed in WlmAdmin for the license server
The most common reason is that the license file "lservrc" is not placed in the %ADINAHOME%\Sentinel directory or the license file name has an extension (e.g., .dat or .txt). You may not see the extension in Window Explorer because the extension may be hidden (by default).

One way you can verify the existence of "lservrc" in the %ADINAHOME%\Sentinel directory is to open a Command window and go to the directory [A] to list the file [B].

Firewall prevents access of license server from clients
The ADINA floating license is based on SentinelLM which uses TCP/UDP port 5093 to communicate. You need to allow this port through your firewall for the ADINA floating license to work.

SentinelLM server already running for other programs
SentinelLM allows only one server program to run on one machine. If there is already a SentinelLM server running for some other program(s), you need to combine the ADINA "lservrc" license file with the existing license file and restart the license server program.

If the current license server program is running SentinelLM 7.0 or later, ADINA programs will be able to get the license from the license server. If not, you need to stop the current license server program, put the combined license file to the %ADINAHOME%\Sentinel directory and start the ADINA license server program (see Start License Server above). The other programs should be able to obtain the licenses as usual. You can run WlmAdmin.exe to verify that all the license features are there.

Additional Information

Please refer to the README file in the %ADINAHOME%\Sentinel directory for more information.