From fa4acf12ee03a0463edec302c61fd24708840389 Mon Sep 17 00:00:00 2001 From: Alan Conway Date: Tue, 31 Jul 2012 19:57:59 +0000 Subject: NO-JIRA: Update HA docs to mention link-maintenace-interval, minor doc fixes. git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk/qpid@1367733 13f79535-47bb-0310-9956-ffa450edef68 --- doc/book/src/cpp-broker/Active-Passive-Cluster.xml | 74 +++++++++++++--------- .../Cheat-Sheet-for-configuring-Queue-Options.xml | 2 +- 2 files changed, 45 insertions(+), 31 deletions(-) diff --git a/doc/book/src/cpp-broker/Active-Passive-Cluster.xml b/doc/book/src/cpp-broker/Active-Passive-Cluster.xml index 545aa6c67b..6cd89205c5 100644 --- a/doc/book/src/cpp-broker/Active-Passive-Cluster.xml +++ b/doc/book/src/cpp-broker/Active-Passive-Cluster.xml @@ -185,18 +185,20 @@ under the License. Configuration changes (creating or deleting queues, exchanges and bindings) are - replicated asynchronously. Management tools used to make changes will consider the - change complete when it is complete on the primary, it may not yet be replicated - to all the backups. + replicated asynchronously. Management tools used to make changes will consider + the change complete when it is complete on the primary, it may not yet be + replicated to all the backups. - Deletions made immediately after a failure (before all the backups are ready) may - be lost on a backup. Queues, exchange or bindings that were deleted on the primary could - re-appear if that backup is promoted to primary on a subsequent failure. + Deletions made immediately after a failure (before all the backups are ready) + may be lost on a backup. Queues, exchange or bindings that were deleted on the + primary could re-appear if that backup is promoted to primary on a subsequent + failure. - Federated links from the primary will be lost in fail over, they will not be - re-connected on the new primary. Federation links to the primary can fail over. + Federated links from the primary will be lost in fail over, + they will not be re-connected to the new primary. Federation links + to the primary can fail over. @@ -227,10 +229,10 @@ under the License. default. The following broker options are available for the HA module. - Options for High Availability Messaging Cluster + Broker Options for High Availability Messaging Cluster - - + + @@ -241,7 +243,7 @@ under the License. - --ha-cluster yes|no + ha-cluster yes|no Set to "yes" to have the broker join a cluster. @@ -249,7 +251,7 @@ under the License. - --ha-brokers-url URL + ha-brokers-url URL @@ -258,11 +260,11 @@ under the License. The full format of the URL is given by this grammar: - url = ["amqp:"][ user ["/" password] "@" ] addr ("," addr)* - addr = tcp_addr / rmda_addr / ssl_addr / ... - tcp_addr = ["tcp:"] host [":" port] - rdma_addr = "rdma:" host [":" port] - ssl_addr = "ssl:" host [":" port]' +url = ["amqp:"][ user ["/" password] "@" ] addr ("," addr)* +addr = tcp_addr / rmda_addr / ssl_addr / ... +tcp_addr = ["tcp:"] host [":" port] +rdma_addr = "rdma:" host [":" port] +ssl_addr = "ssl:" host [":" port]' @@ -274,11 +276,11 @@ under the License. - --ha-public-url URL + ha-public-url URL The URL that is advertised to clients. This defaults to the - --ha-brokers-url URL above, and has the same format. A + ha-brokers-url URL above, and has the same format. A virtual IP address is recommended for the public URL as it simplifies deployment and hides changes to the cluster membership from clients. @@ -289,20 +291,22 @@ under the License. - --ha-replicate + ha-replicate VALUE Specifies whether queues and exchanges are replicated by default. - For details see + VALUE is one of: none, + configuration, all. + For details see . - --ha-username USER - --ha-password PASS - --ha-mechanism MECH + ha-username USER + ha-password PASS + ha-mechanism MECH Authentication settings used by HA brokers to connect to each other. @@ -312,7 +316,7 @@ under the License. - --ha-backup-timeout SECONDS + ha-backup-timeout SECONDS Maximum time that a recovering primary will wait for an expected @@ -320,6 +324,16 @@ under the License. + + link-maintenance-interval SECONDS + + + Interval for the broker to check link health and re-connect links if need + be. If you want brokers to fail over quickly you can set this to a + fraction of a second, for example: 0.1. + + +
@@ -516,7 +530,7 @@ NOTE: fencing is not shown, you must configure fencing appropriately for your cl The tools qpid-config, qpid-route and - qpid-stat will connect to a backup if you pass the flag --ha-admin on the + qpid-stat will connect to a backup if you pass the flag ha-admin on the command line. @@ -755,9 +769,9 @@ NOTE: fencing is not shown, you must configure fencing appropriately for your cl - --ha-username USER - --ha-password PASS - --ha-mechanism MECH + ha-username USER + ha-password PASS + ha-mechanism MECH Authentication settings used by HA brokers to connect to each other. diff --git a/doc/book/src/cpp-broker/Cheat-Sheet-for-configuring-Queue-Options.xml b/doc/book/src/cpp-broker/Cheat-Sheet-for-configuring-Queue-Options.xml index d50948e0cc..78272b7ef4 100644 --- a/doc/book/src/cpp-broker/Cheat-Sheet-for-configuring-Queue-Options.xml +++ b/doc/book/src/cpp-broker/Cheat-Sheet-for-configuring-Queue-Options.xml @@ -176,7 +176,7 @@ ignored. - A fully worked can be found here + A fully worked can be found here
-- cgit v1.2.1