--- cman.5-orig 2006-12-21 20:01:33.000000000 -0500
+++ cman.5 2006-12-21 20:01:43.000000000 -0500
@@ -1,55 +1,45 @@
.\"
.\" Copyright (C) 2004 Red Hat, Inc. All rights reserved.
-
-.\" groff -t -e -mandoc -Tlatin1 cman.5 | less
-
-.tl 'cman(5)' 'cman(5)'
-
-\fBNAME\fP
-.in +7
-cman - cluster.conf cman configuration section
-.sp
-.in -7
-
-
-\fBDESCRIPTION\fP
-.in +7
+.\"
+.TH cman 5
+.SH NAME
+cman \- cluster.conf cman configuration section
+.SH DESCRIPTION
Cman configuration values are placed in the section of
\fBcluster.conf\fP. Per-node configuration related to cman is placed
in the standard sections. All cman
configuration settings are optional; usually none are used.
-.in -7
-
-\fIUDP port\fR
-.in +7
+.SS IUDP port
By default, cman will use UDP port 6809 for internode communication. This can
be changed by setting a port number as follows:
+.RS
+.nf
-.in -7
-
+.fi
+.RE
-\fIExpected votes\fR
-.in +7
+.SS Expected votes
The expected votes value is used by cman to determine quorum. The cluster is
quorate if the sum of votes of existing members is over half of the expected
votes value. By default, cman_tool sets the expected votes value to be the sum
of votes of all nodes listed in cluster.conf. This can be overriden by setting
an explicit expected_votes value as follows:
+.RS
+.nf
+.fi
+.RE
If the cluster becomes partitioned, improper use of this option can result
in more than one partition gaining quorum. In that event, nodes in each
partition will enable cluster services.
-.in -7
-
-\fITwo node clusters\fR
-.in +7
+.SS Two node clusters
Ordinarily, the loss of quorum after one out of two nodes fails will prevent
the remaining node from continuing (if both nodes have one vote.) Special
configuration options can be set to allow the one remaining node to continue
@@ -57,42 +47,46 @@
can be defined in cluster.conf. The two_node and expected_votes values must
then be set to 1 in the cman section as follows.
+.RS
+.nf
-.in -7
-
+.fi
+.RE
-\fINode votes\fR
-.in +7
+.SS Node votes
By default, a node is given one vote toward the calculation of quorum.
This can be changed by giving a node a specific number of votes as
follows:
+.RS
+.nf
-.in -7
-
-
-\fINode ID\fR
-.in +7
+.fi
+.RE
+.SS Node ID
By default, a node is assigned a nodeid by the cluster manager (cman) when
it joins the cluster. This can be overriden by specifying a nodeid here.
Using this option will ensure that a given node always has the same ID.
A node's application to join the cluster may be rejected if you try to set
the nodeid to one that is already used.
+.RS
+.nf
-.in -7
+.fi
+.RE
-
-\fIMulticast network configuration\fR
-.in +7
+.SS Multicast network configuration
Cman can be configured to use multicast instead of broadcast (broadcast is used
by default if no multicast parameters are given.) To configure multicast add
one line under the section and another under the section:
+.RS
+.nf
@@ -100,15 +94,13 @@
+.fi
+.RE
The multicast addresses must match and the address must be usable on the
interface name given for the node.
-.in -7
-
-
-.sp
-.in -7
-\fBSEE ALSO\fP
-.in +7
-cluster.conf(5), ccs(7), cman_tool(8)
+.SH SEE ALSO
+.BR cluster.conf (5),
+.BR ccs (7),
+.BR cman_tool (8)