LibraryToggle FramesPrintFeedback

Deploying a Standalone Console

Revision History

Overview

For more security or reliability reasons you can deploy the Web console as a standalone application in Tomcat or another Web container. When running as a standalone application, the Web console can be set up to monitor Master/Slave clusters.

Disabling the embedded console

There is no need to disable the embedded console when using a standalone console. However, If you are using a standalone Web console, there is no reason to use the resources required by the embedded console. Nor is there a reason to leave an extra administrative access point open.

To disable the embedded Web console, you simply need to comment out, or remove, the import element that imports the Jetty configuration into your broker's configuration file as shown in Example 15.

Example 15. Disabling the Embedded Web Console

<beans  ... >

  <broker ... >
     ...
  </broker>

  <!-- <import resource="jetty.xml"/>  -->

</beans>

Configuring Tomcat

To deploy the Web console in Tomcat 5.x:

  1. Download the Web console's WAR, activemq-web-console-7.0.2.fuse-097.war, from http://repo.fusesource.com/nexus/content/repositories/releases/org/apache/activemq/activemq-web-console/5.5.1.fuse-70-097/.

  2. Copy the Web console's WAR to the TOMCAT_HOME/webapps folder.

  3. Download activemq-all-7.0.2.fuse-097.jar from http://repo.fusesource.com/nexus/content/repositories/releases/org/apache/activemq/activemq-all/5.5.1.fuse-70-097/.

  4. Copy activemq-all-7.0.2.fuse-097.jar to the TOMCAT_HOME/common/lib folder.

  5. Modify TOMCAT_HOME/bin/catalina.sh(.bat) to include the configuration in Example 16.

    Example 16. Configuration for Deploying the Web Console in Tomcat

    JAVA_OPTS="-Dwebconsole.type=properties \
    -Dwebconsole.jms.url=brokerURL \
    -Dwebconsole.jmx.url=brokerJMXURL \
    -Dwebconsole.jmx.user=JMXUserName \
    -Dwebconsole.jmx.password=JMXPassword"

  6. Restart Tomcat.

The Web console will be available at tomcatURI/activemq-web-console-5.5.1.fuse-70-097.

Monitoring clusters

It's possible to configure the Web console to monitor a master/slave cluster. To do so:

  • Specify the JMS URL, webconsole.jms.url, with a failover: URI specifying the brokers in the cluster.

  • Specify the JMX URL, webconsole.jmx.url as a comma separated list that contains the JMX URL for each of the brokers in the cluster.

Example 17 shows the properties for monitoring a cluster using the Web console.

Example 17. Configuration for Monitoring a Cluster with the Web Console

-Dwebconsole.jms.url=failover:(tcp://serverA:61616,tcp://serverB:61616)
-Dwebconsole.jmx.url=service:jmx:rmi:///jndi/rmi://serverA:1099/jmxrmi,service:jmx:rmi:///jndi/rmi://serverB:1099/jmxrmi

For more information about master/slave clusters see Master/Slave in Fault Tolerant Messaging.

Comments powered by Disqus