Multipurpose Daemon Commands

mpd

Start Multipurpose daemon* (MPD).

Syntax

mpd [ --help ] [ -V ] [ --version ] [ --host=<host> --port=<portnum> ] \

[ --noconsole ] [ --trace ] [ --echo ] [ --daemon ] [ --bulletproof ]\

[ --i fhn <interface/hostname> ] [ --listenport <listenport> ]

Arguments

--help

Display a help message

-V | --version

Display the Intel® MPI Library version information

-h <host> -p <portnum> |

--host=<host> --port=

<portnum>

Specify the host and port to be used for entering an existing ring. The --host and --port options must be specified together

-n | --noconsole

Do not create a console at startup

-t | --trace

Print internal MPD trace information

-e | --echo

Print a port number at startup to which other mpds may connect

-d | --daemon

Start mpd in daemon mode. By default, the interactive mode is enabled

--bulletproof

Turn MPD bulletproofing on

--ifhn=<interface/

hostname>

Specify <interface/hostname> to use for MPD communications

-l <listenport> |

--listenport=

<listenport>

Specify the mpd listening port

Description

Multipurpose daemon* (MPD) is the Intel® MPI Library process management system for starting parallel jobs. Before running a job, start mpd daemons on each host and connect them into a ring. Long parameter names may be abbreviated to their first letters by using only one hyphen and no equal sign. For example,

$ mpd -h masterhost -p 4268 -n

is equivalent to

$ mpd --host=masterhost --port=4268 -noconsole

If a file named .mpd.conf is available in the user's home directory, only the user can have read and write privileges. The file must minimally contain a line with secretword=<secretword>. If you want to run MPD as root, create the mpd.conf file in the /etc directory instead of .mpd.conf in the root's home directory to run mpd as root. Avoid starting the MPD ring under the root account.

Note

Multipurpose daemon* (MPD) has been deprecated since Intel® MPI Library 5.0 release. You can use scalable process management system (Hydra) to start parallel jobs.

mpdboot

Start mpd ring.

Syntax

mpdboot [ -h ] [ -V ] [ -n <#nodes> ] [ -f <hostsfile> ] [ -r <rshcmd> ] \

[ -u <user> ] [ -m <mpdcmd> ] [ --loccons ] [ --remcons ] \

[ -s ] [ -d ] [ -v ] [ -1 ] [ --ncpus=<ncpus> ] [ -o ] \

[ -b <maxbranch> ] [ -p ]

or

mpdboot [ --help ] [ --version ] [ --totalnum=<#nodes> ] \

[ --file=<hostsfile> ] [ --rsh=<rshcmd> ] [ --user=<user> ] \

[ --mpd =<mpdcmd> ] [ --loccons ] [ --remcons ] [ --shell ] \

[ --debug ] [ --verbose ] [ -1 ] [ --ncpus=<ncpus> ] [ --ordered ]

[ --maxbranch=<maxbranch> ] [ --parallel-startup ]

Arguments

-h | --help

Display a help message

-V | --version

Display Intel® MPI Library version information

-d | --debug

Print debug information

-v | --verbose

Print more information. Show the <rshcmd> attempts

-n <#nodes> |

--totalnum=<#nodes>

Number of nodes in mpd.hosts on which daemons are started

-r <rshcmd> |  

--rsh=<rshcmd>

Specify remote shell to start daemons and jobs. The default value is ssh

-f <hostsfile> |

--file=<hostsfile>

Path/name of the file that has the list of machine names on which the daemons are started

-1

Enable starting multiple mpd per machine

-m <mpdcmd> |  

--mpd=<mpdcms>

Specify the full path name of the mpd on the remote hosts

-s | --shell

Specify the shell

-u <user> | --user=<user>

Specify the user

--loccons

Do not create local MPD consoles

--remcons

Do not create remote MPD consoles

--ncpus=<ncpus>

Indicate how many processors to use on the local machine (other nodes are listed in the hosts file)

-o | --ordered

Start all the mpd daemons in the order as specified in the mpd.hosts file

-b <maxbranch> |

--maxbranch=<maxbranch>

Use this option to indicate the maximum number of the mpd daemons to enter the mpd ring under another. This helps to control the parallelism of the mpd ring start. The default value is four

-p |--parallel-startup

Use this option to allow parallel fast starting of mpd daemons under one local root. No daemon checking is performed. This option also supports shells which do not transfer the output from the remote commands

Description

Start the mpd daemons on the specified number of nodes by providing a list of node names in <mpd.hosts>.

The mpd daemons are started using the ssh command by default. If the ssh connectivity is not enabled, use the -r rsh option to switch over to rsh. Make sure that all nodes in the cluster can connect to each other through the ssh command without a password or, if the -r rsh option is used, through the rsh command without a password.

Note

The mpdboot command spawns an MPD daemon on the host machine, even if the machine name is not listed in the mpd.hosts file.

mpdexit

Shut down a single mpd daemon.

Syntax

mpdexit [ --help ] [ -V ] [--version ] <mpdid>

Arguments

--help

Display a help message

-V | --version

Display Intel® MPI Library version information

<mpdid>

Specify the mpd daemon to kill

Description

Use this command to cause the single mpd daemon to exit. Use <mpdid> obtained through the mpdtrace -l command in the form <hostname>_<port number>.

mpdallexit

Shut down all mpd daemons on all nodes.

Syntax

mpdallexit [ --help ] [ -V ] [ --version ]

Arguments

--help

Display a help message

-V | --version

Display Intel® MPI Library version information

Description

Use this command to shut down all MPD rings you own.

mpdcleanup

Clean up the environment after an mpd crash.

Syntax

mpdcleanup [ -h ] [ -V ] [ -f <hostsfile> ] [ -r <rshcmd> ] [ -u <user> ]\

[ -c <cleancmd> ] [ -a]

or

mpdcleanup [ --help ] [ --version ] [ --file=<hostsfile> ] \

[ --rsh=<rshcmd> ] [ --user=<user> ] [ --clean=<cleancmd> ] \

[ --all]

Arguments

-h | --help

Display a help message

-V | --version

Display Intel® MPI Library version information

-f <hostsfile> |

--file=<hostsfile>

Specify the file containing a list of machines to clean up

-r <rshcmd> |

--rsh=<rshcmd>

Specify the remote shell to use

-u <user> |

--user=<user>

Specify the user

-c <cleancmd> |

--clean=<cleancmd>

Specify the command to use for removing the UNIX* socket. The default command is /bin/rm -f

-a | --all

Kill all mpd daemons related to the current settings of the I_MPI_JOB_CONTEXT environment variable on all hosts specified in <hostsfile>

Description

Use this command to clean up the environment after an mpd crash. It removes the UNIX* socket on local and remote machines or kills all mpd daemons related to the current environment controlled by the I_MPI_JOB_CONTEXT environment variable.

For instance, use the following command to remove the UNIX sockets on machines specified in the hostsfile file:

$ mpdcleanup --file=hostsfile

Use the following command to kill the mpd daemons on the machines specified in the hostsfile file:

$ mpdcleanup --file=hostsfile --all

mpdtrace

Determine whether mpd is running.

Syntax

mpdtrace [ --help ] [ -V ] [ --version ] [ -l ]

Arguments

--help

Display a help message

-V | --version

Display Intel® MPI Library version information

-l

Show MPD identifiers instead of the hostnames

Description

Use this command to list the hostnames or identifiers of all mpds in the ring. The output identifiers have the form <hostname>_<port number>.

mpdcheck

Check for configuration problems on the host or print configuration information about this host.

Syntax

mpdcheck [ -v ] [ -l ] [ -h ] [ --help ] [ -V ] [ --version ]

mpdcheck -pc [ -v ] [ -l]

mpdcheck -f <host_file> [ -ssh ] [ -v ] [ -l]

mpdcheck -s [ -v ] [ -l]

mpdcheck -c < server_host> <server_port> [ -v ] [ -l]

Arguments

-h | --help

Display a help message

-V | --version

Display Intel® MPI Library version information

-pc

Print configuration information about a local host

-f <host_file>

Print information about the hosts listed in <host_file>

-ssh

Invoke testing of ssh on each remote host. Use in conjunction with the -f option

-s

Run mpdcheck as a server on one host

-c <server_host> <server_port>

Run mpdcheck as a client on the current or different host. Connect to the <server_host> <server_port>

-l

Print diagnostic messages in extended format

-v

Print the actions that mpdcheck is performing

Description

Use this command to check configuration problems on the cluster nodes. Any output line that starts with *** indicates a potential problem.

If you have problems running parallel jobs through mpd on one or more hosts, try to run the script once on each of those hosts.

mpdringtest

Test the MPD ring.

Syntax

mpdringtest [ --help ] [ -V ] [ --version ] <number of loops>

Arguments

--help

Display a help message

-V | --version

Display Intel® MPI Library version information

<number of loops>

Number of loops

Description

Use this command to test how long it takes for a message to circle the mpd ring.

mpdlistjobs

Syntax

mpdlistjobs [ -h ] [ -V ] [ -u <username> ] [ -a <jobalias> ] [ -j <jobid> ]

or

mpdlistjobs [ --help ] [ --version ] [ --user=<username> ] \

[ --alias=<jobalias> ] [ --jobid=<jobid> ]

Arguments

-h | --help

Display a help message

-V | --version

Display Intel® MPI Library version information

-u <username>|  

--user=<username>

List jobs of a particular user

-a <jobalias> | --alias=<jobalias>

List information about the particular job specified by <jobalias>

-j <jobid> |  

--jobid=<jobid>

List information about the particular job specified by <jobid>

Description

Use this command to list the running processes for a set of MPI jobs. All jobs for the current machine are displayed by default.

mpdsigjob

Apply a signal to a process running an application.

Syntax

mpdsigjob [ --help ] [ -V ] [ --version ] <sigtype> \

[-j <jobid> | -a <jobalias> ] [-s | -g ]

Arguments

--help

Display a help message

-V | --version

Display Intel® MPI Library version information

<sigtype>

Specify the signal type to send. Valid options are -j or -a.

-a <jobalias>

Send a signal to the job specified by <jobalias>

-j <jobid>

Send a signal to the job specified by <jobid>

-s

Deliver a signal to a single user process

-g

Deliver a signal to a group of processes. This is the default behavior.

Description

Use this command to deliver a specific signal to the processes of a running job. The desired signal is the first argument. Specify one of two options: -j or -a.

mpdkilljob

Terminate a job.

Syntax

mpdkilljob [ --help ] [ -V ] [ --version ] [ <jobnum> ] [ -a <jobalias> ]

Arguments

--help

Display a help message

-V | --version

Display Intel® MPI Library version information

<jobnum>

Kill the job specified by <jobnum>

-a <jobalias>

Kill the job specified by <jobalias>

Description

Use this command to kill the job specified by <jobnum> or by <jobalias>. Obtain <jobnum> and <jobalias> from the mpdlistjobs command. The <jobid> field has the following format: <jobnum>@<mpdid>.

mpdhelp

Print brief help concerning MPD commands.

Syntax

mpdhelp [ -V ] [ --version ]

Arguments

-V | --version

Display Intel® MPI Library version information

Description

Use this command to obtain a brief help message concerning MPD commands.