Starting the TotalView Server Manually

Totalview® for HPC User Guide : PART IV Advanced Tools and Customization : Chapter 18 Setting Up Remote Debugging Sessions : Starting the TotalView Server Manually

In some cases, TotalView is unable to automatically launch the TotalView Server on the remote host, and you will need to manually start the server.

NOTE >> You cannot debug remote processes using TotalView Individual.

If TotalView can’t automatically launch tvdsvr, start it manually:

• Disable both bulk launch and single server launch, set in the File > Preferences dialog box

• Enter a host name and port number into the relevant Sessions Manager window (see "Automatically Launching a Process on a Remote Server" for where this is located on the various dialogs). This disables autolaunching for the current connection.

If you disable autolaunching, you must start tvdsvr before you load a remote executable or attach to a remote process.

For information on all the ways to start TotalView, see "Starting TotalView".

NOTE >> Some parallel programs — MPI programs, for example — make use of a starter program such as poe or mpirun to create all the parallel jobs on your nodes. TotalView lets you start these programs in two ways. One requires that the starter program be under TotalView control, and the other does not. In the first case, enter the name of the starter program on the command line. In the other, enter program information into the File > Debug New Parallel Program or Process > Startup Parameter dialog boxes. Programs started using these dialog boxes do not use the information you set for single-process and bulk server launching.

Here are the steps in detail to manually start tvdsvr:

1. Disable both bulk launch and single server launch, set in the File > Preferences dialog box from either the Root Window or the Process Window.

NOTE >> Bulk and single server launch options are discussed in detail in "Server Launch Options".

— To disable bulk launch, select the Bulk Launch Tab and clear the Enable debug server bulk launch check box.

CLI: dset TV::bulk_launch_enabled

— To disable single server bulk launch, select the Launch Strings Tab and clear the Enable single debug server launch check box.

CLI: dset TV::server_launch_enabled

2. Log in to the remote computer and start tvdsvr:

tvdsvr -server

If you don’t (or can’t) use the default port number (4142), use the -port or -search_port options. For details, see “TotalView Debugger Server (tvdsvr) Command Syntax” in the TotalView for HPC Reference Guide.

After printing the port number and the assigned password, the server begins listening for connections. Be sure to note the password, which must be entered in Step 3.

NOTE >> Using the -server option is not secure, as other users could connect to your tvdsvr process and use your UNIX UID. Consequently, this command-line option must be explicitly enabled. (Your system administrator usually does this.) For details, see -server in the “TotalView Command Syntax” chapter of the TotalView for HPC Reference Guide.

3. From the Root Window, select the File > Debug New Program command (or any other type of debugging session). Enter the program’s name in the File Name field and the hostname:portnumber in the Debug On Host > Add Host dialog, and then select OK.

CLI: dload executable -r hostname

TotalView tries to connect to tvdsvr.

4. Enter the password at the prompt.

Figure 238 summarizes the steps for starting tvdsvr manually.

Figure 238 – Manual Launching of Debugger Server