Installation

Before install fuel-pdsh on master node, do the following:

$ yum install python-devel python-pip gcc

If you want system installation, do:

$ pip install fuel-pdsh

If you want to use virtualenv:

$ pip install virtualenv
$ virtualenv -p python2.6 --system-site-packages ~/.fuelpdsh-venv
$ source ~/.fuelpdsh-venv/bin/activate
$ pip install fuel-pdsh

Commandline options

The both of fuel-pdsh and fuel-pdcp have the same options set but different arguments.

usage: fuel-pdsh [-h] [--concurrency CONCURRENCY] [-c CLUSTER_ID]
                 [-w NODE_IDS] [-i IPS] [-n NAME] [-s STATUS] [-g GROUP_ID]
                 [-r ROLES] [-v | -d]
                 command [command ...]

positional arguments:
  command               Command to execute

optional arguments:
  -h, --help            show this help message and exit
  --concurrency CONCURRENCY
                        How many simultaneous connections should be
                        established. By default (4), we are trying to connect
                        to all nodes, no limits.
  -c CLUSTER_ID, --cluster-id CLUSTER_ID
                        Select only nodes which belong to cluster with such
                        ID.
  -w NODE_IDS, --node-ids NODE_IDS
                        Plain comma-separated list of nodes.
  -i IPS, --ips IPS     Plain comma-separated list of node IPs.
  -n NAME, --name NAME  Regular expression for the node name.
  -s STATUS, --status STATUS
                        Node status.
  -g GROUP_ID, --group-id GROUP_ID
                        Group ID.
  -r ROLES, --roles ROLES
                        Node roles.
  -v, --verbose         Be verbose.
  -d, --debug           Be event more verbose, for debugging.

Please contact Sergey Arkhipov <serge@aerialsounds.org> for issues.

$ fuel-pdsh -n contr -- echo hello world
node-4 :  hello world
node-39:  hello world
node-3 :  hello world

$ fuel-pdsh -n contr -v -- echo hello world
*** 140489797273344 >>> Found 3 suitable nodes
*** 140489797273344 >>> Execute with 4 threads
node-4 :  hello world
node-39:  hello world
node-3 :  hello world

$ fuel-pdsh -c 1 -- ls

$ fuel-pdsh -w 2,4,8 -- ls

$ fuel-pdsh -w node-2,4,node-8 -- ls

$ fuel-pdsh -i 10.0.0.1,10.0.0.2 -- ls

$ fuel-pdsh -n contro -- ls

$ fuel-pdsh -s ready -- ls

$ fuel-pdsh -g 10 -- ls

$ fuel-pdsh -r compute -- ls

fuel-pdsh

fuel-pdsh is a tool to execute commands in parallel on different hosts. Let’s assume you want to restart Apache on all controllers. Then do following:

$ fuel-pdsh -r controller service apache2 restart

Sometimes you need to pass arguments to the command which may be recognized as an arguments for fuel-pdsh itself. No worries, good old -- is supported.

$ fuel-pdsh -r controller -- manage.py --noinput

Sometimes you have to invoke several commands. No worries again:

$ fuel-pdsh -r controller -- sh -c "command1 && command2; command3"

fuel-pdcp

fuel-pdcp is a utility to copy files on multiple hosts simultaneously.

$ fuel-pdcp -r controller -- zabbix.deb /tmp

This will copy Zabbix package to /tmp on all controllers. Also, you may copy several files:

$ fuel-pdcp -r controller -- zabbix.deb zabbix.conf /tmp

Important: destination is considered directory. So if you do following

$ fuel-pdcp -r controller -- zabbix.deb /tmp/zabbix.deb

Then new directory /tmp/zabbix.deb/ will be created and you file gonna be copied in /tmp/zabbix.deb/zabbix.deb. This is intentional because to avoid ambiguaty on copying several files into one place. Please remember about that.