January 2010 - cluster-commits - Fedora Mailing-Lists

cluster: STABLE3 - man pages: gfs_control

by David Teigland

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: 5aae1bf1cf055e8042893701a860284b6dedd3a9 Parent: 90b5478da0d480d0e95900ab191f6c2904bb677f Author: David Teigland <teigland(a)redhat.com> AuthorDate: Wed Jan 20 15:10:58 2010 -0600 Committer: David Teigland <teigland(a)redhat.com> CommitterDate: Wed Jan 20 15:14:04 2010 -0600 man pages: gfs_control new man page for cluster3 Signed-off-by: David Teigland <teigland(a)redhat.com> --- group/man/Makefile | 1 + group/man/gfs_control.8 | 44 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 45 insertions(+), 0 deletions(-) diff --git a/group/man/Makefile b/group/man/Makefile index a317fba..70387c3 100644 --- a/group/man/Makefile +++ b/group/man/Makefile @@ -1,6 +1,7 @@ MANTARGET= \ dlm_controld.8 \ gfs_controld.8 \ + gfs_control.8 \ group_tool.8 \ groupd.8 diff --git a/group/man/gfs_control.8 b/group/man/gfs_control.8 new file mode 100644 index 0000000..8dfd5eb --- /dev/null +++ b/group/man/gfs_control.8 @@ -0,0 +1,44 @@ +.TH GFS_CONTROL 8 2009-01-20 cluster cluster + +.SH NAME +gfs_control \- a utility for the gfs_controld daemon + +.SH SYNOPSIS +.B gfs_control +[COMMAND] [OPTIONS] +[ +.I name +] + +.SH DESCRIPTION +.TP +.B ls +Display internal gfs_controld state about mount groups. + +.TP +.B dump +Dump gfs_controld debug buffer. + +.TP +.BI plocks " name" +Dump posix locks from gfs_controld for the mount group. +(For compat mode, otherwise see +.BR dlm_tool (8).) + +.SH OPTIONS +.TP +.B \-n +Show all node information in ls. + +.TP +.B \-h +Print a help message describing available options, then exit. + +.TP +.B \-V +Print program version information, then exit. + +.SH SEE ALSO +.BR gfs_controld (8), +.BR dlm_tool (8) +

14 years, 4 months

1
0
0 / 0

cluster: STABLE3 - config: Fix license for value-list.[ch]

by Lon Hohberger

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: 90b5478da0d480d0e95900ab191f6c2904bb677f Parent: 0c9903e2742bef7fe9934cccdc630412861c090f Author: Lon Hohberger <lhh(a)redhat.com> AuthorDate: Wed Jan 20 13:32:21 2010 -0500 Committer: Lon Hohberger <lhh(a)redhat.com> CommitterDate: Wed Jan 20 13:36:24 2010 -0500 config: Fix license for value-list.[ch] I authored these files. They were improperly licensed. As of this commit, these files are now licensable under GPL version 2 or, at the licensee's option, any later version as published by the Free Software Foundation. Signed-off-by: Lon Hohberger <lhh(a)redhat.com> --- config/tools/ldap/rng2ldif/value-list.c | 1 - config/tools/ldap/rng2ldif/value-list.h | 1 - 2 files changed, 0 insertions(+), 2 deletions(-) diff --git a/config/tools/ldap/rng2ldif/value-list.c b/config/tools/ldap/rng2ldif/value-list.c index d8b0e84..1de9181 100644 --- a/config/tools/ldap/rng2ldif/value-list.c +++ b/config/tools/ldap/rng2ldif/value-list.c @@ -1,4 +1,3 @@ -/** License: GPLv2 */ #include <stdio.h> #include <stdlib.h> #include <assert.h> diff --git a/config/tools/ldap/rng2ldif/value-list.h b/config/tools/ldap/rng2ldif/value-list.h index 4e83e08..2e43326 100644 --- a/config/tools/ldap/rng2ldif/value-list.h +++ b/config/tools/ldap/rng2ldif/value-list.h @@ -1,4 +1,3 @@ -/** License: GPLv2 */ #ifndef _VALUE_LIST_H #define _VALUE_LIST_H

14 years, 4 months

1
0
0 / 0

cluster: RHEL4 - fence_ilo: Add power-wait option to solve ilo2 v1.70 problem

by Marek Grác

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: 97831cc57da79f145c9725a2a79a27f8ff45de4f Parent: 18411e7ca35ad8b970bb57192c89ef2b067c8432 Author: Marek 'marx' Grac <mgrac(a)redhat.com> AuthorDate: Wed Jan 20 18:56:11 2010 +0100 Committer: Marek 'marx' Grac <mgrac(a)redhat.com> CommitterDate: Wed Jan 20 18:56:11 2010 +0100 fence_ilo: Add power-wait option to solve ilo2 v1.70 problem Default behaviour was not changed, it is possible to use -G <seconds>. ilo2 v1.70+ problem can be solved with '-G 5' rhbz#545682 --- fence/agents/ilo/fence_ilo.py | 2 +- fence/agents/lib/fencing.py.py | 6 ++++++ 2 files changed, 7 insertions(+), 1 deletions(-) diff --git a/fence/agents/ilo/fence_ilo.py b/fence/agents/ilo/fence_ilo.py index 6513e2a..8a34fb0 100755 --- a/fence/agents/ilo/fence_ilo.py +++ b/fence/agents/ilo/fence_ilo.py @@ -57,7 +57,7 @@ def set_power_status(conn, options): def main(): device_opt = [ "help", "version", "agent", "quiet", "verbose", "debug", "action", "ipaddr", "login", "passwd", "passwd_script", - "ssl", "ribcl" ] + "ssl", "ribcl", "power_wait" ] options = check_input(device_opt, process_input(device_opt)) diff --git a/fence/agents/lib/fencing.py.py b/fence/agents/lib/fencing.py.py index 1b9221a..086b4e1 100644 --- a/fence/agents/lib/fencing.py.py +++ b/fence/agents/lib/fencing.py.py @@ -151,6 +151,10 @@ all_opt = { "getopt" : "s:", "help" : "-s <id> Name of the managed system", "order" : 1 }, + "power_wait" : { + "getopt" : "G:", + "help" : "-G <seconds> Wait X seconds after issuing ON/OFF", + "order" : 1 }, "test" : { "getopt" : "T", "help" : "", @@ -395,6 +399,8 @@ def fence_action(tn, options, set_power_fn, get_power_fn): set_power_fn(tn, options) if wait_power_status(tn, options, get_power_fn) == 0: fail(EC_WAITING_OFF) + if options.has_key("-G"): + time.sleep(int(options["-G"])) options["-o"] = "on" set_power_fn(tn, options) if wait_power_status(tn, options, get_power_fn) == 0:

14 years, 4 months

1
0
0 / 0

cluster: STABLE3 - man pages: dlm_tool

by David Teigland

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: 0c9903e2742bef7fe9934cccdc630412861c090f Parent: d69d9c88d9232b833ef6864a48f1e1281dc7fb31 Author: David Teigland <teigland(a)redhat.com> AuthorDate: Wed Jan 20 10:56:48 2010 -0600 Committer: David Teigland <teigland(a)redhat.com> CommitterDate: Wed Jan 20 10:56:48 2010 -0600 man pages: dlm_tool update for cluster3 Signed-off-by: David Teigland <teigland(a)redhat.com> --- dlm/man/dlm_tool.8 | 97 ++++++++++++++++++++++++++++++++++++++++----------- 1 files changed, 76 insertions(+), 21 deletions(-) diff --git a/dlm/man/dlm_tool.8 b/dlm/man/dlm_tool.8 index 57e3da3..5e61567 100644 --- a/dlm/man/dlm_tool.8 +++ b/dlm/man/dlm_tool.8 @@ -1,39 +1,94 @@ -.TH dlm_tool 8 +.TH DLM_TOOL 8 2009-01-20 cluster cluster .SH NAME -dlm_tool - A program to join and leave lockspaces and display dlm information +dlm_tool \- a utility for the dlm and dlm_controld daemon .SH SYNOPSIS -.B -dlm_tool -[\fIOPTIONS\fR] -<\fBjoin | leave | lockdump | deadlock_check\fP> -<\fBname\fP> +.B dlm_tool +[COMMAND] [OPTIONS] +[ +.I name +] .SH DESCRIPTION +.TP +.B ls +Display internal dlm_controld state about lockspaces. + +.TP +.B dump +Dump dlm_controld debug buffer. + +.TP +.BI plocks " name" +Dump posix locks from dlm_controld for the lockspace. + +.TP +.BI lockdump " name" +Minimal display of locks from the lockspace. -\fBdlm_tool\fP is a program used to join or leave dlm lockspaces, dump -dlm lock state, and initiate deadlock detection cycles. The name of a -lockspace follows the subcommand. +.TP +.BI lockdebug " name" +Extended display of locks from the lockspace. + +.TP +.BI join " name" +Join a lockspace. + +.TP +.BI leave " name" +Leave a lockspace. + +.TP +.BI deadlock_check " name" +Start a deadlock detection cycle for the lockspace. .SH OPTIONS .TP -\fB-m\fP -The permission mode (in octal) of the lockspace device created by join; -default 0600. +.B \-n +Show all node information in ls. + +.TP +.BI \-d " num" +Resource directory enabled (1) or disabled (0) during join. Default 0. + +.TP +.BI \-e " num" +Exclusive create off/on (0/1) in join. Default 0. + +.TP +.BI \-f " num" +FS memory allocation off/on (0/1) in join. Default 0. + +.TP +.BI \-m " mode" +The permission mode (in octal) of the lockspace device created by join. +Default 0600. + .TP -\fB-M\fP +.B \-M Dump MSTCPY locks in addition to locks held by local processes. + +.TP +.B \-s +Summary following lockdebug output (experimental, format may change). + .TP -\fB-d\fP <num> -Resource directory enabled (1) or disabled (0) during join; default 0. +.B \-v +Verbose lockdebug output. + .TP -\fB-h\fP -Help. Print out the usage syntax. +.B \-w +Wide lockdebug output. + +.TP +.B \-h +Print a help message describing available options, then exit. + .TP -\fB-V\fP -Print version information. +.B \-V +Print program version information, then exit. .SH SEE ALSO -libdlm(3) +.BR dlm_controld (8)

14 years, 4 months

1
0
0 / 0

cluster: STABLE3 - cluster.rng: fence, fencedevices

by David Teigland

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: d69d9c88d9232b833ef6864a48f1e1281dc7fb31 Parent: cc431ee8d9a938b1e909b7f7ac7fa780204a6888 Author: David Teigland <teigland(a)redhat.com> AuthorDate: Tue Jan 19 17:08:24 2010 -0600 Committer: David Teigland <teigland(a)redhat.com> CommitterDate: Tue Jan 19 17:08:24 2010 -0600 cluster.rng: fence, fencedevices update, add descriptions Signed-off-by: David Teigland <teigland(a)redhat.com> --- config/tools/xml/cluster.rng.in | 62 +++++++++++++++++++-------------------- 1 files changed, 30 insertions(+), 32 deletions(-) diff --git a/config/tools/xml/cluster.rng.in b/config/tools/xml/cluster.rng.in index 5ffb8be..56da7bc 100644 --- a/config/tools/xml/cluster.rng.in +++ b/config/tools/xml/cluster.rng.in @@ -726,27 +726,20 @@ To validate your cluster.conf against this schema, run:  <optional> - <element name="fencedevices" rha:description="This element and its - attributes define the fence devices in the cluster. Parameters - vary according to the type of fence device. For example, for a - power controller used as a fence device, the cluster configuration - defines the name of the power controller, its IP address, login, - and password."> + <element name="fencedevices" rha:description="Contains all fence + device definitions. fenced(8)"> <zeroOrMore> - <element name="fencedevice" rha:description="The fencedevice element - and its attributes define each fence device in a - cluster. Parameters for each fence device vary according to the - type of fence device."> - <attribute name="name" rha:description="This is a reference - name that you assign to a fence device. It is specific to a - cluster configuration file. It is required - when configuring a fence method for a node (refer - to the method and device elements in the clusternode - element)." rha:sample="apc_123"> + <element name="fencedevice" rha:description="Defines fence device + properties. fenced(8)"> + + <attribute name="name" rha:description="A name that is used to + reference this fence device from clusternode fence section. + fenced(8)"> <data type="ID"/> </attribute> - <attribute name="agent" rha:description="Specifies a fence agent to - be used." rha:sample="fence_apc"/> + + <attribute name="agent" rha:description="The fence agent to be + used. fenced(8)"/> <ref name="FENCEDEVICEOPTIONS"/> @@ -1973,28 +1966,30 @@ To validate your cluster.conf against this schema, run:  <define name="FENCE"> - <element name="fence" rha:description="The fence element specifies how - a node is fenced. Its elements and attributes identify fence device - (or devices) to use and the parameters specific to each fence device - (for example, IP address and port number in an APC fence device)"> + <element name="fence" rha:description="Contains methods for fencing + the node in different ways. fenced(8)"> + <zeroOrMore> - <element name="method" rha:description="Typically, there is a single - method used to fence each node (the name given to the method is - not significant). A method refers to a specific device listed in - the fencedevices section (a separate section from the clusternode - section), and then lists any node-specific parameters related - to using the device."> - <attribute name="name" rha:description="" rha:sample="apc123"/> + + <element name="method" rha:description="Contains one or more devices + for fencing the node a single way. fenced(8)"> + + <attribute name="name" rha:description="A name used to distinguish + multiple methods from each other. fenced(8)"/> + <zeroOrMore> <ref name="DEVICE"/> </zeroOrMore> + </element> + </zeroOrMore> </element> </define> <define name="UNFENCE"> - <element name="unfence" rha:description=""> + <element name="unfence" rha:description="Contains devices for unfencing + the node. fence_node(8)"> <zeroOrMore> <ref name="DEVICE"/> </zeroOrMore> @@ -2002,8 +1997,11 @@ To validate your cluster.conf against this schema, run: </define> <define name="DEVICE"> - <element name="device" rha:description=""> - <attribute name="name" rha:description="" rha:sample=""> + <element name="device" rha:description="Defines the properties of a + device used for fencing or unfencing a node. fenced(8)"> + + <attribute name="name" rha:description="The name of a fencedevice + defined in the fencedevices section. fenced(8)"> <data type="IDREF"/> </attribute>

14 years, 4 months

1
0
0 / 0

cluster: STABLE3 - cluster.rng: gfs_controld

by David Teigland

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: cc431ee8d9a938b1e909b7f7ac7fa780204a6888 Parent: d2e531f807ab90306b2f5865086700f802085256 Author: David Teigland <teigland(a)redhat.com> AuthorDate: Tue Jan 19 16:28:33 2010 -0600 Committer: David Teigland <teigland(a)redhat.com> CommitterDate: Tue Jan 19 16:28:33 2010 -0600 cluster.rng: gfs_controld update descriptions Signed-off-by: David Teigland <teigland(a)redhat.com> --- config/tools/xml/cluster.rng.in | 59 ++++++++++++++++++--------------------- 1 files changed, 27 insertions(+), 32 deletions(-) diff --git a/config/tools/xml/cluster.rng.in b/config/tools/xml/cluster.rng.in index 1fab8a6..5ffb8be 100644 --- a/config/tools/xml/cluster.rng.in +++ b/config/tools/xml/cluster.rng.in @@ -521,54 +521,49 @@ To validate your cluster.conf against this schema, run:  <optional> - <element name="gfs_controld" rha:description="This element and its - attributes configure the gfs_controld daemon."> + <element name="gfs_controld" rha:description="Configuration for + gfs_controld daemon. gfs_controld(8)"> + <optional> - <attribute name="enable_withdraw" rha:description="Enable the code that - handles gfs withdraw." rha:default="1" rha:sample="0"/> + <attribute name="enable_withdraw" rha:description="Set to 1/0 to + enable/disable a response to a withdraw. gfs_controld(8)"/> </optional> + <optional> - <attribute name="enable_plock" rha:description="Enable posix lock code for - cluster fs. gfs_controld only handles plocks when daemons run in compat - mode, otherwise dlm_controld processes plocks." rha:default="1" - rha:sample="0"/> + <attribute name="enable_plock" rha:description="Cluster fs posix + lock capability. gfs_controld(8)"/> </optional> + <optional> - <attribute name="plock_debug" rha:description="Enable posix lock - debugging." rha:default="0" rha:sample="1"/> + <attribute name="plock_debug" rha:description="Set to 1 to enable + posix lock debugging. gfs_controld(8)"/> </optional> + <optional> - <attribute name="plock_rate_limit" rha:description="The maximum - number of plock operations that will be sent every second. This is - used to prevent potentially excessive network load. For best - performance it is recommended to disable this rate limiting by - setting the value to 0." rha:sample="10000" rha:default="100"/> + <attribute name="plock_rate_limit" rha:description="Limit the rate of + plock operations. gfs_controld(8)"/> </optional> + <optional> - <attribute name="plock_ownership" rha:description="Enabling this - option by setting to 1 optimizes plock performance for repeated - locking of the same locks by processes on a single node. - All gfs_controld daemons in the cluster must be stopped before - changing this value." rha:sample="1" rha:default="0"/> + <attribute name="plock_ownership" rha:description="Set to 1/0 to + enable/disable plock ownership. gfs_controld(8)"/> </optional> + <optional> - <attribute name="drop_resources_time" rha:description="For tuning the - plock_ownership resource caching. This is the frequence of - attempts in milliseconds to drop unused resources from the - cache." rha:sample="5000" rha:default="10000"/> + <attribute name="drop_resources_time" rha:description="Plock ownership + drop resources time. gfs_controld(8)"/> </optional> + <optional> - <attribute name="drop_resources_count" rha:description="For tuning - the plock_ownership resource caching. This is the maximum number - of resources to drop from the cache each time." rha:sample="100" - rha:default="10"/> + <attribute name="drop_resources_count" rha:description="Plock ownership + drop resources count. gfs_controld(8)"/> </optional> + <optional> - <attribute name="drop_resources_age" rha:description="For tuning the - plock_ownership resource caching. This is the time in milliseconds - that a cached resource should be unused before consideration for - dropping." rha:sample="5000" rha:default="10000"/> + <attribute name="drop_resources_age" rha:description="Plock ownership + drop resources age. gfs_controld(8)"/> </optional> + </element> </optional>

14 years, 4 months

1
0
0 / 0

cluster: STABLE3 - man pages: gfs_controld

by David Teigland

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: d2e531f807ab90306b2f5865086700f802085256 Parent: 468599b3a4cd67fd41082ae9418f6de51f018d74 Author: David Teigland <teigland(a)redhat.com> AuthorDate: Tue Jan 19 16:21:49 2010 -0600 Committer: David Teigland <teigland(a)redhat.com> CommitterDate: Tue Jan 19 16:21:49 2010 -0600 man pages: gfs_controld update for cluster3 Signed-off-by: David Teigland <teigland(a)redhat.com> --- group/man/gfs_controld.8 | 236 +++++++++++++++++++++++++++++----------------- 1 files changed, 149 insertions(+), 87 deletions(-) diff --git a/group/man/gfs_controld.8 b/group/man/gfs_controld.8 index 3d053ee..8e47c89 100644 --- a/group/man/gfs_controld.8 +++ b/group/man/gfs_controld.8 @@ -1,122 +1,184 @@ -.TH gfs_controld 8 +.TH GFS_CONTROLD 8 2009-01-19 cluster cluster .SH NAME -gfs_controld - daemon that manages mounting, unmounting, recovery and -posix locks +gfs_controld \- daemon that coordinates gfs mounts and recovery .SH SYNOPSIS -.B -gfs_controld -[\fIOPTION\fR]... - +.B gfs_controld +[OPTIONS] .SH DESCRIPTION -GFS lives in the kernel, and the cluster infrastructure (cluster -membership and group management) lives in user space. GFS in the kernel -needs to adjust/recover for certain cluster events. It's the job of -gfs_controld to receive these events and reconfigure gfs as needed. +GFS lives in the kernel, and the cluster infrastructure (corosync +membership and group management) lives in user space. GFS in the +kernel needs to adjust/recover for certain cluster events. It's the job +of gfs_controld to receive these events and reconfigure gfs as needed. gfs_controld controls and configures gfs through sysfs files that are -considered gfs-internal interfaces; not a general API/ABI. - -Mounting, unmounting and node failure are the main cluster events that -gfs_controld controls. It also manages the assignment of journals to -different nodes. The mount.gfs and umount.gfs programs communicate with -gfs_controld to join/leave the mount group and receive the necessary -options for the kernel mount. - -GFS also sends all posix lock operations to gfs_controld for processing. -gfs_controld manages cluster-wide posix locks for gfs and passes results -back to gfs in the kernel. +considered gfs-internal interfaces. -.SH CONFIGURATION FILE +Mounting and node failure are the main cluster events that gfs_controld +controls. It also manages the assignment of journals to different nodes. +.BR mount.gfs2 (8) +communicates with gfs_controld to join the mount group and receive the +necessary options for the kernel mount. -Optional cluster.conf settings are placed in the <gfs_controld> section. +The cman init script usually starts the gfs_controld daemon. -.SS Posix locks - -Heavy use of plocks can result in high network load. The rate at which -plocks are processed are limited by the -.I plock_rate_limit -setting, which limits the maximum plock performance, and limits potentially -excessive network load. This value is the maximum number of plock operations -a single node will process every second. To achieve maximum posix locking -performance, the rate limiting should be disabled by setting it to 0. The -default value is 100. +.SH OPTIONS +Command line options override a corresponding setting in cluster.conf. - <gfs_controld plock_rate_limit="100"/> +.TP +.B \-D +Enable debugging to stderr and don't fork. +.br +See also +.B gfs_control dump +in +.BR gfs_control (8). -To optimize performance for repeated locking of the same locks by -processes on a single node, -.I plock_ownership -can be set to 1. The default is 0. If this is enabled, gfs_controld -cannot interoperate with older versions that did not support this option. +.TP +.B \-L +Enable debugging to log file. +.br +See also +.B logging +in +.BR cluster.conf (5). - <gfs_controld plock_ownership="1"/> +.TP +.BI \-g " num" +groupd compatibility mode, 0 off, 1 on. +.br +Default 0. -Three options can be used to tune the behavior of the plock_ownership -optimization. All three relate to the caching of lock ownership state. -Specifically, they define how aggressively cached ownership state is dropped. -More caching of ownership state can result in better performance, at the -expense of more memory usage. +.TP +.BI \-w " num" +Enable (1) or disable (0) withdraw. +.br +Default 1. -.I drop_resources_time -is the frequency of drop attempts in milliseconds. Default 10000 (10 sec). +.TP +.B \-h +Print a help message describing available options, then exit. -.I drop_resources_count -is the maximum number of items to drop from the cache each time. Default 10. +.TP +.B \-V +Print program version information, then exit. -.I drop_resources_age -is the time in milliseconds a cached item should be unused before being -considered for dropping. Default 10000 (10 sec). +.SS Cluster Upgrading +When performing a rolling upgrade from cluster2 to cluster3, the +gfs_controld daemon runs in cluster2 compatibility mode and processes +posix lock (plock) requests from the dlm to remain compatible with cluster2 +nodes. Otherwise, +.BR dlm_controld (8) +handles plocks. - <gfs_controld drop_resources_time="10000" drop_resources_count="10" - drop_resources_age="10000"/> +.TP +.BI \-p " num" +Enable (1) or disable (0) plock code for cluster fs. +.br +Default 1. +.TP +.BI \-l " num" +Limit the rate of plock operations, 0 for no limit. +.br +Default 0. -.SH OPTIONS .TP -\fB-D\fP -Run the daemon in the foreground and print debug statements to stdout. +.BI \-o " num" +Enable (1) or disable (0) plock ownership. +.br +Default 1. + .TP -\fB-P\fP -Enable posix lock debugging messages. +.BI \-t " ms" +Plock ownership drop resources time (milliseconds). +.br +Default 10000. + .TP -\fB-w\fP -Disable the "withdraw" feature. +.BI \-c " num" +Plock ownership drop resources count. +.br +Default 10. + .TP -\fB-p\fP -Disable posix lock handling. +.BI \-a " ms" +Plock ownership drop resources age (milliseconds). +.br +Default 10000. + .TP -\fB-l\fP <num> -Limit the rate at which posix lock messages are sent to <num> messages per -second. 0 disables the limit and results in the maximum performance of -posix locks. Default 100. +.B \-P +Enable plock debugging messages (can produce excessive output). + +.SH FILES +.BR cluster.conf (5) +is usually located at /etc/cluster/cluster.conf. It is not read directly. +Other cluster components load the contents into memory, and the values are +accessed through the libccs library. + +Configuration options are added to the <gfs_controld /> section of +cluster.conf, within the top level <cluster> section. + .TP -\fB-o\fP <num> -Enable (1) or disable (0) plock ownership optimization. Default 0. All -nodes must run with the same value. +.B enable_withdraw +Set to 1/0 to enable/disable a response to a withdraw. + +<gfs_controld enable_withdraw="1"/> + +.SS Cluster Upgrading +See note above about compatibility plock handling during a rolling +upgrade. The following options are deprecated, see +.BR dlm_controld (8) +for the new equivalent options. + .TP -\fB-t\fP <ms> -Ownership cache tuning, drop resources time (milliseconds). Default 10000. +.B enable_plock +See command line description. + +<gfs_controld enable_plock="1"/> + .TP -\fB-c\fP <ms> -Ownership cache tuning, drop resources count. Default 10. +.B plock_rate_limit +See command line description. + +<gfs_controld plock_rate_limit="0"/> + +.TP +.B plock_ownership +See command line description. + +<gfs_controld plock_ownership="1"/> + .TP -\fB-a\fP <ms> -Ownership cache tuning, drop resources age (milliseconds). Default 10000. +.B drop_resources_time +See command line description. + +<gfs_controld drop_resources_time="10000"/> + .TP -\fB-h\fP -Print out a help message describing available options, then exit. +.B drop_resources_count +See command line description. + +<gfs_controld drop_resources_count="10"/> + .TP -\fB-V\fP -Print the version information and exit. +.B drop_resources_age +See command line description. -.SH DEBUGGING -The gfs_controld daemon keeps a circular buffer of debug messages that can -be dumped with the 'group_tool dump gfs' command. +<gfs_controld drop_resources_age="10000"/> + +.TP +.B plock_debug +Enable (1) or disable (0) plock debugging messages (can produce excessive +output). Default 0. -The state of all gfs posix locks can also be dumped from gfs_controld with -the 'group_tool dump plocks <fsname>' command. +<gfs_controld plock_debug="0"/> .SH SEE ALSO -groupd(8), group_tool(8) +.BR mount.gfs2 (8), +.BR gfs_control (8), +.BR dlm_controld (8), +.BR cman (5), +.BR cluster.conf (5)

14 years, 4 months

1
0
0 / 0

cluster: STABLE3 - cluster.rng: group/groupd_compat

by David Teigland

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: 468599b3a4cd67fd41082ae9418f6de51f018d74 Parent: d02271e8c5f5019c73f3230f9fea3d55c6794b06 Author: David Teigland <teigland(a)redhat.com> AuthorDate: Tue Jan 19 14:41:41 2010 -0600 Committer: David Teigland <teigland(a)redhat.com> CommitterDate: Tue Jan 19 14:42:49 2010 -0600 cluster.rng: group/groupd_compat update description Signed-off-by: David Teigland <teigland(a)redhat.com> --- config/tools/xml/cluster.rng.in | 5 +++-- 1 files changed, 3 insertions(+), 2 deletions(-) diff --git a/config/tools/xml/cluster.rng.in b/config/tools/xml/cluster.rng.in index 824a71d..1fab8a6 100644 --- a/config/tools/xml/cluster.rng.in +++ b/config/tools/xml/cluster.rng.in @@ -575,10 +575,11 @@ To validate your cluster.conf against this schema, run:  <optional> - <element name="group" rha:description=""> + <element name="group" rha:description="Defines groupd configuration. + groupd(8)"> <optional> <attribute name="groupd_compat" rha:description="Enable compatibility with - cluster2 (RHEL5) nodes" rha:default="0" rha:sample="1"/> + cluster2 nodes. groupd(8)"/> </optional> </element> </optional>

14 years, 4 months

1
0
0 / 0

cluster: STABLE3 - man pages: group_tool

by David Teigland

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: d02271e8c5f5019c73f3230f9fea3d55c6794b06 Parent: 1d054600ad7cae95810b93b98167e17504b1b96b Author: David Teigland <teigland(a)redhat.com> AuthorDate: Tue Jan 19 14:37:42 2010 -0600 Committer: David Teigland <teigland(a)redhat.com> CommitterDate: Tue Jan 19 14:42:49 2010 -0600 man pages: group_tool cluster3 update Signed-off-by: David Teigland <teigland(a)redhat.com> --- group/man/group_tool.8 | 134 ++++++++++++++++++++++-------------------------- 1 files changed, 62 insertions(+), 72 deletions(-) diff --git a/group/man/group_tool.8 b/group/man/group_tool.8 index b0c623d..53cd3da 100644 --- a/group/man/group_tool.8 +++ b/group/man/group_tool.8 @@ -1,90 +1,80 @@ -.TH group_tool 8 +.TH GROUP_TOOL 8 2009-01-19 cluster cluster .SH NAME -group_tool - display/dump information about fence, dlm and gfs groups +group_tool \- run common fence_tool, dlm_tool, gfs_control commands .SH SYNOPSIS -.B -group_tool -[\fISUBCOMMAND\fR] [\fIOPTION\fR]... +.B group_tool +[COMMAND] [OPTIONS] .SH DESCRIPTION +This utility is deprecated and the new replacements are shown. See +.BR fence_tool (8), +.BR dlm_tool (8), +.BR gfs_control (8) +man pages for more information about the new commands. -The group_tool program displays information about fence, dlm and gfs groups. - -.SH SUBCOMMANDS - -\fBgroup_tool ls\fP [-n] - - Queries individual daemons, and displays full daemon and group state. - It is a shortcut for: - - fence_tool ls [-n] -.br - dlm_tool ls [-n] -.br - gfs_control ls [-n] - -\fBgroup_tool compat\fP - - Queries groupd about compatibility mode currently running: - - groupd not running -.br - groupd compatibility mode 0 -.br - groupd compatibility mode 1 -.br - groupd compatibility mode 2 (pending) -.br - -\fBgroup_tool dump\fP [gfs|dlm|fence|plocks] [name] - - Dumps debug info from daemons: +.TP +.B ls +runs +.BR "fence_tool ls " ; +.BR "dlm_tool ls " ; +.B gfs_control ls +.TP +.B dump fence +equivalent to new +.B fence_tool dump +.TP +.B dump dlm +equivalent to new +.B dlm_tool dump +.TP +.B dump gfs +equivalent to new +.B gfs_control dump +.TP +.BI "dump plocks" " name" +equivalent to new +.BI "dlm_tool plocks" " name" - group_tool dump gfs: dump gfs_controld debug log -.br - (same as gfs_control dump) -.br - group_tool dump dlm: dump dlm_controld debug log -.br - (same as dlm_tool dump) -.br - group_tool dump fence: dump fenced debug log -.br - (same as fence_tool dump) -.br - group_tool dump plocks <x>: dump plock state -.br - (same as dlm_tool plocks <x>) -.br - group_tool dump: dump groupd debug log -.br +.SS Cluster Uprading +When performing a rolling upgrade from cluster2 to cluster3, the +.BR groupd (8) +daemon will be running and group_tool can be used with groupd like it was in +cluster2. -.SH OPTIONS .TP -\fB-g <num>\fP -Select daemons to query with ls -.br -0: query fenced, dlm_controld, gfs_controld (default) -.br -1: query groupd (for old compat mode) -.br -2: query groupd (1) when in compat mode, otherwise daemons (0) +.B ls \-g1 +queries and displays the internal groupd state. +.TP +.B dump +queries and dumps the groupd debug buffer. .TP -\fB-n\fP -Show all node information (with ls -g0) +.B compat +queries and displays the internal groupd compatibility mode. + +.SH OPTIONS .TP -\fB-v\fP -Show extra event information (with ls -g1) +.BI \-g " num" +Force old groupd queries with 1. +.TP +.B \-n +Show all node information in ls. +.TP +.B \-v +Show verbose information from groupd with ls \-g1. .TP -\fB-V\fP -Print the version information and exit. +.B \-h +Print a help message describing available options, then exit. .TP -\fB-h\fP -Print out a help message describing available options, then exit. +.B \-V +Print program version information, then exit. .SH SEE ALSO -groupd(8), fence_tool(8), dlm_tool(8), gfs_control(8) +.BR cman (5), +.BR groupd (8), +.BR fence_tool (8), +.BR dlm_tool (8), +.BR gfs_control(8)

14 years, 4 months

1
0
0 / 0

cluster: STABLE3 - man pages: fenced

by David Teigland

Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=... Commit: 1d054600ad7cae95810b93b98167e17504b1b96b Parent: 295fae90ef68a9e9d22e5e7f6fff1f72b23f8474 Author: David Teigland <teigland(a)redhat.com> AuthorDate: Tue Jan 19 11:59:35 2010 -0600 Committer: David Teigland <teigland(a)redhat.com> CommitterDate: Tue Jan 19 14:42:49 2010 -0600 man pages: fenced add references to fence_tool dump and <logging> Signed-off-by: David Teigland <teigland(a)redhat.com> --- fence/man/fenced.8 | 10 ++++++++++ 1 files changed, 10 insertions(+), 0 deletions(-) diff --git a/fence/man/fenced.8 b/fence/man/fenced.8 index 03a9bc6..c3496fb 100644 --- a/fence/man/fenced.8 +++ b/fence/man/fenced.8 @@ -114,9 +114,19 @@ Command line options override a corresponding setting in cluster.conf. .TP .B \-D Enable debugging to stderr and don't fork. +.br +See also +.B fence_tool dump +in +.BR fence_tool (8). .TP .B \-L Enable debugging to log file. +.br +See also +.B logging +in +.BR cluster.conf (5). .TP .BI \-g " num" groupd compatibility mode, 0 off, 1 on. Default 0.

14 years, 4 months

1
0
0 / 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

cluster-commits January 2010