OS-Specific Installation Info

HPE Cray Installations

InstallvTotalView 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 by Cray.

Installing on HPE Cray

The HPE 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:

export CRAY_INSTALL_DEFAULT=1

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 HPE Cray systems, run the rpm command as follows:

Linux x86_64

rpm -ivh totalview-<version>.x86_64.rpm

Linux ARM64

rpm -ivh totalview-<version>.aarch64.rpm

Then Install the license.

About the Install

In contrast to the standard TotalView installation, the Cray installation doesn’t prompt for a location in which to 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 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.

macOS Installations

The macOS installer is a DMG graphical installer.

Prerequisites

Installing TotalView on the macOS comes with some prerequisites.

  1. Make sure every user who might need to debug is in the _developer group.

  2. Optional: Enable developer mode:

    Enter: DevToolsSecurity -enable.

  3. Optional: Remove the authorization prompt:

    Enter: sudo security authorizationdb write system.privilege.taskport allow.

  4. Classic UI only

    The TotalView classic UI requires that XQuartz be installed on the machine where TotalView is running. Note that the classic UI is supported only on Apple x86-based systems.

The installer should not result in any errors. If errors occur, see Troubleshooting macOS Installations for information.

Running Multiple Displays

If you are running TotalView on multiple displays, you may wish to uncheck Displays have separate Spaces under the Mission Control preference. This avoids potential display problems in which the TotalView UI could appear partially out of the display.

Installing on macOS

  1. Download the macOS DMG graphical installer from TotalView’s download page, choosing “Apple macOS - Intel” or "Apple macOS - ARM64” from the Platform dropdown, and then either TotalView or TotalView Student.

  2. Select the Download button to download the installer.

  3. Double click the .dmg file and follow the installer prompts. Choose a location for the install or accept the default, which is Applications/Perforce/totalview.<version>.

For detail on installing a non-student TotalView license, see either TotalView for HPC Licensing or TotalView Developer for HPC and TotalView Student Licensing.