Bulk Launch Page

The Bulk Launch Page allows you to specify the parameters TotalView will use when it does a bulk launch of TotalView Debugger Servers on remote hosts.

TotalView lets you start MPI jobs in two ways. You can directly invoke TotalView upon your program, which is identical to entering arguments into the File > New Program dialog box, or by directly or indirectly involving a starter program such as poe or mpirun. TotalView uses this feature when it is directly invoked on a starter program. This is discussed in the TotalView Users Guide.

 

Figure 13: Bulk Launch Page

Information on bulk launching is contained within Chapter 4 of the TotalView Users Guide.

Enable debug server bulk launch

When this box is checked, TotalView will start multiple server processes using a bulk launch command.

For more information, see the TV::bulk_launch_enabled variable.

When you enable bulk server launch, you probably do not want to disable single server launch. TotalView uses the single server launch string when you start TotalView upon a file when you have named a host within the File > New Program dialog box or have used the –remote command line option. You only want to disable single server launch when it can’t work.

Command

The command TotalView uses when it attempts to start the (remote) servers. This information is stored within the TV::bulk_launch_string variable. Items that you can use in the bulk launch command string are:

%C

Expands to the default name of the command used to start a remote process. If defined, the value of the environment variable TVDSVRLAUNCHCMD is used. Otherwise, the default name is rsh (remsh on HP-UX).

%D

Expands to the full path of the directory to which TotalView is connected. The default command string tells tvdsvr to first try to cd to this directory. This directory name may be inappropriate if the target system’s file system is not organized the same way as the host’s file system.

%F

Contains the “tracer configuration flags” that need to be sent to tvdsvr processes. These are system-specific startup options that tvdsvr processes need.

%N

Expands to the number of servers that will be launched.

%H

Expands to the hostname on which TotalView is running.

%L

Expands to a comma-separated list of remote host:port for all remote hosts.

%R

Expands to a comma-separated list containing the entire remote host list.

%S

Expands to the comma-separated list containing the entire port list.

%P

Expands to the comma-separated list containing the entire password list.

%V

Expands to the TotalView verbosity setting. Setting this value allows the TotalView Server (tvdsvr) to be launched with the same verbosity level as TotalView.

%t1

Expands to the file name of temporary file number 1 (see Temporary Files later in this section).

%t2

Expands to the file name of temporary file number 2 (see Temporary Files later in this section).

Temp File Prototypes

Discussed later in this section.

This information is stored in variables beginning with TV::bulk_launch_tmp.

Connection timeout (in seconds)

Time to wait before giving up trying to establish the connections. The total timeout is calculated as a Base value, Plus an amount for each server launched.

For more information, see the TV::bulk_launch_incr_timeout variable.

Temporary Files

The bulk server launch facility allows you to create temporary files whose names are passed in the bulk server launch command. Each of these file has a Header line, followed by one line for each remote Host, followed by a Trailer line. Each tab within this page defines one set of these three files. The substitutions available in the header and trailer lines are those available in the bulk launch command just described.

Items that you can use in the host lines of a temporary file are:

%C

Expands to the default name of the command used to start a remote process. If defined, the value of the environment variable TVDSVRLAUNCHCMD is used. Otherwise, the default name is rsh (remsh on HP-UX).

%R

Expands to the hostname of the remote machine as specified in the File > New Program command.

–working_directory %D

Expands to the full path of the current working directory on which TotalView is running. The default command string tells tvdsvr to first try to cd to this directory. This directory name may be inappropriate if the target system’s file system is not organized the same way as the host’s file system.

–callback

Tells the server to call back to TotalView. This must be followed by the hostname and TCP/IP port number to call back to.

%L

Expands to the hostname and TCP/IP port number on which TotalView is listening for connections from tvdsvr.

%H

Expands to the hostname on which TotalView is running.

%S

Expands to the TCP/IP port number on which TotalView is listening for connections from tvdsvr.

–set_pw

Sets a 64-bit password for security. TotalView must supply this password when tvdsvr establishes the connection with it.

%P

Expands to the password that TotalView automatically ­generated.

–verbosity %V

Expands to the TotalView verbosity setting. This allows the TotalView Server to be launched with the same verbosity level as TotalView.

For more information, see “TotalView Command Syntax” in the TotalView Reference Guide.

For information on other Preference pages, see:

“Options Page”

“Action Points Page”

“Launch Strings Page”

“Dynamic Libraries Page”

“Parallel Page”

“Fonts Page”

“Formatting Page”

“Pointer Dive Page”