Apache
/
activemq-artemis
mirror of https://github.com/apache/activemq-artemis.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

ARTEMIS-5050: misc improvements to 'Broker-to-Broker Connectivity' docs/index

This commit is contained in:
Robbie Gemmell 2024-09-18 18:38:55 +01:00 committed by Justin Bertram
parent d9d84f814c
commit f2a410e9bc
3 changed files with 22 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/user-manual/_book.adoc
View File

@ -59,15 +59,15 @@ include::metrics.adoc[leveloffset=1]
include::core-bridges.adoc[leveloffset=1]
include::clusters.adoc[leveloffset=1]
include::federation.adoc[leveloffset=1]
include::federation-address.adoc[leveloffset=1]
include::federation-queue.adoc[leveloffset=1]
include::ha.adoc[leveloffset=1]
include::network-isolation.adoc[leveloffset=1]
include::restart-sequence.adoc[leveloffset=1]
include::activation-tools.adoc[leveloffset=1]
include::connection-routers.adoc[leveloffset=1]
include::amqp-broker-connections.adoc[leveloffset=1]
include::federation.adoc[leveloffset=1]
include::federation-address.adoc[leveloffset=1]
include::federation-queue.adoc[leveloffset=1]
include::connection-routers.adoc[leveloffset=1]
include::jms-bridge.adoc[leveloffset=1]
//== Security

14
docs/user-manual/amqp-broker-connections.adoc
View File

@ -2,10 +2,7 @@
:idprefix:
:idseparator: -
Instead of waiting for clients to connect, a broker can initiate a connection to another endpoint on a specific protocol.
Currently, this feature supports only the AMQP protocol.
However, in the future, it might be expanded to other protocols.
Instead of waiting for clients to connect, a broker can also initiate a connection to another server.
Broker connections are configured by the `<broker-connections>` XML element in the `broker.xml` configuration file.
@ -65,6 +62,9 @@ The following types of operations are supported on an AMQP server connection:
* Mirrors
** The broker uses an AMQP connection to another broker and duplicates messages and sends acknowledgements over the wire.
* Federation
** Broker federation allows the local broker to create remote receivers for addresses or queues that have local demand.
Conversely it can also send federation configuration to the remote broker causing it to create receivers on the local broker based on remote demand on an address or queue over this same connection.
* Senders
** Messages received on specific queues are transferred to another endpoint.
* Receivers
@ -245,7 +245,7 @@ It is recommended to not have active consumers on both servers.
=== Example
There is an example as part of the distribution showing dual broker configuration (or disaster recovery) in `./examples/features/broker-connection/disaster-recovery`.
There is an example as part of the broker xref:examples.adoc[examples] showing dual broker configuration (or disaster recovery) in `./examples/features/broker-connection/disaster-recovery`.
On the provided example above, two brokers are configured to mirror each other and whatever happens in one broker is immediately copied over to the other broker.
@ -535,3 +535,7 @@ When federation consumers are created this value can be used to ensure that thos
The default is `-1`.
include-federated::
Controls if consumers on a queue which come from federation instances should be counted when observing a queue for demand, by default this value is `false` and federation consumers are not counted.
=== Examples
A number of examples for using the federation functionality in a variety of situations can be found in the broker xref:examples.adoc[examples] under directory _./examples/features/broker-connection_.

13
docs/user-manual/index.adoc
View File

@ -62,15 +62,20 @@ image::images/activemq-logo.png[align="center"]
* xref:core-bridges.adoc#core-bridges[Core Bridges]
* xref:clusters.adoc#clusters[Clustering]
* xref:federation.adoc#federation[Federation]
** xref:federation-address.adoc#address-federation[Address Federation]
** xref:federation-queue.adoc#queue-federation[Queue Federation]
* xref:ha.adoc#high-availability-and-failover[High Availability & Failover]
** xref:network-isolation.adoc#network-isolation-split-brain[Network Isolation]
** xref:restart-sequence.adoc#restart-sequence[Restart Sequence]
** xref:activation-tools.adoc#activation-sequence-tools[Activation Tools]
* xref:amqp-broker-connections.adoc#broker-connections[AMQP Broker Connections]
** xref:amqp-broker-connections.adoc#amqp-server-connections[Server Connections]
** xref:amqp-broker-connections.adoc#mirroring[Mirroring]
** xref:amqp-broker-connections.adoc#federation[AMQP Federation]
*** xref:amqp-broker-connections.adoc#local-and-remote-address-federation[Address Federation]
*** xref:amqp-broker-connections.adoc#local-and-remote-queue-federation[Queue Federation]
* xref:federation.adoc#federation[Core Federation]
** xref:federation-address.adoc#address-federation[Address Federation]
** xref:federation-queue.adoc#queue-federation[Queue Federation]
* xref:connection-routers.adoc#connection-routers[Routing Connections]
* xref:amqp-broker-connections.adoc#broker-connections[Broker Connections]
* xref:jms-bridge.adoc#the-jms-bridge[JMS Bridge]
== Security