Installing the RLM License Server
1. Install the RLM Software
The RLM license server tar bundle reprise-<version>.tar is available for download on the TotalView website at https://totalview.io/success/downloads.
NOTE: For served license renewal, skip this section and see Updating or Renewing a License.
1. Unpack your TotalView RLM distribution on the license server system
To install the RLM license server software, unpack the RLM tar bundle onto the machine that will host the license server, then run the Install script from the resulting directory:
tar xvf reprise-<version>.tar -C ~
cd ~/reprise-<version>
2. Run the Install script using sudo (optional but recommended)
sudo ./Install
This runs Install in interactive mode in which you are prompted with options or to provide information.
Choose an installation directory, e.g., /opt.At the prompt, select the components to install. Choose to install the license common files and the relevant license platform files for your license server. (The tar ball includes license server software for multiple platforms.)
Once the Install script completes, you should have a reprise-<version> directory under <installdir>/toolworks.
2. Generate a Host ID for the RLM License Server
To obtain host information, run the toolworks_hostid script, as follows:
<installdir>/toolworks/reprise-<version>/bin/toolworks_hostid
NOTE: Do not use the UNIX hostid command, as it may not return the proper host ID for RLM.
This script writes the host name and one or more RLM host ID values to standard output, for example:
The host name for this machine is: fast-server
The host ID for this machine is: 08122b2cf32d
Be aware that a host ID is returned for just RLM when invoking toolworks_hostid from the reprise-<version> directory. Running toolworks_hostid under the <installdir>/toolworks/totalview.<version> directory might also return a FlexNet Publisher and/or FlexNet Embedded host ID. If so, you can ignore those.
If toolworks_hostid returns multiple RLM host IDs, select a persistent host ID, i.e., one for a device that is always part of the system when the license server software is running. The license server host ID is derived from the physical MAC address of a network interface card, and the host ID chosen must be a persistent address.
Send the host ID to the TotalView license team, license@perforce.com, who will then send you a permanent/subscription license.
3. Verify Your RLM License and Product
After receiving your license, you can verify your license and product by running the utility toolworks_licensetype and provide as input the license file:
<installdir>/toolworks/totalview.<version>/bin/toolworks_licensetype <licensefile>
The script returns the license type, the product, and whether a license server is required. For example:
Reprise (RLM) TotalView for HPC license(s) detected
These licenses are counted. A license server is required.
For license setup help refer to TotalView for HPC > Reprise (RLM)
in the TotalView Installation and Licensing Guide.
4. Configure the RLM License Server
1. Create a file named license.src in your <installdir>/toolworks/reprise‑<version> directory
Change to the reprise-<version> directory on the license servercd <installdir>/toolworks/reprise-<version>
Copy and paste the new license keys — this is the information that you received through email — into a file named license.src in the <installdir>/toolworks/reprise‑<version> directory.The text in your license.src file is derived from your host information, number of license keys, and license configurations.
2. Create a dedicated unprivileged user account
NOTE: Skip this step if you already created the user as a prerequisite to installing and running the license server as discussed in RLM License Server Prerequisites.
While not required, it’s recommended to have a dedicated, unprivileged user account to run the license server. Note that the login shell should be /bin/sh.
3. Run the <installdir>/toolworks/reprise‑<version>/bin/Configure_License script on the license server, to create the following files:
<installdir>/toolworks/reprise‑<version>/license.lic <installdir>/toolworks/reprise‑<version>/license.optNOTE: If you already have a license.opt file, the script prompts whether you want to overwrite it. Answer “n” to preserve your existing file. If you answer “y”, a new file is created, but your existing file is saved as license.opt.old.
<installdir>/toolworks/reprise‑<version>/license.client <installdir>/toolworks/reprise‑<version>/bin/toolworks_init 5. Point TotalView Client Installations to the RLM License Server
Each client machine that will run TotalView needs access to a license. If you are running TotalView and the license server in the installation directory on the same machine, you can skip this step.
If TotalView and the license server are not running on the same machine, you will need to place a license.lic file on each additional installation. Copy the <installdir>/toolworks/reprise-<version>/license.client file from the license server into the <installdir>/toolworks/license directory on each client machine and rename that file license.lic.
As an alternative, you can specify the full path to the license.lic file in your RLM_LICENSE environment variable, using the format <port>@<host>.
For example (bash):
RLM_LICENSE=7147@licserver
export RLM_LICENSE
