table of contents
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¶
-c-f FILENAME
-i
-n
-o PREFIX
-p
-P
-q
-v
-h, --help
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:
all
any
ok | healthy
con | connected
EXAMPLES¶
The following command would show the process ID of ctdbd on all nodesonnode all ctdb getpid
The following command would show the last 5 lines of log on each node, preceded by the node's hostname
onnode all "hostname; tail -5 /var/log/ctdb/log.ctdb"
The following command would restart the ctdb service on all nodes, in parallel.
onnode -p all service ctdb restart
The following command would run ./foo in the current working directory, in parallel, on nodes 0, 2, 3 and 4.
onnode -c -p 0,2-4 ./foo
ENVIRONMENT¶
CTDB_BASECTDB_NODES_FILE
FILES¶
/etc/ctdb/nodesAs above, a file specified via the -f or CTDB_NODES_FILE is given precedence. If a relative path is specified and no corresponding file exists relative to the current directory then the file is also searched for in the $CTDB_BASE directory.
If CTDB_NODES_FILE is not set and CTDB_NODES is set in configuration then the file pointed to by CTDB_NODES is used.
Otherwise the default is $CTDB_BASE/nodes, where CTDB_BASE defaults to /etc/ctdb.
/etc/ctdb/onnode.conf
SEE ALSO¶
ctdb(7), http://ctdb.samba.org/AUTHOR¶
This documentation was written by Andrew Tridgell, Martin Schwenke
COPYRIGHT¶
Copyright © 2007 Andrew Tridgell, Ronnie SahlbergCopyright © 2008 Martin Schwenke
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, see http://www.gnu.org/licenses.
04/05/2019 | ctdb |