You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by lq...@apache.org on 2016/08/17 13:38:56 UTC
svn commit: r1756633 - in /qpid/java/trunk/doc/java-broker/src/docbkx:
Java-Broker-Appendix-Operational-Logging-Messages.xml
Java-Broker-High-Availability.xml
management/managing/Java-Broker-Management-Managing-VirtualhostNodes.xml
Author: lquack
Date: Wed Aug 17 13:38:56 2016
New Revision: 1756633
URL: http://svn.apache.org/viewvc?rev=1756633&view=rev
Log:
QPID-7133: [Java Broker, Documentation] In the docbook rename HA "designated primary" to "allow to operate solo" to match UI
Modified:
qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml
qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-High-Availability.xml
qpid/java/trunk/doc/java-broker/src/docbkx/management/managing/Java-Broker-Management-Managing-VirtualhostNodes.xml
Modified: qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml
URL: http://svn.apache.org/viewvc/qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml?rev=1756633&r1=1756632&r2=1756633&view=diff
==============================================================================
--- qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml (original)
+++ qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-Appendix-Operational-Logging-Messages.xml Wed Aug 17 13:38:56 2016
@@ -1393,7 +1393,7 @@
<row>
<entry>
<para>This node has been designated primary and can now operate solo. Applies to two
- node groups only.</para>
+ node groups only. See <xref linkend="Java-Broker-High-Availability-Behaviour-DesignatedPrimary"/></para>
</entry>
</row>
<row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1014">
Modified: qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-High-Availability.xml
URL: http://svn.apache.org/viewvc/qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-High-Availability.xml?rev=1756633&r1=1756632&r2=1756633&view=diff
==============================================================================
--- qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-High-Availability.xml (original)
+++ qpid/java/trunk/doc/java-broker/src/docbkx/Java-Broker-High-Availability.xml Wed Aug 17 13:38:56 2016
@@ -366,19 +366,19 @@
</important>
</section>
<section xml:id="Java-Broker-High-Availability-Behaviour-DesignatedPrimary">
- <title>Designated Primary</title>
- <para>This attribute applies to the groups of two only.</para>
+ <title>Allow to Operate Solo</title>
+ <para>This attribute only applies to groups containing exactly two nodes.</para>
<para> In a group of two, if a node were to fail then in default configuration work will cease
as quorum no longer exists. A single node cannot elect itself master. </para>
- <para>The designated primary flag allows a node in a two node group to elect itself master and
- to operate sole. Designated Primary is configured as an <link linkend="Java-Broker-Management-Managing-Virtualhost-Nodes-Attributes">attribute on the
+ <para>The <literal>allow to operate solo</literal> flag allows a node in a two node group to elect itself master and
+ to operate sole. It is configured as an <link linkend="Java-Broker-Management-Managing-Virtualhost-Nodes-Attributes">attribute on the
virtualhost node</link> and can be changed at runtime and is effective immediately.</para>
<para>For example, consider a group of two where the master fails. Service will be interrupted
as the remaining node cannot elect itself master. To allow it to become master, apply the
- designated primary flag to it. It will elect itself master and work can continue, albeit
+ <literal>allow to operate solo</literal> flag to it. It will elect itself master and work can continue, albeit
from one node.</para>
<important>
- <para>It is imperative not to allow designated primary to be set on both nodes at once. To
+ <para>It is imperative not to allow the <literal>allow to operate solo</literal> flag to be set on both nodes at once. To
do so will mean, in the event of a network partition, a <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://en.wikipedia.org/wiki/Split-brain_(computing)">split-brain</link> will
occur.</para>
<para>Transaction loss is reported by message <link linkend="Java-Broker-Appendix-Operation-Logging-Message-HA-1014">HA-1014</link>.</para>
Modified: qpid/java/trunk/doc/java-broker/src/docbkx/management/managing/Java-Broker-Management-Managing-VirtualhostNodes.xml
URL: http://svn.apache.org/viewvc/qpid/java/trunk/doc/java-broker/src/docbkx/management/managing/Java-Broker-Management-Managing-VirtualhostNodes.xml?rev=1756633&r1=1756632&r2=1756633&view=diff
==============================================================================
--- qpid/java/trunk/doc/java-broker/src/docbkx/management/managing/Java-Broker-Management-Managing-VirtualhostNodes.xml (original)
+++ qpid/java/trunk/doc/java-broker/src/docbkx/management/managing/Java-Broker-Management-Managing-VirtualhostNodes.xml Wed Aug 17 13:38:56 2016
@@ -84,7 +84,7 @@
service can be restore when less than quorum nodes are present. See <xref linkend="Java-Broker-High-Availability-Behaviour-MinimumNumberOfNodes"/></para>
</listitem>
<listitem>
- <para><emphasis>Designated Primary</emphasis> (HA only - groups of two). Allows a single
+ <para><emphasis>Allow this node to operate solo</emphasis> (HA only - groups of two). Allows a single
node in a two node group to operate solo. See <xref linkend="Java-Broker-High-Availability-Behaviour-DesignatedPrimary"/></para>
</listitem>
</itemizedlist>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org