From 2a347461803f54e39a9b4d41d68a47a06639a0a3 Mon Sep 17 00:00:00 2001
From: Alan Conway <aconway@apache.org>
Date: Mon, 8 Jun 2015 14:22:35 +0000
Subject: NO-JIRA: Update HA docs to explain how to shut down a primary node.

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

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 26d701df64..461b75d320 100644
--- a/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml
+++ b/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml
@@ -589,6 +589,37 @@ ha-brokers-url=20.0.20.1,20.0.20.2,20.0.20.3
       does not start a new broker process, it promotes the existing broker to
       become the primary.
     </para>
+
+    <section id="ha-rm-shutdown-node">
+      <title>Shutting down qpidd on a HA node</title>
+      <para>
+        As explained above both the per-node <literal>qpidd</literal> service
+        and the re-locatable <literal>qpidd-primary</literal> service are
+        implemented by the same <literal>qpidd</literal> daemon.
+      </para>
+      <para>
+        As a result, stopping the <literal>qpidd</literal> service will not stop
+        a <literal>qpidd</literal> daemon that is acting as primary, and
+        stopping the <literal>qpidd-primary</literal> service will not stop a
+        <literal>qpidd</literal> process that is acting as backup.
+      </para>
+      <para>
+        To shut down a node that is acting as primary you need to shut down the
+        <literal>qpidd</literal> service <emphasis>and</emphasis> relocate the
+        primary:
+      </para>
+      <para>
+	<programlisting>
+clusvcadm -d somenode-qpidd-service
+clusvcadm -r qpidd-primary-service
+        </programlisting>
+      </para>
+      <para>
+        This will shut down the <literal>qpidd</literal> daemon on that node and
+        prevent the primary service service from relocating back to the node
+        because the qpidd service is no longer running there.
+      </para>
+    </section>
   </section>
 
   <section id="ha-broker-admin">
-- 
cgit v1.2.1