Skip to main content
AI
  • Get started with AI

    • Red Hat AI

      Accelerate the development and deployment of enterprise AI solutions.

    • AI learning hub

      Explore learning materials and tools, organized by task.

    • AI interactive demos

      Click through scenarios with Red Hat AI, including training LLMs and more.

    • AI/ML learning paths

      Expand your Red Hat OpenShift AI knowledge using these learning resources.

    • AI quickstarts

      Focused AI use cases designed for fast deployment on Red Hat AI platforms.

    • No-cost AI training

      Foundational Red Hat AI training.

  • Featured resources

    • Red Hat OpenShift AI
    • Open source AI for developers
    • AI product application development
    • Open source-powered AI/ML for hybrid cloud
    • AI and Node.js cheat sheet

Red Hat AI Factory with NVIDIA

Red Hat AI Factory with NVIDIA is a co-engineered, enterprise-grade AI solution for building, deploying, and managing AI at scale across hybrid cloud environments.

Learn
  • Self-guided

    • Documentation

      Find answers, get step-by-step guidance, and learn how to use Red Hat products.

    • Learning paths

      Explore curated walkthroughs for common development tasks.

    • Guided learning

      Receive custom learning paths powered by our AI assistant.

    • See all learning
  • Hands-on

    • Developer Sandbox

      Spin up Red Hat's products and technologies without setup or configuration.

    • Interactive labs

      Learn by doing in these hands-on, browser-based experiences.

    • Interactive demos

      Click through product features in these guided tours.

  • Browse by topic

    • AI/ML
    • Automation
    • Java
    • Kubernetes
    • Linux
    • See all topics
  • Training & certifications

    • Courses and exams
    • Certifications
    • Skills assessments
    • Red Hat Academy
    • Learning subscription
    • Explore training
Build
  • Get started

    • Red Hat build of Podman Desktop

      A downloadable, local development hub to experiment with our products and builds.

    • Developer Sandbox

      Spin up Red Hat's products and technologies without setup or configuration.

  • Download products

    • Red Hat Enterprise Linux
    • Red Hat AI
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products
  • Featured

    • Red Hat build of OpenJDK
    • Red Hat JBoss Enterprise Application Platform
    • Red Hat OpenShift Dev Spaces
    • Red Hat Developer Toolset
  • References

    • E-books
    • Documentation
    • Cheat sheets
    • Architecture center
Community
  • Get involved

    • Events
    • Live AI events
    • Red Hat Summit
    • Red Hat Accelerators
    • Community discussions
  • Follow along

    • Articles & blogs
    • Developer newsletter
    • Videos
    • Github
  • Get help

    • Customer service
    • Customer support
    • Regional contacts
    • Find a partner

Join the Red Hat Developer program

Download Red Hat products and project builds, access support documentation, learning content, and more.

ConsoleDocsSupport Search
New For you

Recommended

We'll recommend resources you may like as you browse. Try these suggestions for now.

  • Product downloads
  • Cheat sheets
  • Red Hat Developer learning portal
  • Developer blog
  • E-books
  • Developer Sandbox
Log in

Get more with a Red Hat Developer account

  • Product downloads
  • Console access
  • Event registration
  • Training & trials
Explore more account benefitsLog in or register

A subscription may be required for some services.

Contact us

Demonstrating Red Hat JBoss AMQ 7 HA Replication Failover

August 4, 2017
Hugo Guerrero
Related topics:
Java
Related products:
Streams for Apache Kafka

    A few weeks ago, the newest version of Red Hat JBoss AMQ was released. AMQ 7 is the result of Red Hat’s efforts on creating a unified messaging platform for its middleware offerings. One of the most interesting features of this new version is the new backing strategy for failovering when configured in high availability. This feature allows clients connections to migrate from one server to another in the event of server failure so client applications can continue to operate.

    AMQ 6.x already had an option to configure failover using a shared store, usually backed up by a shared filesystem or a JDBC connection to a database. However, that option involved the use of external infrastructure add-on in hardware and software, representing an increase in overall deployment costs.

    In AMQ 7, support for network-based replication was added. When using replication, the live and the backup servers do not share the same data directories; all data synchronization is done over the network. Therefore, all (persistent) data received by the live server will be duplicated to the backup.

    amq-ha-replicated

    The above figure shows the basics of AMQ 7 replication ha policy.

    The Replication (Shared Nothing) Demo project is a demonstration of the new AMQ 7 replicated high availability feature to avoid using a shared store. This project demonstrates how to set up a live broker and its corresponding backup using AMQ’s command line interface (CLI) and configure the replication ha fail-over policy.

    You will need a Linux or Mac laptop with at least 2GB RAM (4GB preferred) and a couple of GB of free disk space. A Java Virtual Machine version 8 should be installed in the system as well. With those prerequisites covered, you can deploy your brokers following the next steps:

    1. Download and unzip this demo of clone the Github repository.
    2. Download the JBoss AMQ Broker from Red Hat Developer Portal: —download here; add to installs directory (see installs/README).
    3. Deploy the demo using the automated installation script ‘init.sh’,
      ./init.sh
      

      After successfully deployed, you can test the failover.

    Sending messages

    To send messages to the master broker, execute the following command:

    $ target/amq-broker-7.0.1/instances/replicatedMaster/bin/artemis producer --message-count 10 --url "tcp://127.0.0.1:61616" --destination queue://haQueue
    

    Browse messages on Master

    To check the messages, which were successfully sent to the broker, check the queue in the broker web console.

    • Open a web browser and navigate to the AMQ web console, http://localhost:8161/hawtio.
    • In the left tree navigate to 127.0.0.1 > addresses > haQueue > queues > anycast > haQueue.
    • Click on Browse (refresh if necessary).

    You will see the 10 messages sent by the producer script.

    Browse backup Console

    As the replicatedSlave broker is running as a backup broker for replicatedMaster, there are no active addresses or queues listening.

    • Open a web browser and navigate to the AMQ web console http://localhost:8261/hawtio
    • In the left tree navigate to 127.0.0.1 > addresses > haQueue > queues > anycast > haQueue

    You will only see the information regarding the cluster broadcast configuration.

    Master shutdown

    To shutdown the master broker, execute the following command:

    $ target/amq-broker-7.0.1/instances/replicatedMaster/bin/artemis-service stop
    

    While the master is shutting down, the backup broker will notice the disconnection from the master and will become live.

    Browse messages on Slave

    To check the messages that were successfully replicated to the slave broker, check the queue in the slave broker web console.

    • Refresh the AMQ web console http://localhost:8261/hawtio
    • In the left tree navigate to 127.0.0.1 > addresses > haQueue > queues > anycast > haQueue
    • Click on Browse (refresh if necessary)

    You will see the 10 messages sent by the producer script to the master broker.

    Failback

    If you want, you can start again the replicated Master broker to see how the backup failbacks to the master.

    $ target/amq-broker-7.0.1/instances/replicatedMaster/bin/artemis-service start
    

    The master will start and check if there is a live broker when the backup detects that the master has become available again, it fails back going into a backup mode again.

    Now you are up and running with a fully installed and backed up AMQ 7 broker!

    For more information, check the Red Hat Developers Program site that provides useful blogs and content about Red Hat JBoss AMQ.


    Download  Red Hat JBoss AMQ for development use.

    Last updated: August 3, 2017

    Recent Posts

    • A day in the life of an NVIDIA H100 on Red Hat OpenShift 5

    • Migrate BuildConfigs to builds for Red Hat OpenShift with one plug-in install

    • Run Red Hat Enterprise Linux CoreOS on NVIDIA BlueField DPUs

    • Agent harness engineering: Separating model capabilities from enforcement

    • What's new for developers in Red Hat Enterprise Linux 10.3 and 9.9

    Red Hat Developers logo

    Platforms

    • Red Hat AI
    • Red Hat Enterprise Linux
    • Red Hat OpenShift
    • Red Hat Ansible Automation Platform
    • See all products

    Build

    • Developer Sandbox
    • Developer tools
    • Interactive tutorials
    • API catalog

    Quicklinks

    • Learning resources
    • E-books
    • Cheat sheets
    • Blog
    • Events
    • Newsletter

    Communicate

    • About us
    • Contact sales
    • Find a partner
    • Report a website issue
    • Site status dashboard
    • Report a security problem

    Red Hat Developer

    Build here. Go anywhere.

    We serve the builders. The problem solvers who create careers with code.

    Join us if you’re a developer, software engineer, web designer, front-end designer, UX designer, computer scientist, architect, tester, product manager, project manager or team lead.

    Sign me up

    Red Hat legal and privacy links

    • About Red Hat
    • Jobs
    • Events
    • Locations
    • Contact Red Hat
    • Red Hat Blog
    • Inclusion at Red Hat
    • Cool Stuff Store
    • Red Hat Summit
    © 2026 Red Hat

    Red Hat legal and privacy links

    • Privacy statement
    • Terms of use
    • All policies and guidelines
    • Digital accessibility
    Ask AI