parallel-ssh(1) parallel versions of the openssh tools

SYNOPSIS

parallel-ssh [OPTIONS] -h hosts.txt prog [arg0...]

DESCRIPTION

pssh provides a number of commands for executing against a group of computers, using SSH. It's most useful for operating on clusters of homogenously-configured hosts.

OPTIONS

-h --hosts

hosts file (each line "host[:port] [user]")

-l --user

username (OPTIONAL)

-p --par

max number of parallel threads (OPTIONAL)

-o --outdir

output directory for stdout files (OPTIONAL)

-e --errdir

output directory for stderr files (OPTIONAL)

-t --timeout

timeout (secs) (-1 = no timeout) per host (OPTIONAL)

-O --options

SSH options (OPTIONAL)

-v --verbose

turn on warning and diagnostic messages (OPTIONAL)

-P --print

print output as we get it (OPTIONAL)

-i --inline

inline aggregated output for each server (OPTIONAL)

EXAMPLE

The following example runs hostname on three machines (IPs or hostnames) specified in the file ips.txt using login irb2 and saves the output in /tmp/foo.

# cat ips.txt
128.112.152.122
18.31.0.190
128.232.103.201
# parallel-ssh -h ips.txt -l irb2 -o /tmp/foo hostname
Success on 128.112.152.122:22
Success on 18.31.0.190:22
Success on 128.232.103.201:22
# ls /tmp/foo
128.112.152.122  128.232.103.201  18.31.0.190
# cat /tmp/foo/*
planetlab-1.cs.princeton.edu
planetlab1.xeno.cl.cam.ac.uk
planetlab1.lcs.mit.edu

By default, pssh uses at most 32 ssh processes in parallel to ssh to the various nodes. (This is somewhat important if you're controlling hundreds or thousands of machines.) By default, it also uses a timeout of one minute to ssh to a node and obtain a result. For ssh commands that take longer than this (e.g., sleep 61), the -t option can be used. Note that pssh and pnuke have a default timeout of one minute. pscp and prsync have no default timeout, but one can be specified using the -t option.

ENVIRONMENT

All four programs take similar sets of options. All of these options can be set using the following environment variables:

•PSSH_HOSTS
•PSSH_USER
•PSSH_PAR
•PSSH_OUTDIR
•PSSH_VERBOSE
•PSSH_OPTIONS

AUTHOR

Brent N. Chun <[email protected]>

COPYING

Copyright: 2003, 2004, 2005, 2006, 2007 Brent N. Chun