Chapter 3. Reference Architecture Environment

3.1. Overview

This reference architecture demonstrates a multi-service OpenShift Container Platform project housing various Red Hat JBoss AMQ 7 topologies. The provided environment builds on OpenShift, so the included test suite also assumes an OpenShift environment, but installation and configuration steps for any Red Hat Enterprise Linux server and/or cluster are also provided in order to establish a similar environment.

Warning

The AMQ/OpenShift configuration described and/or provided herein uses community software and thus is not an officially supported Red Hat configuration at the time of writing.

This reference architecture showcases 4 topology examples:

3.2. Single-Broker Instance

This example features multiple JMS clients interacting with a single broker to demonstrate execution of basic send and receive messaging patterns.

Figure 3.1. Single Broker

Single Broker

3.3. Symmetric Broker Cluster

This example features a cluster of 3 broker instances, all grouped together to allow for internal load balancing.

Figure 3.2. 3-Node Symmetric Cluster

3-Node Symmetric Cluster

3.4. Fault-Tolerant Broker Cluster

This example features 3 master and 3 slave broker instances, all clustered within the same group, allowing automatic master/slave pairing and failover.

Figure 3.3. 3-Pair Master/Slave Cluster

3-Pair Master/Slave Cluster

3.5. Multi-Router Interconnect Network

This example features 7 nodes, simulating various geographic distributions in order to showcase the differences in various routing algorithm choices.

Figure 3.4. Interconnect Network

Interconnect Network