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 rlmhostid 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 ./rlmhostid ether
Please send the RLM Host ID 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
No license features listed in the RLM Web Server
RLM server already running for other programs
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. Note that TCP 49117 is also set in the 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 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
Firewall prevents access of license server from clients
SentinelLM server already running for other programs
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.