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
-
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 theuri
,username
, andpassword
properties based on your ActiveMQ Artemis configuration. -
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
-
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.
-
Java Message Service (JMS) is a set of interfaces that allows Java applications to communicate with other messaging implementations. ↩