ssh-para 1.1.4

Interactive Parallel SSH jobs manager

ssh-para

Parallel SSH jobs manager CLI (alternative to parallel-ssh)

• POSIX/Linux/MacOS/Windows compatible (with openssh client installed)
• Launch parallel ssh jobs/scripts on remote hosts, with interactive display of the running commands outputs
• Keep all output in log files
• Interactive pause/resume/abort jobs, kill stuck ssh connection interactively.

installation

pip install ssh-para

By default, ssh-para uses Nerd Fonts characters (can be overridden with SSHP_SYM_* environment variables, see below)

usage

ssh-para -h

usage: ssh-para [-h] [-p PARALLEL] [-j JOB] [-d DIRLOG] [-f HOSTSFILE | -H HOSTS [HOSTS ...]]
                [-s SCRIPT] [-a ARGS [ARGS ...]] [-t TIMEOUT] [-r] -- [ssh_args ...]

positional arguments:
  ssh_args

options:
  -h, --help            show this help message and exit
  -p PARALLEL, --parallel PARALLEL
                        parallelism (default 4)
  -j JOB, --job JOB     Job name added subdir to dirlog
  -d DIRLOG, --dirlog DIRLOG
                        directory for ouput log files (~/.ssh-para)
  -f HOSTSFILE, --hostsfile HOSTSFILE
                        hosts list file
  -H HOSTS [HOSTS ...], --hosts HOSTS [HOSTS ...]
                        hosts list
  -s SCRIPT, --script SCRIPT
                        script to execute
  -a ARGS [ARGS ...], --args ARGS [ARGS ...]
                        script arguments
  -t TIMEOUT, --timeout TIMEOUT
                        timeout of each jobs
  -r, --resolve         resolve fqdn in SSHP_DOMAINS

During run, use :

• k: to kill ssh command held by a thread (but remote command can still be running on remote host)
• p: pause all remaining jobs to be scheduled
• r: resume scheduling of jobs
• a: abort all remaining jobs
• ctrl-c: stop all/exit (but remote commands launched by ssh can still be running on remote servers)

Environment variables:

• SSHP_OPTS: ssh default options (Eg: "-F /home/user/.ssh/myconfig")
• SSHP_DOMAINS: dns domains to search when short hostname given (with -r/--resolve option)
• SSHP_SYM_BEG: Symbol character for begin decorative (default: "\ue0b4")
• SSHP_SYM_END: Symbol character for end decorative (default: "\ue0b6")
• SSHP_SYM_PROG: Symbol character for progress bar fill (default: "\u25a0")

Example

Patch redhat family hosts:

ssh-para -p 20 -f hostlist.txt -- 'sudo yum update -y;sudo shutdown -r +1'

Use specific ssh options / config (everything after -- will be passed to ssh command as is):

ssh-para -p 20 -H host1 host2 -- -F ~/.ssh/myconfig echo connect ok

Launch local script with argument on remote hosts:

ssh-para -p 20 -f hosts.txt -s ./myscript -a status

Extend limited resolv.conf search domains (try to resolve host in each domain, first resolved in the domain list is used as fqdn):

SSHP_DOMAINS="domain1.com domain2.com" ssh-para -r -H host1 host2 -- echo connect ok