From 01d364e86e8f83fb12822ff4480d03bf9b85e4c2 Mon Sep 17 00:00:00 2001
From: Alan Conway <aconway@apache.org>
Date: Mon, 28 Apr 2014 19:20:27 +0000
Subject: NO-JIRA: HA documentation update, not on importance of "chkconfig
 qpidd off"

git-svn-id: https://svn.apache.org/repos/asf/qpid/branches/0.28@1590753 13f79535-47bb-0310-9956-ffa450edef68
---
 .../book/src/cpp-broker/Active-Passive-Cluster.xml | 25 +++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml b/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml
index 116fd8daef..8430cda061 100644
--- a/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml
+++ b/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml
@@ -402,13 +402,36 @@ ssl_addr = "ssl:" host [":" port]'
   </section>
 
   <section id="ha-rm-config">
-    <title>Configuring <command>rgmanager</command> as resource manager</title>
+    <title>Configuring with <command>rgmanager</command> as resource manager</title>
     <para>
       This section assumes that you are already familiar with setting up and configuring
       clustered services using <command>cman</command> and
       <command>rgmanager</command>. It will show you how to configure an active-passive,
       hot-standby <command>qpidd</command> HA cluster with <command>rgmanager</command>.
     </para>
+    <note>
+      <para>
+	Once all components are installed it is important to take the following step:
+	<programlisting>
+	  chkconfig rgmanager on
+	  chkconfig cman on
+	  chkconfig qpidd <emphasis>off</emphasis>
+	</programlisting>
+      </para>
+      <para>
+	The qpidd service must be <emphasis>off</emphasis> in
+	<literal>chkconfig</literal> because <literal>rgmanager</literal> will
+	start and stop <literal>qpidd</literal>.  If the normal system init
+	process also attempts to start and stop qpidd it can cause rgmanager to
+	lose track of qpidd processes. The symptom when this happens is that
+	<literal>clustat</literal> shows a <literal>qpidd</literal> service to
+	be stopped when in fact there is a <literal>qpidd</literal> process
+	running. The <literal>qpidd</literal> log will show errors like this:
+	<programlisting>
+	  critical Unexpected error: Daemon startup failed: Cannot lock /var/lib/qpidd/lock: Resource temporarily unavailable
+	</programlisting>
+      </para>
+    </note>
     <para>
       You must provide a <literal>cluster.conf</literal> file to configure
       <command>cman</command> and <command>rgmanager</command>.  Here is
-- 
cgit v1.2.1