parallel-ssh(1)
NAME
parallel-ssh - 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:
o PSSH_HOSTS
o PSSH_USER
o PSSH_PAR
o PSSH_OUTDIR
o PSSH_VERBOSE
o PSSH_OPTIONS
SEE ALSO
parallel-scp(1), parallel-slurp(1), parallel-rsync(1),
parallel-nuke(1), ssh(1)
AUTHOR
Brent N. Chun <bnc@theether.org>
COPYING
Copyright: 2003, 2004, 2005, 2006, 2007 Brent N. Chun
NOTES
- 1. bnc@theether.org
- mailto:bnc@theether.org