Step 4: Configuring Your Environment

Before you can begin using TotalView, you must add TotalView to your PATH variable. On some systems, you may need to mount the /proc directory.

NOTE >> Install TotalView where it is visible from your Linux login nodes. Do not install TotalView on your compute nodes. TotalView communicates with these nodes using a library created Cray.

The Cray distribution is an rpm file, and so you need to run rpm to install it.

Before installing, if you know you want to install the package as the default version, first set the environment variable CRAY_INSTALL_DEFAULT as follows:

Note that you do not need to make this decision upfront. You can install TotalView first, and if you decide later to make this package the default you can execute the following:

/opt/cray/admin-pe/set_default_files/set_default_totalview_version

/opt/cray/admin-pe/set_default_files/set_default_totalview-support_version

To install TotalView on the Cray, you should run the rpm command as follows:

rpm -ivh cray-totalview-version-totalview-support-version.x86_64.rpm

In contrast to the standard TotalView installation, the Cray installation doesn’t ask where it should install TotalView as it knows where to install files.

The rpm application places the Cray bulk launching system and other support modules within the installation directory.

TotalView on Cray XT systems uses totalview-support product components to provide essential interface components that allow TotalView to execute in Cray environments. Included within totalview-support are the totalview-mem-debug module, a configuration file, and a set of bulk launcher executables.

The bulk launcher is a paired set of executables that use ALPS to scalably launch the TotalView Debugger Server (tvdsvr) executable on compute nodes.

If you are running your program on an XT3 Catamount system

• In many cases, you will need to use the -nodes_allowed server command-line option to tvdsvr_rs.

• Your environment must set the RS_DBG_CLIENTS_PER_SERVER variable.

A number of issues can arise with Apple Mac OS X installations that will need attention to successfully launch TotalView. Running the install script should not yield any errors. Please read Troubleshooting Mac OS X Installations in the Reference Guide for further details.