Install a New TotalView Developer for HPC or TotalView Student License
Before starting the license file installation, first verify that your license is a Reprise (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 "Reprise (RLM) TotalView Developer / Developer for HPC license detected" or "Reprise (RLM) TotalView Student license detected.”
If an RLM license is not reported, contact
license@perforce.com for the proper license.
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.
Installing the license file consists of simply copying the provided license to the directory where TotalView expects to find it. To use a custom directory, additional configuration is required.
The license you have received is typically named license.lic.
Install Option 1: Install the license file in the default location
Place the license file into the license directory of your TotalView installation.
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.
NOTE: When using a graphical installer, a toolworks directory may not be created; in this case, the license directory will be 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
To use a custom licensing directory:
1. Set the RLM_LICENSE environment variable to the file's full pathname. The following example shows the bash shell style syntax for setting RLM_LICENSE.
export RLM_LICENSE=<nonstandard-dir>/<licensefile>
If an RLM_LICENSE environment variable already exists, add the pathname for the license file to this variable's declaration. Notice that the RLM_LICENSE variable contains a colon-separated list of license file pathnames. For 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, you can test that the license file is working:
1. Launch TotalView:
<installdir>/toolworks/totalview.<version>/bin/totalview
2. Test a program, for example:
<installdir>/toolworks/totalview.<version>/<platform>/examples/wave
TotalView should come up with no licensing dialogs.
