diff options
author | Alan Conway <aconway@apache.org> | 2015-06-08 14:22:35 +0000 |
---|---|---|
committer | Alan Conway <aconway@apache.org> | 2015-06-08 14:22:35 +0000 |
commit | 2a347461803f54e39a9b4d41d68a47a06639a0a3 (patch) | |
tree | 7e78cb6eece4bf773968c63c3647f9c8ae41ff1d | |
parent | e494a245b2174915f13eaadc45566e0467c96bb9 (diff) | |
download | qpid-python-2a347461803f54e39a9b4d41d68a47a06639a0a3.tar.gz |
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
-rw-r--r-- | qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml | 31 |
1 files changed, 31 insertions, 0 deletions
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"> |