psh.1

Name

psh - parallel remote shell

Synopsis

psh [-i interface] [-f fanout] [-l user] noderange command

psh {-h | --help | -v | --version}

Description

psh is a utility used to run a command across a list of nodes in parallel.

ssh must be set up to allow no prompting for psh to work.

Note:

This command does not run through xcatd like most xCAT commands do. This means you must either run it on the management node, or have a network connection between your machine and the nodes. It does not support hierarchy, use xdsh to run remote command from the management node to the compute node via a service node.

psh arguments need to precede noderange, otherwise, you will get unexpected errors.

Options

-i interface

The NIC on the node that psh should communicate with. For example, if interface is eth1, then psh will concatenate -eth1 to the end of every node name before ssh’ing to it. This assumes those host names have been set up to resolve to the IP address of each of the eth1 NICs.

-f fanout

Specifies a fanout value for the maximum number of concur- rently executing remote shell processes.

-l user

Log into the nodes as the specified username. The default is to use the same username as you are running the psh command as.

-n|--nonodecheck

Do not send the noderange to xcatd to expand it into a list of nodes. Instead, use the noderange exactly as it is specified. In this case, the noderange must be a simple list of comma-separated hostnames of the nodes. This allows you to run psh even when xcatd is not running.

noderange

See noderange(3)|noderange.3.

command

Command to be run in parallel. If no command is give then pshenters interactive mode. In interactive mode a “>” prompt is displayed. Any command entered is executed in parallel to the nodes in the noderange. Use “exit” or “Ctrl-D” to end the interactive session.

-h | --help

Print help.

Environment Variables

XCATPSHFANOUT

Specifies the fanout value. This variable is overridden by the -f flag. Default is 64.

Examples

Run uptime on 3 nodes:

psh node4-node6 uptime

Output is similar to:

node4: Sun Aug  5 17:42:06 MDT 2001
node5: Sun Aug  5 17:42:06 MDT 2001
node6: Sun Aug  5 17:42:06 MDT 2001

Run a command on some BladeCenter management modules:

psh amm1-amm5 'info -T mm[1]'

Remove the tmp files on the nodes in the 1st frame:

psh rack01 'rm -f /tmp/*'
Notice the use of ‘’ to forward shell expansion. This is not necessary in interactive mode.