Installing the RLM License Server
1. Install the RLM Software
NOTE: For served license renewal, skip this section and see Updating or Renewing a License.
1. Download the RLM license server tar bundle
The tar bundle repriselm-<version>.tar is available for download from the TotalView website at https://totalview.io/success/downloads.
2. 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 repriselm-<version>.tar -C ~
cd ~/repriselm-<version>
3. 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.)
After the Install script completes, you should have a repriselm-<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/repriselm-<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 Reprise host ID for this machine is: 08122b2cf32d
Be aware that a host ID is returned for just RLM when invoking toolworks_hostid from the repriselm-<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, 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. Create/Copy and Verify Your RLM License and Product
Your license will arrive via email either as an attachment or pasted into the body of the message.
If attached, the file will be called license.src. You may also receive a license_replay.src for Replay Engine. If pasted into your email, create file(s) of the same name by copying and pasting the license text into new text files. Otherwise, just copy the file(s) to the license directory, as follows:
1. Create/copy the license file(s) to the license directory
Change to the repriselm-<version> directory on the license server.cd <installdir>/toolworks/repriselm-<version>
Either:Create the file(s): Copy and paste the new license keys that you received through email into file(s) named license.src and optionally license_replay.src in the <installdir>/toolworks/repriselm‑<version> directory.
or
Copy the file(s): into the <installdir>/toolworks/repriselm‑<version> directory.
The text in your license.src and optional license_replay.src is derived from your host information, number of license keys, and license configurations.
2. Verify the license
After receiving your license, you can verify your license and product by running the utility toolworks_licensetype, providing 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 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.
2. Run the <installdir>/toolworks/repriselm‑<version>/bin/Configure_License script on the license server to create the following files using the license.src and optional license_replay.src files:
<installdir>/toolworks/repriselm‑<version>/license.lic <installdir>/toolworks/repriselm‑<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/repriselm‑<version>/license.client <installdir>/toolworks/repriselm‑<version>/bin/toolworks_init 5. Point TotalView Client Installations to the RLM License Server
NOTE: Perform this final step after completing the steps in Set Up a New Reprise (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 need to ensure that TotalView can find the license, using one of two ways:
Place a license.lic file in a directory of each additional TotalView installation. Copy the <installdir>/toolworks/repriselm-<version>/license.client file from the license server into the <installdir>/toolworks/tv_license directory on each client machine and rename that file license.lic.or
Set the environment variable RLM_LICENSE with the license server’s port@host specification.For example (bash):
RLM_LICENSE=7147@licserver.mycompany.com
export RLM_LICENSE
