table of contents
other versions
- jessie 2:4.2.14+dfsg-0+deb8u9
- stretch 2:4.5.16+dfsg-1
- testing 2:4.9.4+dfsg-4
- unstable 2:4.9.4+dfsg-4
- experimental 2:4.9.5+dfsg-1
ONNODE(1) | CTDB - clustered TDB database | ONNODE(1) |
NAME¶
onnode - run commands on CTDB cluster nodesSYNOPSIS¶
onnode [OPTION...] {NODES}
{COMMAND}
DESCRIPTION¶
onnode is a utility to run commands on a specific node of a CTDB cluster, or on all nodes. NODES specifies which node(s) to run a command on. See section NODES SPECIFICATION for details. COMMAND can be any shell command. The onnode utility uses ssh or rsh to connect to the remote nodes and run the command.OPTIONS¶
-cExecute COMMAND in the current working directory on the
specified nodes.
-f FILENAME
Specify an alternative nodes FILENAME to use instead of
the default. This option overrides the CTDB_NODES_FILE environment variable.
See the discussion of /etc/ctdb/nodes in the FILES section for more
details.
-i
Keep standard input open, allowing data to be piped to
onnode. Normally onnode closes stdin to avoid surprises when scripting. Note
that this option is ignored when using -p or if SSH is set to
anything other than "ssh".
-n
Allow nodes to be specified by name rather than node
numbers. These nodes don't need to be listed in the nodes file. You can avoid
the nodes file entirely by combining this with -f /dev/null.
-o PREFIX
Causes standard output from each node to be saved into a
file with name PREFIX. IP.
-p
Run COMMAND in parallel on the specified nodes. The
default is to run COMMAND sequentially on each node.
-P
Push files to nodes. Names of files to push are specified
rather than the usual command. Quoting is fragile/broken - filenames with
whitespace in them are not supported.
-q
Do not print node addresses. Normally, onnode prints
informational node addresses if more than one node is specified. This
overrides -v.
-v
Print node addresses even if only one node is specified.
Normally, onnode prints informational node addresses when more than one node
is specified.
-h, --help
Show a short usage guide.
NODES SPECIFICATION¶
Nodes can be specified via numeric node numbers (from 0 to N-1) or mnemonics. Multiple nodes are specified using lists of nodes, separated by commas, and ranges of numeric node numbers, separated by dashes. If nodes are specified multiple times then the command will be executed multiple times on those nodes. The order of nodes is significant. The following mnemonics are available: allAll nodes.
any
A node where ctdbd is running. This semi-random but there
is a bias towards choosing a low numbered node.
ok | healthy
All nodes that are not disconnected, banned, disabled or
unhealthy.
con | connected
All nodes that are not disconnected.
lvs | lvsmaster
The current LVS master.
natgw | natgwlist
The current NAT gateway.
rm | recmaster
The current recovery master.
EXAMPLES¶
The following command would show the process ID of ctdbd on all nodesonnode all ctdb getpid
onnode all "hostname; tail -5 /var/log/log.ctdb"
onnode -p all service ctdb restart
onnode -c -p 0,2-4 ./foo
ENVIRONMENT¶
CTDB_BASEDirectory containing CTDB configuration files. The
default is /etc/ctdb.
CTDB_NODES_FILE
Name of alternative nodes file to use instead of the
default. See the FILES section for more details.
FILES¶
/etc/ctdb/nodesDefault file containing a list of each node's IP address
or hostname.
Actually, the default is $CTDB_BASE/nodes, where CTDB_BASE defaults to
/etc/ctdb. If a relative path is given (via the -f option or CTDB_BASE)
and no corresponding file exists relative to the current directory then the
file is also searched for in the $CTDB_BASE directory.
/etc/ctdb/onnode.conf
If this file exists it is sourced by onnode. The main
purpose is to allow the administrator to set SSH to something other
than "ssh". In this case the -t option is ignored. For example, the
administrator may choose to use use rsh instead of ssh.
SEE ALSO¶
ctdb(7), http://ctdb.samba.org/AUTHOR¶
This documentation was written by Andrew Tridgell, Martin SchwenkeCOPYRIGHT¶
Copyright © 2007 Andrew Tridgell, Ronnie Sahlberg11/12/2017 | ctdb |