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.
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 3.3.
Example 3.3. Disabling the Embedded Web Console
<beans ... > <broker ... > ... </broker> <!-- <import resource="jetty.xml"/> --> </beans>
To deploy the Web console in Tomcat 5.x:
Download the Web console's WAR,
activemq-web-console-5.5.1-fuse-00-xx.war
, from http://repo.fusesource.com/nexus/content/groups/m2-release-proxy/org/apache/activemq/activemq-web-console/5.5.1-fuse-00-xx/.Copy the Web console's WAR to the
folder.TOMCAT_HOME
/webappsDownload
activemq-all-5.5.1-fuse-00-xx.jar
from http://repo.fusesource.com/nexus/content/groups/m2-release-proxy/org/apache/activemq/activemq-all/5.5.1-fuse-00-xx/.Copy
activemq-all-5.5.1-fuse-00-xx.jar
to the
folder.TOMCAT_HOME
/common/libModify
to include the configuration in Example 3.4.TOMCAT_HOME
/bin/catalina.sh(.bat)Example 3.4. 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
"Restart Tomcat.
The Web console will be available at
.tomcatURI
/activemq-web-console-5.5.1-fuse-00-xx
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 afailover:
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 3.5 shows the properties for monitoring a cluster using the Web console.
Example 3.5. 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.