pssh — run a command on a remote node.


pssh [ -e envlist] [ -l name] [ -r ] [ -v ] { -n node-id} { -h hostname} [command [args]]

pssh [ -V ]

pssh [ -? ]


pssh runs a command on a remote node. It is similar to the ssh command, except that the ParaStation MPI daemon is used to start the remote command.

Global options

-e, --exports= envlist

Export the environment variables envlist to the remote command. Envlist may be a single variable name or a colon separated list of names.

-h, --host= node

Run command on node node.

-l, --login= name

Login as user name. Only root may login as a different user on the node.

-n, --node= node-id

Run command on node with ID node-id.

-r, --rusage

Report resource usage upon exit.


Be more verbose.


Print version and exit.

-?, --help

Show a help message.


Show a usage message.

Extended description

The pssh command runs a shell or a command command providing arguments args as an admin-task on a remote node. The local user must be within the adminuser list of the ParaStation MPI daemon or must be a member of the admingroup list. Refer to psiadmin(8) and ParaStation MPI User's Guide for details how to configure adminusers or admingroups.

Only root may use the -l option to login as a different user.

The destination host may be either specified using the hosts ParaStation MPI node ID (option -n) or using the hosts name (option -h).


The admin-task run by pssh will not be counted for the ParaStation MPI process placement and will not be started obeying the placement rules enforced by ParaStation MPI.

To run a serial task using the ParaStation MPI process placement rules, use psmstart(8). To run a command in parallel on multiple nodes, use psh(8). To run a parallel job, use mpiexec(8).


Currently, there is no way to change the user id except for root. There is no way to provide a password. The data is not encrypted while transfered across the network.

See also

psmstart(8), psh(8), psiadmin(8) and parastation.conf(8).