PM Tools Ver. 1.2

[English], [Japanese]


NAME
pmload - initialize Myrinet interface

SYNOPSIS
% pmload [-unit unit][-mcp mcp_file][-conf conf_file]

DESCRIPTION
Pmload loads a LANai program(mcp), and initializes the Myrinet interface.

OPTIONS
-unit unit
Unit is used as the unit number of Myrinet interface to be initialized. Default is zero.
-mcp mcp_file
Mcp_file is used as the LANai program file. Default is "pm.mcp".
-conf config_file
Config_file is used as the PM configuration file. Default is "pm.cnf".

ERRORS
Pmload outputs the following message to stderr when it fails to initialize the Myrinet interface:

can't load mcp_file, config_file(error)

In above message, error is as follows:
Invalid argument
The value of unit is out of range.
No such device
The Myrinet interface unit does not exist.
The Myrinet interface cannot be mmap(2)ed.
Device busy
Some duplicated node names or routes exist in the configuration file.
No such file or directory
The mcp file or the configuration file does not exist.
No route to host
There is no route to some nodes.
Too many links
Hop count to some nodes exceeds 4.


NAME
pmroute - show routing information

SYNOPSIS
% pmroute [-conf config_file][-src src_pe][-dest dst_pe]

DESCRIPTION
Pmroute outputs the routing information of PM to stdout in the following format.
(src_node) -> port[switch]port -> (dst_node)

OPTIONS
-conf config_file
Config_file is used as the PM configuration file. Default is "pm.cnf".
-src src_pe
Src_pe is used as the source PE number. Default is all PEs.
-dest dst_pe
Dst_pe is used as the destination PE number. Default is all PEs.

ERRORS
Pmroute outputs the following messages to stderr on error.
can't read config_file(error)
Config_file cannot be read.
can't get node pe_num(error)
PE pe_num does not exist in the configuration file.
can't find route pe_num(error)
No route from PE pe_num could be found.


NAME
pmtest - test and measure the performance of PM

SYNOPSIS
[PE_Y]% pmtest -reply [PE_X]% pmtest -dest pe_y -ping [options]

[PE_Y]% pmtest -sink [PE_X]% pmtest -dest pe_y -burst -bw [options]

DESCRIPTION
Pmtest tests PM and measures its performance.
The first example executes a ping-pong transfer between node PE_X and node PE_Y and shows a round trip time.
The second example executes a burst transfer from node PE_X to node PE_Y and shows a bandwidth.

NOTICE
Because pmtest does not initialize the Myrinet interface, all Myrinet interfaces must be initialized before testing by pmload.
Pmtest use many memory. Before you run pmtest, please set datasize limit to 26 MB or grater.

OPTIONS
-len length
Length byte messages are used for testing. Default is 8 bytes.
-iter iteration
The test is repeated iteration times. Default is 100000.
-unit unit
Unit is used as the unit number of the Myrinet card to be tested. Default is zero.
-chan chan
Chan is used as the PM channel number for testing. Default is zero.
-ctx ctx
Ctx is used as the PM context number for testing. Default is zero.
-wait
Use blocking wait and interrupts to receive messages.
-bw
This option reports the data transfer rate(bandwidth: Bytes/second). Default is to report the time to execute one iteration of testing.

ERRORS
XXX: Operation timed out
XXX failed for a long time.


NAME
wsctest - tests PM over a whole cluster

SYNOPSIS
% wsctest [options]

DESCRIPTION
Wsctest tests PM over a whole cluster.

NOTICE
Wsctest executes the same executable file on the same directory on which wsctest is invoked using rsh(1) on all nodes under testing. By this reason, the host on which wsctest is invoked is not necessarily a cluster node, it must be able to rsh(1) to all cluster nodes to be tested.
Next, it must be possible to access the same executable file by copying the file to all nodes or by any file sharing facilities such as NFS.
Further, to chdir to the same directory, an environment variable PWD must be set as the logical path of the working directory on which wsctest is invoked. Some shells such as tcsh, bash and zsh set PWD correctly. If other shells are used with automount or amd to share files, and the physical path of the working directory is not same as the logical path of it, PWD must be set manually.
Finally, wsctest initializes the Myrinet interface, it is not necessary to execute pmload on each node.

OPTIONS
-unit unit
Unit is used as the unit number of the Myrinet card to be tested. Default is zero.
-chan chan
Chan is used as the PM channel number for testing. Default is zero.
-ctx ctx
Ctx is used as the PM context number for testing. Default is zero.
-len length
Length byte messages are used for testing. Default is 8 bytes.
-mcp mcp_file
Mcp_file is used as the LANai program file. Default is "pm.mcp".
-conf config_file
Config_file is used as the PM configuration file. Default is "pm.cnf".
-count count
This option specifies the number of tests. Default is infinity.
-pe num_pe
Num_pe PEs are tested. Default is all PEs of the cluster.
-base base_pe
Base_pe is used as the first PE number. Default is zero.
-burst
A burst transfer is used for testing. This is the default.
-ping
A ping-pong transfer is used for testing instead of a burst transfer.
-multi
A multicast transfer is used for testing instead of a burst transfer.
-v
-verbos
Show some messages while testing. Default is that no messages are shown except errors.

EXAMPLE
% wsctest -v -pe 32 -ping
Execute a ping-pong transfer test on 32 PEs.

ERRORS
wsctest outputs the following error message when any error occurs: node_name(pe#) XXX: error
XXX: Operation timed out
XXX failed for a long time.
Signal: Interrupted system call
Testing was interrupted by a signal.

BUGS
Because wsctest makes a very heavy load on the network, a timeout error may occur when a burst transfer is used and over 2 PEs are tested.

NAME
bustest - measure performance of the I/O bus

SYNOPSIS
% bustest [-unit unit]

DESCRIPTION
Bustest measures the data transfer rate of the I/O bus using the DMA engine of the Myrinet interface.
The output format of bustest is as follows.
cpu  read: WWW		I/O -> CPU
cpu write: XXX		CPU -> I/O
DMA  read: YYY		I/O -> Memory
DMA write: ZZZ		Memory -> I/O

OPTIONS
-unit unit
Unit is used as the unit number of the Myrinet card to be tested. Default is zero.

ERRORS
Bustest outputs the following error messages when any error occurs:
_pmMapLANai: error
The Myrinet interface cannot be initialized.
_pmMapContext: error
PM context zero cannot be initialized.