Installing TotalView

If you have already installed TotalView, skip this chapter, and move on to licensing:

For TotalView Developer for HPC or TotalView Student, see TotalView Developer for HPC and TotalView Student Licensing.

For TotalView for HPC, see TotalView for HPC Licensing.

Most TotalView installers are provided as tar bundles, although installing on the macOS requires a graphical installer, and graphical installers are also available for Linux x86 64-bit and Linux ARM64.

For more information about supported platforms, see Supported Platforms.

Using a Graphical Installer

All installations on a macOS platform are via a graphical installer, and graphical installers are also available on Linux x86 64-bit and Linux ARM64.

1.  Download the installer from https://www.perforce.com/products/totalview/downloads.

Use the dropdown controls near the top of the page to select the TotalView Developer for HPC or TotalView Student installer for your platform, along with a documentation tar bundle and an SHA256 checksum file. Online links to the change log and release notes for the current version are also available.

For Linux, the installer is a .run file to be invoked from the command line in a terminal window.

For macOS, the installer is a .dmg file.

2.  Run the installer and follow the installation steps.

Using a Tarball

This discussion describes how to install a new version of TotalView from a tarball.

Unpack the Tarball

Download the tar file version of the installation and use the tar command to extract TotalView. For example:

tar xvf totalview_<version_platform>.tar

tar xvf totalview_<version>-doc.tar

Install TotalView

1.  (Optional) Become the root user
Go to the system on which you are installing TotalView and become the root user:

su root

In some circumstances, you’ll want to use the sudo command instead of su. If you use the sudo command, you’ll be typing sudo ./Install instead of ./Install in step 2.

Installing TotalView as the root user prevents users from modifying the software. However, you should not run TotalView as root.

2.  Start the Install program
Go to the directory containing the files extracted from the downloaded tar file, then start the Install program by entering:

./Install

This runs the installer script in interactive mode in which you are prompted with options or to provide information. For detail on using this command, type ./Install -help. If you use any of the options described by the help, the installation procedure is no longer interactive.

3.  Accept the license terms
To view the license terms, select ?. You must accept the license terms to continue the installation.

4.  Choose an installation directory
The Install program asks that you name an installation directory. The directory must already exist; if not, the program requests a new location.

If you do not enter a name, the installation directory defaults to either /usr/ or /opt/, depending on the system.

This manual refers to the installation directory’s pathname as <installdir>.

5.  Choose the components to install

If you are installing TotalView for multiple platforms in a common NFS directory, install the common components only once.

6.  Create a symbolic link (optional)
You can create a symbolic link (named totalview) to this installation directory. If you are not the root user, Install may be unable to create the link, so you should respond “n” (no) to the prompt. If Install cannot create the link, you can ignore its complaints and continue installing TotalView by pressing Enter.

At this point, the Install program has created a toolworks directory with these subdirectories:

tv_license

memoryscape.<version> (optional)

totalview.<version>. This is where Install places TotalView.

7.  Exit from root (optional)
If you became root using su, exit from root after Install concludes by typing:

exit

8.  Test the installation
Test if TotalView was successfully installed by entering:

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

TotalView prints information that includes a version number to the console, and the user interface launches.

If you try to debug a target program and TotalView cannot find a valid license file or cannot contact the license server, it displays an "RLM license error: No license for product (-1)" message. If this occurs, confirm that you installed the license.

For Linux x86-64 and Linux PowerLE: TotalView’s user interface requires libxkbcommon and libXcomposite to be installed; these are typically included as part of a desktop graphical environment.

Next Steps

After installation, license your product:

For TotalView Developer for HPC or TotalView Student, see TotalView Developer for HPC and TotalView Student Licensing.

For TotalView for HPC, see TotalView for HPC Licensing.