Author: aconway
Date: Mon Jun 8 14:22:35 2015
New Revision: 1684194
URL: http://svn.apache.org/r1684194
Log:
NO-JIRA: Update HA docs to explain how to shut down a primary node.
Modified:
qpid/trunk/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml
Modified: qpid/trunk/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml
URL:
http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml?rev=1684194&r1=1684193&r2=1684194&view=diff
==============================================================================
--- qpid/trunk/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml
(original)
+++ qpid/trunk/qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml Mon Jun
8 14:22:35 2015
@@ -589,6 +589,37 @@ ha-brokers-url=20.0.20.1,20.0.20.2,20.0.
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">
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
