Installing the RLM License Server

TotalView : TotalView Installation and Licensing Guide : TotalView for HPC Licensing : Install a TotalView for HPC License Server : Installing a Reprise (RLM) License Server : 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. Verify Your RLM License and Product

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 file named license.src in your <installdir>/toolworks/repriselm‑<version> directory

Change to the repriselm-<version> directory on the license server

cd <installdir>/toolworks/repriselm-<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/repriselm‑<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/repriselm‑<version>/bin/Configure_License script on the license server, to create the following files:

<installdir>/toolworks/repriselm‑<version>/license.lic

<installdir>/toolworks/repriselm‑<version>/license.opt

NOTE: 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.

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