From mboxrd@z Thu Jan 1 00:00:00 1970 From: pcaulfield@sourceware.org Date: 22 Aug 2007 09:34:17 -0000 Subject: [Cluster-devel] cluster/cman/man cman_tool.8 Message-ID: <20070822093417.15979.qmail@sourceware.org> List-Id: To: cluster-devel.redhat.com MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit CVSROOT: /cvs/cluster Module name: cluster Changes by: pcaulfield at sourceware.org 2007-08-22 09:34:16 Modified files: cman/man : cman_tool.8 Log message: Update man page Patches: http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/cman/man/cman_tool.8.diff?cvsroot=cluster&r1=1.9&r2=1.10 --- cluster/cman/man/cman_tool.8 2005/04/27 10:29:32 1.9 +++ cluster/cman/man/cman_tool.8 2007/08/22 09:34:16 1.10 @@ -120,8 +120,9 @@ .SH "VERSION" OPTIONS .TP .I -r -The new config version. - +The new config version. You don't need to use this when adding a new node, +the new cman node will tell the rest of the cluster to get their latest +version of the config file from CCS automatically. .SH "WAIT" OPTIONS .TP .I -q @@ -133,13 +134,6 @@ .br .SH "JOIN" OPTIONS .TP -.I -X -Tells cman_tool to ignore CCS altogether. All of the information necessary -to join the cluster must be provided on the command-line. Note that if -you get this wrong, it is possible that the node will form a cluster on -it's own and ignore a cluster it is supposed to be joining, so this method -of invocation is not recommended. -.TP .I -c Provides a text name for the cluster. You can have several clusters on one LAN and they are distinguished by this name. Note that the name is hashed to @@ -149,7 +143,7 @@ another name or use different port number for cluster communication. .TP .I -p -UDP port number used for cluster communication. This defaults to 6809. +UDP port number used for cluster communication. This defaults to 5405. .TP .I -v Number of votes this node has in the cluster. Defaults to 1. @@ -180,9 +174,8 @@ .TP .I -N Overrides the node ID for this node. Normally, nodes are assigned a -node id by the cluster join mechanism. If you want to ensure that -your nodes always have the same number regardless of the order in -which they join the cluster then you can hard-code these IDs. +node id in CCS. If you specify an incorrect node ID here, the +node might not be allowed to join the cluster. .TP .I -o Override the name this node will have in the cluster. This will @@ -204,10 +197,6 @@ is required for IPv6 operation. You should also specify an ethernet interface to bind to this multicast address using the -i option. .TP -.I -i -Used in conjunction with -m above to specify the interface for -multicast to use. -.TP .I -w Join and wait until the node is a cluster member. .TP @@ -222,8 +211,26 @@ command without -w followed by .B cman_tool wait. .TP +.I -k +All traffic sent out by cman/openais is encrypted. By default the security key +used is simply the cluster name. If you need more security you can specify a +key file that contains the key used to encrypt cluster communications. +Of course, the contents of the key file must be the same on all nodes in the +cluster. It is up to you to securely copy the file to the nodes. +.TP .I -t If -w or -q is also specified then -t dictates the maximum amount of time cman_tool is prepared to wait. If the operation times out then a status of 2 is returned. Note that just because cman_tool has given up, does not mean that cman itself has stopped trying to join a cluster. +.br +.SH "NODES" OPTIONS +.TP +.I -f +Shows the date/time the node was last fenced (if it has bee fenced), and also +the fence system that was used. +.br +.TP +.I -a +Shows the IP address(es) the nodes are communicating on. +