From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 12778 invoked by alias); 24 Sep 2008 18:05:36 -0000 Received: (qmail 12770 invoked by alias); 24 Sep 2008 18:05:35 -0000 X-Spam-Status: No, hits=-0.4 required=5.0 tests=AWL,BAYES_20,KAM_MX,SPF_HELO_PASS X-Spam-Check-By: sourceware.org X-Spam-Checker-Version: SpamAssassin 3.2.4 (2008-01-01) on bastion.fedora.phx.redhat.com X-Spam-Level: Subject: master - rgmanager: Fix up clusvcadm.8 manual page to show -M option To: cluster-cvs-relay@redhat.com X-Project: Cluster Project X-Git-Module: cluster.git X-Git-Refname: refs/heads/master X-Git-Reftype: branch X-Git-Oldrev: 0bdab80b760ea52742cb144c53f4c212d2b7c184 X-Git-Newrev: 54f8ddf3eeef81f704c191c272706e69301f5134 From: Lon Hohberger Message-Id: <20080924175655.3DA5712042F@lists.fedorahosted.org> Date: Wed, 24 Sep 2008 18:06:00 -0000 X-Scanned-By: MIMEDefang 2.58 on 172.16.52.254 Mailing-List: contact cluster-cvs-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Post: List-Help: , Sender: cluster-cvs-owner@sourceware.org X-SW-Source: 2008-q3/txt/msg00520.txt.bz2 Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=54f8ddf3eeef81f704c191c272706e69301f5134 Commit: 54f8ddf3eeef81f704c191c272706e69301f5134 Parent: 0bdab80b760ea52742cb144c53f4c212d2b7c184 Author: Lon Hohberger AuthorDate: Wed Sep 3 11:49:45 2008 -0400 Committer: Lon Hohberger CommitterDate: Wed Sep 24 13:40:34 2008 -0400 rgmanager: Fix up clusvcadm.8 manual page to show -M option rhbz#460032 --- rgmanager/man/clusvcadm.8 | 38 +++++++++++++++++++++++++------------- 1 files changed, 25 insertions(+), 13 deletions(-) diff --git a/rgmanager/man/clusvcadm.8 b/rgmanager/man/clusvcadm.8 index 155ac88..d1435ef 100644 --- a/rgmanager/man/clusvcadm.8 +++ b/rgmanager/man/clusvcadm.8 @@ -18,10 +18,12 @@ clusvcadm \- Cluster User Service Administration Utility .B [\-r .I .B ] -.B [\-S] .B [\-R .I .B ] +.B [\-M +.I +.B ] .B [\-Z .I .B ] @@ -52,11 +54,20 @@ Enables and starts the user service named .I service .IP \-l -Lock the local resource group manager. This should only be used if the -administrator intends to perform a global, cluster-wide shutdown. This -prevents starting resource groups on the local node, allowing -services will not fail over during the shutdown of the cluster. -Once the cluster quorum is dissolved, this state is reset. +Lock services in preparation for cluster shutdown. This should only +be used if the administrator intends to perform a global, cluster +wide shutdown. This prevents services from starting (but not stopping, +like +.B -Z +does). Once the cluster quorum is dissolved, this state is reset. +If a new instance of rgmanager boots while others are locked, the +behavior is undefined. +.IP \-u +Unlock resource group managers. This allows services to start again. +.IP "\-S" +Display whether the resource group managers are locked or not. This +can be used to verify the correct operation of the \fB-l\fR and \fB-u\fR +options, but is only useful for debugging. .IP "\-m " When used in conjunction with either the .B @@ -79,6 +90,14 @@ Restarts the user service named .I service on the cluster member on which it is currently running. +.IP "\-M " +Use a special "migration" operation to move the user service named +.I +service +to another cluster member. Currently, this is only useful for +virtual machines. Use of migration usually requires special +configuration of the local virtual machine manager in order +to work correctly. .IP "\-Z " Freezes the service named .I @@ -92,18 +111,11 @@ Unfreezes the user service named service on the cluster member on which it is currently running. This will re-enable status checks. -.IP "\-S" -Display whether each of the active service managers is locked or not. This -can be used to verify the correct operation of the \fB-l\fR and \fB-u\fR -options, but is only useful for debugging. .IP "\-s " Stops the service named .I service until a member transition or until it is enabled again. -.IP \-u -Unlock the cluster's service managers. This allows services to transition -again. .IP \-v Display version information and exit.