sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2025-03-09 08:58:35 +03:00
Code
samba-mirror/ctdb/doc/onnode.1

163 lines
4.1 KiB
Groff
Raw Normal View History

added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.\" Title: onnode
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
remove NATGW_PRIVATE_IFACE from the documentation since we do not need it any more. (This used to be ctdb commit c967b234f59e5998bc8f2250062f4b0d1f39d820)
2009-05-12 18:21:26 +10:00
.\" Date: 05/12/2009
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
.\" Manual:
.\" Source:
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.\"
remove NATGW_PRIVATE_IFACE from the documentation since we do not need it any more. (This used to be ctdb commit c967b234f59e5998bc8f2250062f4b0d1f39d820)
2009-05-12 18:21:26 +10:00
.TH "ONNODE" "1" "05/12/2009" "" ""
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
.SH "NAME"
onnode - run commands on ctdb nodes
.SH "SYNOPSIS"
.HP 38
\fBonnode [OPTION] \.\.\. NODES COMMAND \.\.\.\fR
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.SH "DESCRIPTION"
.PP
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
onnode is a utility to run commands on a specific node of a CTDB cluster, or on all nodes\.
.PP
The NODES option specifies which node to run a command on\. You can specify a numeric node number (from 0 to N\-1) or a descriptive node specification (see DESCRIPTIVE NODE SPECIFICATIONS below)\. You can also specify 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\.
.PP
The COMMAND can be any shell command\. The onnode utility uses ssh or rsh to connect to the remote nodes and run the command\.
.SH "DESCRIPTIVE NODE SPECIFICATIONS"
.PP
The following descriptive node specification can be used in place of numeric node numbers:
.PP
all
.RS 4
All nodes\.
.RE
.PP
ok | healthy
.RS 4
All nodes that are not disconnected, banned, disabled or unhealthy\.
.RE
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.PP
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
con | connected
.RS 4
All nodes that are not disconnected\.
.RE
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.PP
remove NATGW_PRIVATE_IFACE from the documentation since we do not need it any more. (This used to be ctdb commit c967b234f59e5998bc8f2250062f4b0d1f39d820)
2009-05-12 18:21:26 +10:00
lvs | lvsmaster
.RS 4
The current LVS master\.
.RE
.PP
natgw | natgwlist
.RS 4
The current NAT gateway\.
.RE
.PP
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
rm | recmaster
.RS 4
The current recovery master\.
.RE
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
.SH "OPTIONS"
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.PP
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
\-c
.RS 4
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
Execute COMMAND in the current working directory on the specified nodes\.
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
.RE
.PP
remove NATGW_PRIVATE_IFACE from the documentation since we do not need it any more. (This used to be ctdb commit c967b234f59e5998bc8f2250062f4b0d1f39d820)
2009-05-12 18:21:26 +10:00
\-o <prefix>
.RS 4
Causes standard output from each node to be saved into a file with name <prefix>\.<ip>\.
.RE
.PP
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
\-p
.RS 4
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
Run COMMAND in parallel on the specified nodes\. The default is to run COMMAND sequentially on each node\.
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
.RE
.PP
\-q
.RS 4
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
Do not print node addresses\. Normally, onnode prints informational node addresses if more than one node is specified\. This overrides \-v\.
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
.RE
.PP
\-v
.RS 4
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
Print a node addresses even if only one node is specified\. Normally, onnode prints informational node addresses when more than one node is specified\.
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
.RE
.PP
\-h, \-\-help
.RS 4
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
Show a short usage guide\.
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
.RE
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.SH "EXAMPLES"
.PP
The following command would show the process ID of ctdb on all nodes
.sp
.RS 4
.nf
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
onnode all pidof ctdbd
.fi
.RE
.PP
The following command would show the last 5 lines of log on each node, preceded by the node\'s hostname
.sp
.RS 4
.nf
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
onnode all "hostname; tail \-5 /var/log/log\.ctdb"
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.fi
.RE
.PP
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
The following command would restart the ctdb service on all nodes\.
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.sp
.RS 4
.nf
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
onnode all service ctdb restart
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.fi
.RE
.PP
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
The following command would run \./foo in the current working directory, in parallel, on nodes 0, 2, 3 and 4\.
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.sp
.RS 4
.nf
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
onnode \-c \-p 0,2\-4 \./foo
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.fi
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
.RE
.SH "FILES"
.PP
/etc/ctdb/nodes
.RS 4
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
Contains a list of each node\'s IP address or hostname\.
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
.RE
.PP
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
/etc/ctdb/onnode\.conf
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
.RS 4
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
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\.
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.RE
.SH "SEE ALSO"
.PP
ctdbd(1), ctdb(1),
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
\fI\%http://ctdb.samba.org/\fR
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.SH "COPYRIGHT/LICENSE"
.sp
.RS 4
.nf
Copyright (C) Andrew Tridgell 2007
Copyright (C) Ronnie sahlberg 2007
When in verbose mode with -p, each line is prefixed with the node address/name. To implement this stderr has redirected to stdout - this doesn't need to be done but is the simplest implementation. Remove -t option since it doesn't seem to accomplish much but causes spurious messages to be displayed by ssh. Add explicit -h and --help options. Make style of usage message consistent with documentation. Document new features in doc/onnode.1.xml. (This used to be ctdb commit dfaf2c1581e547df831b3171ad47acd27b4ca2af)
2008-07-10 14:19:52 +10:00
Copyright (C) Martin Schwenke 2008
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
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
update lib/replace from samba4 (This used to be ctdb commit f0555484105668c01c21f56322992e752e831109)
2007-07-10 15:29:31 +10:00
the Free Software Foundation; either version 3 of the License, or (at
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
your option) any later version\.
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\. See the GNU
General Public License for more details\.
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
You should have received a copy of the GNU General Public License
Check that a database exists first before we dump its content (and implicitely also create it) using 'ctdb catdb' (This used to be ctdb commit 647003da975d4823abe8ed2bfb46153d68ea0fb0)
2008-09-23 01:38:28 +10:00
along with this program; if not, see http://www\.gnu\.org/licenses/\.
added onnode manual page (This used to be ctdb commit 6f4a1b4dbc9a5d48513477fb4f5e214a51f70941)
2007-06-12 13:44:01 +10:00
.fi
.RE
Copy Permalink