Skip to content

Toro Cloud Dev Center


ActiveMQ Artemis as the instance message broker

ActiveMQ Artemis is a message broker that originated from JBoss' HornetQ, which was donated to the Apache ActiveMQ community. ActiveMQ Artemis features non-blocking architecture, high performance, flexible clustering, high availability, multi-protocol support, and more. It is also fully Java Message Service (JMS)1 API-compliant, making it compatible with Martini.

Prerequisites

To be able to connect to an ActiveMQ Artemis broker, its JMS client library must be added to Martini first. The ActiveMQ Artemis JAR file can be downloaded via the Maven Repository. After acquiring the library JAR, place the file under <martini-home>/lib/ext/.

Configuration

  1. Modify the configuration file.

    The connection configuration for ActiveMQ Artemis is located in <martini-home>/conf/broker/artemis-external.xml. Open the file and configure the uri, username, and password properties based on your ActiveMQ Artemis configuration.

  2. Use the configuration file.

    By default, Martini uses an embedded instance of ActiveMQ. To have Martini use the ActiveMQ Artemis configuration file instead, open the <martini-home>/data/override.properties file and add or change the following property:

    1
    jms.configuration-file=artemis-external
    
  3. Restart Martini.

    Before your configuration takes effect, you will need to restart your Martini instance.

    If everything is configured correctly, Martini should be able to start. You can verify the connection by accessing the management console under the Connections tab.

    ActiveMQ management console, Connections tab


  1. Java Message Service (JMS) is a set of interfaces that allows Java applications to communicate with other messaging implementations.