Install TotalView for HPC
NOTE: If you already have installed TotalView, skip this section and move to Install a TotalView for HPC License Server.
This discussion describes how to install a new version of TotalView. Before starting, read the Release Notes on the TotalView documentation web page. For more information, see the TotalView Platforms Guide guide in the product distribution or on the web at TotalView Platforms Guide.
This discussion describes how to install a new version of TotalView. Before starting, read the Release Notes on the TotalView documentation web page. For more information, see the TotalView Platforms Guide guide in the product distribution or on the web at TotalView Platforms Guide.
You may be installing TotalView on the machine that will host the license server, or on a client machine that will point to the license server. The installation procedure is the same, but the licensing procedure will differ:
For a client machine pointing to the license server for its licensing information, a license server pointer file can be installed in the FNP_license or FNE_license directory created by the TotalView installer, or an environment variable can be set to point to the license, either LM_LICENSE_FILE for an FNP style license, or TV_LICENSE_FILE for FNE. For the machine hosting the license server, the license server will be installed and configured in an additional directory created by the license server software installation, not by the TotalView installation.Unpack the Tar Ball
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:
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:
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.
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.
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 will either be /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, 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.
At this point, the Install program has created a toolworks directory with these subdirectories:
totalview.<version>. This is where Install places TotalView.FNE_License(Created for all platforms by the installer but not used for an FNP-style license). This directory is created unless it already exists from a previous installation. It is the default location for an FNE buffer-style license file or a tv_license_file pointer file that is found and automatically used by TotalView (in the absence of an explicit TV_LICENSE_FILE environment variable setting).
FNP_License(Created for all platforms by the installer but not used for an FNE-style license). TotalView automatically searches this directory (along with a flexlm-<version> directory if it already exists) for an FNP license file.
NOTE: For TotalView for HPC, these FNE_license and FNP_license directories are generated to contain licenses for client machines only, i.e., those machines that will point to the license server for their license information. If you are installing TotalView on the machine that will host the license server, these directories will remain empty; instead, the license server software will create an additional, different directory for the license server itself.
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 entering:
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.
Install the License
For a machine that will host the license server, the next step is to Install a TotalView for HPC License Server.
If you have completed a TotalView install on a client machine, whomever administrates the license server will need to provide you with a license:
