Configuring a Remote Connection
Configure remote connections on the Remote Connections preferences page, launched when you select the Configure icon on the Start Page.
Figure 124, Remote Connection Preferences page
Existing configurations display in the “Select a configuration to edit” dropdown.To create a new connection, select create a new configuration. Enter the required information:
*Connection Name
A descriptive name for this connection.
*Remote Host(s)
The user and remote host to connect to, either a network path or an IP address. If your network has a gateway machine, use a comma-delineated string to include intermediate hosts. For example:
user@myServer.myNetwork.com, user@anotherServer.myNetwork.com
You can enter multiple hosts, but only the first two support entering a password; you’ll need to access a third or subsequent host without a password.
NOTE: If you’re using some customized settings, including an alias for your host name or a non-standard port for your SSH daemon, add this information to your local SSH configuration file.
*Private Key File
Provide an optional Private Key File used as part of the SSH connection to connect to your remote system.
*TotalView Remote Installation Directory
The directory on the remote host where TotalView is installed. Identify the installation’s top-level directory, for example, /opt/totalview.2024.
*Remote Command(s)
Optional shell commands to execute before TotalView is run on the remote server. Shell commands must follow the syntax of your SSH login shell. Some examples:
*Add TotalView to your path. This avoids having to specify the TotalView remote installation directory:
csh: setenv PATH /opt/toolworks/totalview.2024.1/bin:$PATH
bash: export PATH=/opt/toolworks/totalview.2024.1/bin:$PATH
*Load the TotalView module and openmpi module if they are configured for your system. This also avoids having to specify the TotalView remote installation directory:
csh or bash: module load totalview ; module load openmpi
*Source a script to set your environment:
csh or bash: source /path/to/my/script
*Remote TotalView Arguments
Enter program arguments. For instance, you might enter TotalView arguments, the program to debug, and arguments to your target program. For example:
 
/bin/hello -no_user_threads -a "Say Hi"
Where -no_user_threads is an argument for TotalView, and "Say Hi" is an argument for the target program hello.
Once configured, click OK. You are returned to the Start Page where your figured connections will now be available in the Remote Connections dropdown:
To Modify or Delete a Connection
To edit a configuration, select it in the “Select a configuration to edit” dropdown box, make your changes, then select OK.
To delete a configuration, select Delete Configuration.