Tech and Tips

Hawtio is not included by default in ActiveMQ 5.9.1 as it was in 5.9.0.

But by following the instructions from these 2 pages, it is fairly simple to add it manually:
http://sensatic.net/activemq/activemq-and-hawtio.html
http://activemq.2283324.n4.nabble.com/Hawto-log-in-td4673552.html

The main info from the second page is this missing info from the first one:
-Djava.security.auth.login.config=$ACTIVEMQ_CONF/login.config

Also make sure that you update the usernames/password in the following files in $ACTIVEMQ_HOME/conf:
- credentials.properties
- users.properties
- groups.properties
- login.config

Make sure you also add this to $ACTIVEMQ_HOME/bin/activemq, somewhere around line 160:
ACTIVEMQ_OPTS="$ACTIVEMQ_OPTS -Dhawtio.realm=activemq -Dhawtio.role=admins -Dhawtio.rolePrincipalClasses=org.apache.activemq.jaas.GroupPrincipal -Djava.security.auth.login.config=$ACTIVEMQ_CONF/login.config"
ACTIVEMQ_OPTS="$ACTIVEMQ_OPTS -Dhawtio.offline=true -Dhawtio.config.cloneOnStartup=false -Dhawtio.config.pullOnStartup=false"

The second set of sysetm properties is to prevent hawtio to try to fetch data from github which is does by default. If you are behind a firewall, this can cause hawtio to hang for over 2 minutes.

2 more things:
- if you have some special proxy settings, you might want to use 127.0.1.1 instead of 127.0.0.1 to reach your local hawtio
- the hawtio tree structure on the left side gets all screwed up each time a refresh occurs. I am not sure if this is a bug in hawtio but it is very annoying.

More links:
http://hawt.io/getstarted/
http://hawt.io/configuration/index.html#Configuration_Properties


Good luck!