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.”
On this page:
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.
-
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.
-
Copy the license file.
Copy the license file to the
tv_licensedirectory.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
/Applications/Perforce/totalview.<version>.TotalView should come up with no license error dialogs.