Totalview® for HPC User Guide : PART IV Advanced Tools and Customization : Chapter 18 Setting Up Remote Debugging Sessions : TotalView Server Launch Options and Commands : Customizing Server Launch Commands : Setting the Bulk Server Launch Command
Setting the Bulk Server Launch Command
The commands for bulk server launch settings vary according to platform.
SGI XE and SGI ICE
The bulk server launch string is as follows:
array tvdsvr -working_directory %D -callback_host %H \
-callback_ports %L -set_pws %P -verbosity %V
%F
where:
-working_directory %D
Specifies the directory to which TotalView connects. TotalView expands %D to this directory’s absolute path name.
When you use this option, the host computer and the target computer must mount identical file systems. That is, the path name of the directory to which TotalView connects must be identical on the host and target computers.
After performing this operation, tvdsvr starts executing.
-callback_host %H
Names the host upon which TotalView makes this callback. TotalView expands %H to the host name of the computer on which TotalView is running.
-callback_ports %L
Names the ports on the host computers that TotalView uses for callbacks. TotalView expands %L to a comma-separated list of host names and TCP/IP port numbers (hostname:portnumber,hostname:portnumber,...) on which TotalView is listening for connections.
-set_pws %P
Sets 64-bit passwords. TotalView must supply these passwords when tvdsvr establishes the connection with it. %P expands to a comma-separated list of 64-bit passwords that TotalView automatically generates. For more information, see TotalView Debugger Server (tvdsvr) Command Syntax” in the TotalView for HPC Reference Guide.
-verbosity %V
Sets the tvdsvr verbosity level. TotalView expands %V to the current verbosity setting.For information on verbosity, see the “Variables” chapter within the TotalView for HPC Reference Guide.
You must enable the use of the array command by tvdsvr by adding the following information to the /usr/lib/array/arrayd.conf file:
#
# Command that allows invocation of the TotalView
# Debugger server when performing a Bulk Server Launch.
#
command tvdsvr
invoke /opt/totalview/bin/tvdsvr %ALLARGS
user %USER
group %GROUP
project %PROJECT
If your code is not in /opt/totalview/bin, you will need to change this information. For information on the syntax of the tvdsvr command, see TotalView Debugger Server (tvdsvr) Command Syntax” in the TotalView for HPC Reference Guide.
Cray XT Series
The following is the bulk server launch string for Cray XT series computers:
svrlaunch %B/tvdsvrmain%K -verbosity %V %F %H \
%t1 %I %K
where the options unique to this command are:
%B
The bin directory where tvdsvr resides.
%K
The number of servers that TotalView launches.
-verbosity %V
Sets the verbosity level of the tvdsvr. %V expands to the current verbosity setting. For information on verbosity, see the “Variables” chapter within the TotalView for HPC Reference Guide.
%F
Contains the “tracer configuration flags” that need to be sent to tvdsvr processes. These are system-specific startup options that the tvdsvr process needs.
%H
Expands to the host name of the machine upon which TotalView is running.
%t1
A temporary file created by TotalView that contains a list of the hosts on which tvdsvr runs. This is the information you enter in the Temp File 1 Prototype field on the Bulk Launch Page.
%I
Expands to the pid of the MPI starter process. For example, it can contain mpirun, aprun, etc. It can also be the process to which you manually attach. If no pid is available, %I expands to 0.
IBM RS/6000 AIX
The following is the bulk server launch string on an IBM RS/6000 AIX computer:
%C %H -n “poe -pgmmodel mpmd -resd no -tasks_per_node 1\
-procs %N -hostfile %t1 -cmdfile %t2 %F”
where the options unique to this command are:
%N
The number of servers that TotalView launches.
%t1
A temporary file created by TotalView that contains a list of the hosts on which tvdsvr runs. This is the information you enter in the Temp File 1 Prototype field on the Bulk Launch Page.
TotalView generates this information by expanding the %R symbol. This is the information you enter in the Temp File 2 Prototype field on the Bulk Launch Page.
%t2
A file that contains the commands to start the tvdsvr processes on each computer. TotalView creates these lines by expanding the following template:
tvdsvr -working_directory %D \
-callback %L -set_pw %P \
-verbosity %V
Information on the options and expansion symbols is in the TotalView Debugger Server (tvdsvr) Syntax” chapter of the TotalView for HPC Reference Guide.