summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlan Conway <aconway@apache.org>2014-04-28 19:20:27 +0000
committerAlan Conway <aconway@apache.org>2014-04-28 19:20:27 +0000
commit01d364e86e8f83fb12822ff4480d03bf9b85e4c2 (patch)
treeeca17cfd87b8b71ae6e39dafbcb40a022be2cd75
parentc3ea11a164cbec513ceadd24eb48f2fc7fbc52ef (diff)
downloadqpid-python-01d364e86e8f83fb12822ff4480d03bf9b85e4c2.tar.gz
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
-rw-r--r--qpid/doc/book/src/cpp-broker/Active-Passive-Cluster.xml25
1 files changed, 24 insertions, 1 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 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