Installing TotalView
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
Before you can debug a program with TotalView, you must obtain a license. You can obtain one by filling in the form located at https://totalview.io/free-trial.
This section describes how you install a new version of TotalView. Before starting, you should read the Release Notes on the TotalView documentation web page. In addition, some operating systems may need to be patched. For more information, see the TotalView Platforms and System Requirements guide.
Here is the procedure for installing TotalView:
1. (Optional) Become the root user
Go to the system on which you are installing TotalView and 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 and then start the Install program by typing:
Go to the directory containing the files extracted from the downloaded tar file and then start the Install program by typing:
./Install
For information on using this command, type ./Install -help. If you use any of the options described in the displayed information, 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.
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. If the directory you specify does not exist, the program requests a new location, effectively meaning the directory you specify must already exist.
The Install program asks that you name an installation directory. If the directory you specify does not exist, the program requests a new location, effectively meaning the directory you specify must already exist.
If you do not enter a name, the installation directory will either be /usr/toolworks or /opt/toolworks, depending on the system. Type a period “.” to place TotalView in your current directory.
This manual refers to the installation directory’s pathname as <installdir>.
The Install program then creates a toolworks directory and places two subdirectories within it:
totalview.<version>. This is where Install places TotalView.flexlm-<version> or
flexnetls-<version>
This is where Install places the licensing software.
5. Choose the components to install
If you are installing TotalView for multiple platforms in a common NFS directory, you need to 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.
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.
7. Exit from root (optional)
If you became root using su, exit from root after Install concludes by typing:
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 typing:
Test if TotalView was successfully installed by typing:
<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 manager, it displays a "No license file found" message. If this occurs, confirm that you installed the license.
You may need to set the LM_LICENSE_FILE (for a FlexNet Publisher style license) or TV_LICENSE_FILE (for a FlexNet Embedded style license) environment variable. (These variables are described in the next step.)
