Step 2: Running the Install Program - TotalView Documentation

(Optional) Go to the system upon which you will be installing TotalView and become the root user:

su root

Note In some circumstances (particularly on a Macintosh), 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.

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 this displayed information, the installation procedure is no longer interactive.

The Install program asks that you name an installation directory. If the directory you specify does not exist, the Install program creates it.

If you do not enter a name, the installation directory will either be/usr/toolworks or /opt/toolworks—this is system-dependent. 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: This is where Install places the license manager.

You are now asked to select which components you wish to install.

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

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 TotalView by pressing Enter.

If you became root using su, exit from root after Install concludes by typing:

exit

Test if TotalView was successfully installed by typing:

installdir/toolworks/totalview.version/bin/totalview

TotalView prints information that includes a version number and a message indicating that a license file is not installed.

If TotalView cannot initialize the license manager, it prints the following message:

Unable to initialize TotalView 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.)