From mboxrd@z Thu Jan 1 00:00:00 1970 From: lhh@sourceware.org Date: 14 Nov 2007 16:37:12 -0000 Subject: [Cluster-devel] cluster/cman/man qdisk.5 Message-ID: <20071114163712.15788.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 Branch: RHEL5 Changes by: lhh at sourceware.org 2007-11-14 16:37:12 Modified files: cman/man : qdisk.5 Log message: Fix #317561 - pass 1 Patches: http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/cman/man/qdisk.5.diff?cvsroot=cluster&only_with_tag=RHEL5&r1=1.3.2.4&r2=1.3.2.5 --- cluster/cman/man/qdisk.5 2007/03/20 19:37:04 1.3.2.4 +++ cluster/cman/man/qdisk.5 2007/11/14 16:37:11 1.3.2.5 @@ -1,6 +1,6 @@ -.TH "QDisk" "5" "20 Feb 2007" "" "Cluster Quorum Disk" +.TH "QDisk" "5" "06 Sep 2007" "" "Cluster Quorum Disk" .SH "NAME" -QDisk 1.2 \- a disk-based quorum daemon for CMAN / Linux-Cluster +QDisk 1.2.1 \- a disk-based quorum daemon for CMAN / Linux-Cluster .SH "1. Overview" .SH "1.1 Problem" In some situations, it may be necessary or desirable to sustain @@ -73,7 +73,8 @@ * Cluster node IDs must be statically configured in cluster.conf and must be numbered from 1..16 (there can be gaps, of course). -* Cluster node votes should be more or less equal. +* Cluster nodes must have one vote each. The effects of nodes having +any number of votes besides 1 has not been explored. * CMAN must be running before the qdisk program can operate in full capacity. If CMAN is not running, qdisk will wait for it. @@ -83,10 +84,10 @@ failure + load spike situation. * For 'all-but-one' failure operation, the total number of votes assigned -to the quorum device should be equal to or greater than the total number -of node-votes in the cluster. While it is possible to assign only one -(or a few) votes to the quorum device, the effects of doing so have not -been explored. +to the quorum device should be equal to the number of nodes in the cluster +minus 1. For example, if you have 3 nodes in the cluster, each node should +get one vote and qdisk should get 2 votes. This then lets the cluster +operate without qdisk if all nodes are online for testing and other purposes. * For 'tiebreaker' operation in a two-node cluster, unset CMAN's two_node flag (or set it to 0), set CMAN's expected votes to '3', set each node's @@ -338,6 +339,13 @@ on every block device found, comparing the label against the specified label. This is useful in configurations where the block device name differs on a per-node basis. + +.in 9 +\fIcman_label\fP\fB="\fPmylabel\fB"/>\fP +.in 12 +This overrides the label advertised to CMAN if present. If specified, +the quorum daemon will register with this name instead of the actual +device name. .in 8 \fB...>\fP .in 0