Question QI-005 (continued)
Please note that the following instructions are for installation of a floating license on Unix/Linux 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
The ADINA floating license uses the Reprise License Manager (RLM). The system ID (also called RLM Host ID) for the floating license is obtained by running the adrlmid program located in the <ADINAHOME>/rlm directory of the license server machine, where <ADINAHOME> is the directory where you installed the ADINA System.
cd <ADINAHOME>/rlm ./adrlmid
Please send the RLM Host ID and the Host Name reported above to firstname.lastname@example.org to obtain the license file. This information is also found in the text file 'rlmhostid.txt' 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.
To start the ADINA floating license server, run the RLM server program, rlm.
cd <ADINAHOME>/rlm ./rlm -dlog rlm.log &where rlm.log is the debug log file.
Once the license server is started, you can check its status by running the rlmstat command.
./rlmstat -aYou can also check the status and perform administration of the RLM license server through the RLM Web Server described in the next section.
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 <ADINAHOME>/rlm directory.
The "rlm.pw" file has one line for each user, formatted as follows:
username:password:list-of-permissionsAs 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::statusYou 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::statuswhere "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.
./rlmdown adina ./rlmdown RLM
A client computer is unable to locate a license to run ADINA
There may be 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 Ports 5053 and 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 exisiting RLM server. 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 is may be necessary to avoid conflicts in TCP Ports by assigning different ports to ADINA. TCP 5053 is 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 5053 and 49117 may be changed in the corresponding HOST and ISV lines of the .lic ADINA license file using a text editor.
- 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 command, found in the <ADINAHOME>/slm directory (<ADINAHOME> denotes the directory where ADINA is installed).
cd <ADINAHOME>/slm ./echoid
The program will echo the 'Lock Code 1' of your installation. The Lock Code 1 ID is the system ID that you need to send to ADINA R & D (email: email@example.com) to obtain the license file.
For University users: please also provide the IP subnets where ADINA will be used, e.g., 152.12.*.*. You may specify up to 6 subnets.
Starting the Floating License Manager
The floating license file must be named "lservrc" and placed in the <ADINAHOME>/slm directory.
To start the ADINA floating license server, run the lserv program.
This completes the ADINA floating license installation.
Checking License Availability
To check the availability of floating licenses available on your server, run the lsmon command by typing lsmon followed by the license server machine name. E.g., if your license server machine host name is "galileo", the command will be
Stopping the Floating License Manager
If you need to stop the floating license manager, run the lsrvdown command, followed by the license server machine name, e.g.,
Restarting the Floating License Manager
If you need to restart the floating license manager, first, run the lsrvdown command to stop the floating license manager, e.g.,
./lsrvdown galileoThen, run the lserv command to start the floating license manager.
No license features listed in lsmon output
The most common reason is that the license file "lservrc" is not placed in the <ADINAHOME>/slm directory, or the license file name has an extension (e.g., .dat or .txt). Another possibility is that the filename is not in lower case.
Firewall prevents access of license server from clients
The ADINA floating license is based on SentinelLM which uses 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 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>/slm directory and start the ADINA license server program. The other programs should be able to obtain the licenses as usual. You can run lsmon to verify that all the license features are there.
Please refer to the README file in the <ADINAHOME>/slm directory for more information.