Install a new TotalView Developer for HPC or TotalView Student license

Use this procedure to install a new Reprise License Manager (RLM) license file for TotalView Developer for HPC or TotalView Student.

Installing or updating the license file typically consists of copying the license file you received to the directory where TotalView expects to find it. If you want to store the license file outside the TotalView installation, you must configure a custom license location.

Before you install the license file, verify that the license file is an RLM license. Using the wrong license type can prevent TotalView from starting.

Prerequisites

  • You have received a new RLM license file by email from Perforce (typically license.lic).

  • You have access to the system where TotalView is installed.

  • You have permission to copy the license file to the installation or custom license directory.

  • You know whether TotalView was installed as root or using sudo.

If you installed TotalView as the root user, become the root user again to install the license file. If you used sudo to install TotalView, use sudo here.

Verify the license is an RLM license

Before starting the license file installation, verify that the existing license is an RLM license file by running the toolworks_licensetype utility:

  • Linux/Unix

    <installdir>/toolworks/totalview.<version>/bin/toolworks_licensetype <licensefile>

  • macOS:

    /Applications/Perforce/totalview.<version>/TotalView.app/Contents/bin/toolworks_licensetype <licensefile>

The utility should report the following: 

Reprise (RLM) TotalView <product> license detected

If an RLM license is not reported, contact license@perforce.com for the proper license.

Install option 1: Install the license file in the default location

Place the license file into the license directory of your TotalView installation. If you are updating your license, simply overwrite the old license file in the directory.

  • Linux/Unix

    cp <licensefile> <installdir>/toolworks/tv_license

  • macOS

    cp <licensefile> /Applications/Perforce/tv_license

    where <installdir> is the top-level directory where you performed the TotalView installation.

When you install TotalView using a graphical installer, a toolworks directory might not be created. In that case, the tv_license license directory is directly under the installation directory. For example, on macOS, the license directory will be /Applications/Perforce/tv_license.

Install option 2: Install the license file in a custom location

Use this procedure when you store license files outside the TotalView installation directory (for example, in a shared or centrally managed directory). In this case, you must set the RLM_LICENSE environment variable to the license file path so TotalView can locate it.

To use a custom licensing directory:

  1. Set the RLM_LICENSE environment variable to the license file's full path.

    Example (Bash shell syntax):

    export RLM_LICENSE=<nonstandard-dir>/<licensefile>

    If RLM_LICENSE is already set, append the new path using a colon-separated list: (The RLM_LICENSE variable contains a colon-separated list of license file pathnames.)

    Example:

    export RLM_LICENSE=<nonstandard-dir>/<licensefile>:${RLM_LICENSE}

  2. Copy the license file into the custom directory.

    cp <licensefile> <path-to-custom-dir>

Test the license file

After installing the license file, test that TotalView starts without licensing dialogs. This confirms that TotalView can locate and read the license file.

To test the license file: 

  1. Launch TotalView:

    <installdir>/toolworks/totalview.<version>/bin/totalview

  2. Test a program, for example:

    <installdir>/toolworks/totalview.<version>/<platform>/examples/wave

TotalView should start with no licensing dialogs.