NAME

psh - parallel remote shell

SYNOPSIS

psh [-s] [noderange|me|pbs job id] [command]

psh [-h|--help|-v|--version]

DESCRIPTION

psh is a utility used to run a command across a list of nodes in parallel. See noderange (3).

psh relies on the rsh field in site.tab (5) to determine whether to use rsh, ssh, or any other method to launch a remote shell. rsh, ssh, or any other method must be set up to allow no prompting (that is .rhosts for rsh and sshd_config and .rhosts for ssh) for psh to work.

OPTIONS

-s

Issues the commands serially.

noderange

See noderange (3).

me

Run against nodes owned by "me" as listed by PBS's qstat (1B) command.

pbs job id

Run against nodes assigned to a PBS job as listed by PBS's qstat (1B) command.

command

Command to be run in parallel. If no command is give then psh enters 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.

-v|--version

Print version.

FILES

$XCATROOT/etc/nodelist.tab

xCAT nodelist file. See nodelist.tab (5) for further details.

$XCATROOT/etc/site.tab

xCAT main configuration file. psh uses this to determine the remote shell command to use. See site.tab (5) for further details.

DIAGNOSTICS

The following diagnostics may be issued on stdout/stderr:

is not a node or a group

Node or group is not defined in nodelist.tab (5).

noping

Remote node is not up.

ssh and rsh errors

Verify the ssh and rsh are setup with no prompting and access to all nodes is allowed.

EXAMPLES

psh node4-node6 uptime

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

psh node1-node10 rm -f /tmp/blah

psh rack01 'rm -f /tmp/*'

Notice the use of '' to forward shell expansion. This is not necessary in interactive mode.

BUGS

csh issues.

AUTHOR

Egan Ford <egan@us.ibm.com>

SEE ALSO

noderange (3) prcp (1) pping (1) prsync (1)