2.5 Setup for Apache ActiveMQ - jmstoolbox/jmstoolbox GitHub Wiki

Apache Active MQ

http://activemq.apache.org/

JMX or not JMX?

JMSToolBox can be configured to either get the ActiveMQ metada information and destinations with or without a JMX connection
This is control by setting the session property"useJMX"
When not using JMX, the destination information from ActiveMQ are not available and computing the depth of queues is done by reading all the message from the queue instead of calling the equivalent ActiveMQ JMX feature, which may be way slower The recommended configuration is to use JMX.

Extra JARS

No extra jar is needed as JMSToolBox is bundled with the latests Apache ActiveMQ jars

Requirements

IfuseJMXis set, JMX must be activated on the broker:
--> http://activemq.apache.org/jmx.html
(basically, in activemq.xml, add useJmx="true" on the "broker" tag and check that <managementContext createConnector="true"/> is present)

Connection Properties

Name Description
Host Apache ActiveMQ broker server name for JMX Connection (eg localhost)
Port Apache ActiveMQ broker port for JMX Connection (eg. 1099)
User/Password User allowed to connect to Apache ActiveMQ

Properties

Name Description
brokerURL broker url. Examples: tcp://localhost:61616 or ssl://localhost:61616
useJMX Default: true. If false, Destination info will be disabled and some fonctions may be slower
jmxContext JMX 'context' as used in the URL to open a JMX connection with the broker (service:jmx:rmi:///jndi/rmi://<host>:<port>/<JMX context>).Default to 'jmxrmi'. Other example : 'karaf-xxx'
jmxSpecificUserid User for the JMX connection. If not set, the session userid is used
jmxSpecificPassword Password for the JMX connection. If not set, the session password is used
trustAllPackages If true, allows to display ObjectMessage payload (Needs some config on the server also)
javax.net.ssl.trustStore trust store (eg D:/somewhere/trust.jks)
javax.net.ssl.trustStorePassword trust store password

If"transportConnector"on the server is set to "transport.needClientAuth=true":

Name Description
javax.net.ssl.keyStore key store (eg D:/somewhere/key.jks)
javax.net.ssl.keyStorePassword key store password
⚠️ **GitHub.com Fallback** ⚠️