Manage the RLM Server

The following procedure should be used for a basic set up of RLM licensing. Altair Accelerator software currently uses Reprise version 12.2BL2.

1. Save the license received via email from PBS Works Support in the file rtda.lic.
2. Edit the file to remove or comment out any email headers inserted during transit. Change the HOST name to match that of the license server, and change the ISV line to reflect the correct path to the rtdaddaemon as the software is installed on your system.

   As shipped, the ISV line is ./rtdad, which corresponds to putting the RLM binaries and license file in the same directory. If needed, the port number may be changed as well.

   The Reprise license file should resemble the following:

   # This is an example of a Reprise License for VOV
   #
   # Please do the following:
   #   1.  Install the file in the Altair Accelerator RLM license server directory.
   #   2.  Modify the ISV line by replacing @VOVDIR@ with the actual path to rtdad
   #   3.  Optionally, change the port number on the HOST line
   #   4.  Start with: rlm -nows -c /<output_path>/<license_file_directory>/rlm.log
   
   HOST bison 0002b3643927 7070
   ISV rtdad ./rtdad
   LICENSE rtdad host_licmon 2016.09 31-dec-2019 200 sig="60PG4580K811VWQ3U4G
   YXG6C13H3R2CNFRKJ8PSW08A6XGX4FRSR19BXUQ65QEBHGR14NBYV045G"
   LICENSE rtdad licmon 2020.1 31-dec-2019 1 sig="60Q04580J6R1C53G36DR65CAJ5
   P71DQAKTVX4HV308AG15V4YV5UU9YTQN5DE506RHU5297RN07KX"
   LICENSE rtdad server_nc 2020.1 31-dec-2019 31 sig="60PG453MDXWPAQ6J5QCTGBMBU
   ERCNTQ9WAAS5TG22M08K6BAVC774EC2MVWWNAW8HYFRFCSCRXEG"
   LICENSE rtdad workloadsim 2020.1 31-dec-2019 1000 sig="60P0453YVB4M1VH2FU
   W54PA4NSJ3F7D0S9MS5A022HXADQWJ04J503Q62VUSYBAE1525DG779C"

3. Create a dedicated directory that contains the RLM binaries, the RLM license file, and all other RLM-related files (including the log file). The dedicated RLM directory should be placed in local storage on the license server machine, so that the machine can serve licenses without being dependent on network storage availability.
   The items that should be copied to this directory are:

   • The RLM license file, obtained from PBS Works Support
   • $VOVDIR/bin/rlm - the RLM executable
   • $VOVDIR/bin/rlmutil - the RLM utility executable (provides rlmstat, rlmreread, etc.)
   • $VOVDIR/bin/rtdad - the Altair Accelerator vendor daemon.
4. Create symbolic links to (or copy, in the case of a Windows installation) rlmutil to provide easier access to the RLM commands:
   • rlmstat
   • rlmreread
   • rlmremove
   • rlmhostid
   • rlmver
   • rlmdown

   Copies of rlmutil may also be made, named as each utility, which will also make the various utilities available, but this uses more disk space. This is the only option on Windows, which does not support symbolic links.

5. Start the license server by running the rlm command:

   > source /<install_path>/<version>/<platform>/common/etc/vovrc.csh
   % rlm -nows >& rtda.log &

   or if the license does not end in .lic:

   > source /<install_path>/<version>/<platform>/common/etc/vovrc.csh
   % rlm -nows -c /<output_path>/<license_file_directory>/rtda.log

   Options:

   • -dlog /<output_path>/<license_file_directory>/ - enable debug log.
   • -nows - disable the RLM web server interface.

   It is recommended that you include the -nows option when starting RLM, which disables its internal web server. In this version, there is no security and any user who discovers the RLM web interface can shut down the RLM license server.
6. To automatically start the RLM license server upon boot on UNIX systems, use the available example .bat files as a guide to create a script, and place it in the appropriate directory. Example startup files are provided in $VOVDIR/etc/boot. Choose the one that best fits your scenario.