Configuring ActiveMQ Artemis as TORO Integrate's 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 TORO Integrate.
Prerequisites
To be able to connect to an ActiveMQ Artemis broker, its JMS client library must be added to TORO Integrate first.
The ActiveMQ Artemis JAR file can be downloaded via the Maven Repository.
After acquiring the library JAR, place the file under <toro-integrate-home>/lib/ext/
.
Configuration
Step 1: Modifying the Configuration File
The connection configuration for ActiveMQ Artemis is located in
<toro-integrate-home>/conf/broker/artemis-external.xml
. Open the file and configure the uri
, username
, and
password
properties based on your ActiveMQ Artemis configuration.
Step 2: Using the Configuration File
By default, TORO Integrate uses an embedded instance of ActiveMQ. To have TORO Integrate use the ActiveMQ Artemis
configuration file instead, open the <toro-integrate-home>/data/override.properties
file and add the following
property:
1 | jms.file=artemis-external |
Step 3: Restart TORO Integrate
Before your configuration takes effect, you will need to restart your TORO Integrate instance.
If everything is configured correctly, TORO Integrate should be able to start. You can verify the connection by
accessing the management console under Connections
tab.
-
Java Message Service (JMS) is a set of interfaces that allows Java applications to communicate with other messaging implementations. ↩