Demo License Installation
Demo licenses use the new Reprise (RLM) style licensing and are delivered as text files that are typically named license_demo.lic or license.lic.
Before starting the license file installation, first verify that your license is a Reprise (RLM) demo 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 Evaluation license detected.”
Install Option 1: Install license file in the default location in your TotalView installation.
Before you can use TotalView, place the demo license file into the tv_license directory of your TotalView installation. This license file was attached to the email message confirming your download request. If your email system did not retain the name license_demo.lic, rename it after you save it to disk.
1. Become root user (optional).
If you installed TotalView as the root user, become the root user again. If you used sudo to install TotalView, use sudo in the following step.
2. Copy the license file.
Copy the license file to the tv_license directory.
Linux/Unix:
cp <licensefile> <installdir>/toolworks/tv_license
where <installdir> is the top-level directory where you performed the TotalView installation.
macOS:
cp <licensefile> /Applications/Perforce/tv_license
Install Option 2: Install license file in a custom location
If you do not want to install the license file in the <installdir>/toolworks/tv_license directory, set your 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}
Test that TotalView can use the license file
Linux/Unix:
<installdir>/toolworks/totalview.<version>/bin/totalview \
<installdir>/toolworks/totalview.<version>/<platform>/examples/wave
On macOS:
/Applications/Perforce/totalview.<version>/TotalView.app/Contents/bin/totalview \ /Applications/Perforce/totalview.<version>/TotalView.app/Contents \
/darwin-<x86|arm64>/examples/wave
NOTE: Easily start TotalView on macOS by double clicking the TotalView application icon under /Applications/Perforce/totalview.<version>.
TotalView should come up with no license error dialogs.
