NextGen TotalView for HPC Installation Guide : Chapter 1 Installing NextGen TotalView for HPC : Installing NextGen TotalView for HPC
Installing NextGen TotalView for HPC
Download the tar file version of the installation and use the tar command to extract NextGen TotalView for HPC. For example:
tar xvf totalview version_platform.tar
tar xvf totalview.version-doc.tar
Before you can run NextGen TotalView for HPC, you must obtain a license. You can obtain one by filling in the form located at http://www.roguewave.com/products-services/request-demo.
This section describes how you install a new version of NextGen TotalView for HPC. Before starting, you should read the Release Notes on the NextGen TotalView for HPC documentation web page. In addition, some operating systems may need to be patched. For more information, see the TotalView for HPC Platforms and System Requirements guide.
Here is the procedure for installing NextGen TotalView for HPC:
1. (Optional) Go to the system upon which you will be installing NextGen TotalView for HPC 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 NextGen TotalView for HPC as the root user prevents users from modifying the software. However, you should not run NextGen TotalView for HPC as root.
2. 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. The Install program asks you to accept the license terms for NextGen TotalView for HPC. You can respond Yes to accept, No to decline, or ? to view the license terms. You must accept the license terms to continue the installation.
4. 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 NextGen TotalView for HPC 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 NextGen TotalView for HPC.
flexlm-version: This is where Install places the license manager.
5. You are now asked to select which components you wish to install.
If you are installing NextGen TotalView for HPC for multiple platforms in a common NFS directory, you only need to install the common components once.
6. The Install program asks if it should create a symbolic link (named totalview) to this installation directory.
If you are not the root user, Install cannot create the link, so you should answer “n” (no). If Install cannot create the link, you can ignore its complaints and continue installing NextGen TotalView for HPC by pressing Enter.
7. If you became root using su, exit from root after Install concludes by typing:
exit
8. Test if NextGen TotalView for HPC was successfully installed by typing:
installdir/toolworks/totalview.version/bin/totalview
NextGen TotalView for HPC prints information that includes a version number and a message indicating that a license file is not installed.
If NextGen TotalView for HPC cannot initialize the license manager, it prints the following message:
Unable to initialize NextGen TotalView for HPC license
If you see this message, you need to confirm that you did install the license. You may need to set the -LM_LICENSE_FILE environment variable to the installation directory. (This variable is described in the next step.)
Configuring Your Environment
Before you can begin using NextGen TotalView for HPC, you must add NextGen TotalView for HPC to your PATH variable. On some systems, you may need to mount the /proc directory.