[Cluster-devel] cluster/cman/man qdisk.5

[Cluster-devel] cluster/cman/man qdisk.5

[lhh]

CVSROOT:	/cvs/cluster
Module name:	cluster
Changes by:	lhh at sourceware.org	2006-10-03 18:07:59

Modified files:
	cman/man       : qdisk.5 

Log message:
	Fix #208577

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/cman/man/qdisk.5.diff?cvsroot=cluster&r1=1.2&r2=1.3

--- cluster/cman/man/qdisk.5	2006/07/21 17:55:04	1.2
+++ cluster/cman/man/qdisk.5	2006/10/03 18:07:58	1.3
@@ -236,6 +236,13 @@
 is the sum-total of all of defined heuristics' \fIscore\fP attribute.
 
 .in 9
+\fIreboot\fP\fB="\fP1\fB"\fP
+.in 12
+If set to 0 (off), qdiskd will *not* reboot after a negative transition
+as a result in a change in score (see section 2.2).  The default for
+this value is 1 (on).
+
+.in 9
 \fIdevice\fP\fB="\fP/dev/sda1\fB"\fP
 .in 12
 This is the device the quorum daemon will use.  This device must be the

[Cluster-devel] cluster/cman/man qdisk.5

[lhh]

CVSROOT:	/cvs/cluster
Module name:	cluster
Branch: 	RHEL5
Changes by:	lhh at sourceware.org	2007-01-26 21:12:39

Modified files:
	cman/man       : qdisk.5 

Log message:
	Man page update.

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/cman/man/qdisk.5.diff?cvsroot=cluster&only_with_tag=RHEL5&r1=1.3.2.1&r2=1.3.2.2

--- cluster/cman/man/qdisk.5	2007/01/22 22:50:12	1.3.2.1
+++ cluster/cman/man/qdisk.5	2007/01/26 21:12:39	1.3.2.2
@@ -294,6 +294,16 @@
 disconnected from the SAN.  The default for this value is 0 (off).
 
 .in 9
+\fIuse_uptime\fP\fB="\fP1\fB"\fP
+.in 12
+If this parameter is set to 1 (on), qdiskd will use values from
+/proc/uptime for internal timings.  This is a bit less precise
+than \fBgettimeofday(2)\fP, but the benefit is that changing the 
+system clock will not affect qdiskd's behavior - even if \fBparanoid\fP
+is enabled.  If set to 0, qdiskd will use \fBgettimeofday(2)\fP, which
+is more precise.  The default for this value is 1 (on / use uptime).
+
+.in 9
 \fIdevice\fP\fB="\fP/dev/sda1\fB"\fP
 .in 12
 This is the device the quorum daemon will use.  This device must be the
@@ -412,4 +422,4 @@
 for more details.
 
 .SH "SEE ALSO"
-mkqdisk(8), qdiskd(8), cman(5), syslog.conf(5)
+mkqdisk(8), qdiskd(8), cman(5), syslog.conf(5), gettimeofday(2)

[Cluster-devel] cluster/cman/man qdisk.5

[lhh]

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

[Cluster-devel] cluster/cman/man qdisk.5

[lhh]

CVSROOT:	/cvs/cluster
Module name:	cluster
Branch: 	RHEL4
Changes by:	lhh at sourceware.org	2007-11-14 17:14:21

Modified files:
	cman/man       : qdisk.5 

Log message:
	Clarify qdisk man page some

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/cman/man/qdisk.5.diff?cvsroot=cluster&only_with_tag=RHEL4&r1=1.1.2.5&r2=1.1.2.6

--- cluster/cman/man/qdisk.5	2007/03/20 19:36:14	1.1.2.5
+++ cluster/cman/man/qdisk.5	2007/11/14 17:14:21	1.1.2.6
@@ -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

[Cluster-devel] cluster/cman/man qdisk.5

[fabbione]

CVSROOT:	/cvs/cluster
Module name:	cluster
Changes by:	fabbione at sourceware.org	2008-02-12 06:18:16

Modified files:
	cman/man       : qdisk.5 

Log message:
	Clean up qdisk man page.
	
	-\fB...>\fP is not a keyword (starts the line with .)
	
	make the man page more consistent with use of />

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/cman/man/qdisk.5.diff?cvsroot=cluster&r1=1.8&r2=1.9

--- cluster/cman/man/qdisk.5	2008/01/02 11:48:53	1.8
+++ cluster/cman/man/qdisk.5	2008/02/12 06:18:16	1.9
@@ -331,7 +331,7 @@
 same on all nodes.
 
 .in 9
-\fIlabel\fP\fB="\fPmylabel\fB"/>\fP
+\fIlabel\fP\fB="\fPmylabel\fB"\fP
 .in 12
 This overrides the device field if present.  If specified, the quorum
 daemon will read /proc/partitions and check for qdisk signatures
@@ -339,7 +339,7 @@
 label.  This is useful in configurations where the block device name
 differs on a per-node basis.
 .in 8
-\fB...>\fP
+\fB/>\fP
 .in 0
 
 .SH "3.2.  The <heuristic> tag"
@@ -362,14 +362,14 @@
 for heuristics.  The default score for each heuristic is 1.
 
 .in 9
-\fIinterval\fP\fB="\fP2\fB"/>\fP
+\fIinterval\fP\fB="\fP2\fB"\fP
 .in 12
 This is the frequency (in seconds) at which we poll the heuristic.  The
 default interval for every heuristic is 2 seconds.
 .in 0
 
 .in 9
-\fItko\fP\fB="\fP1\fB"/>\fP
+\fItko\fP\fB="\fP1\fB"\fP
 .in 12
 After this many failed attempts to run the heuristic, it is considered DOWN,
 and its score is removed.  The default tko for each heuristic is 1, which