| Summary: | DOCS: cman_tool "expected" option is to vague | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Linux 5 | Reporter: | Shane Bradley <sbradley> |
| Component: | cman | Assignee: | Lon Hohberger <lhh> |
| Status: | CLOSED ERRATA | QA Contact: | Cluster QE <mspqa-list> |
| Severity: | low | Docs Contact: | |
| Priority: | low | ||
| Version: | 5.7 | CC: | cluster-maint, djansa, edamato |
| Target Milestone: | rc | Keywords: | ManPageChange |
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | cman-2.0.115-81.el5 | Doc Type: | Bug Fix |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2011-07-21 07:25:54 UTC | Type: | --- |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
expected
Tells CMAN a new value of expected votes and instructs it to
recalculate quorum based on this value.
The recalculation takes into account the number of currently
active nodes, so this option should not be used in an attempt to
artificially lower the quorum value in advance of a planned
shutdown of cluster nodes. Instead, the ’cman_tool leave
remove’ command should be used (see the ’leave’ subcommand
above).
Use this option if your cluster has lost quorum due to nodes
failing and you need to get it running again in a hurry.
Verified in cman-2.0.115-82.el5
An advisory has been issued which should help the problem described in this bug report. This report is therefore being closed with a resolution of ERRATA. For more information on therefore solution and/or where to find the updated files, please follow the link below. You may reopen this bug report if the solution does not work for you. http://rhn.redhat.com/errata/RHBA-2011-1001.html |
Description of problem: The man page for "cman_tool" is to vague for the "expected" option and should contain more detail on the "expected" option. I propose that the current text be replaced with something like this: $ man cman_tool .... SUBCOMMANDS expected Tells CMAN a new value of expected votes and instructs it to recalculate quorum based on this value. The recalculation takes into account the number of currently active nodes, so this option should not be used in an attempt to artificially lower the quorum value in advance of a planned shutdown of cluster nodes. Instead, the 'cman_tool leave remove' command should be used(see the 'leave' subcommand above). Use this option if your cluster has lost quorum due to nodes failing and you need to get it running again in a hurry. Version-Release number of selected component (if applicable): cman-2.0.115-68.el5_6.1 How reproducible: Everytime Steps to Reproduce: 1. Open the man page for cman_tool. Actual results: The man page for cman_tool is to vague for the "expected" option. Expected results: The man page cman_tool should give end user more information about the "expected" option. Additional info: If bug is accepted then this should be cloned to RHEL6 as well since it has the same issue with a vague description of "expected" option.