Installing and using Hawtio to inspect activemq messages
Hawtio is a third-party tool that allows the investigation of the various activemq messages used in various parts of Mosaic. These messages usually contain important information such as data structure and errors.
Installing Hawtio
Before installing Hawtio download it from http://hawtio.github.io/hawtio/getstarted/index.html and click the Download hawtio-default.war button under Using a Servelet Engine or Application Server.
Steps to install
Go to the Weblogic console and log in.
Go to Deployed Resources then Deployments.
Click Install.
In the path field enter the path to the location of the hawtio war file.
In the list of files under Current Location select the hawtio war file and click Next.
Select the Install this deployment as an application option and click next.
Click next.
Select the server you wish to attach hawtio to. This can be Mis, Mosaic, or another server.
Don’t change any of the settings on the following page and click next.
Select No, I will review the configuration later option under Additional Configuration and click Finish.
The next screen might take a minute or two to load. Take note of the Context Root value. This is the value that will be used in the URL to access hawtio (see highlighted below).
Accessing Hawtio
In order to access hawtio we need to build the correct URL to use. To do this you need to gather the following pieces of information:
Domain and port: This is matches the domain and listening port of the server hawtio is attached to. Example: http://mymosaicserver:7501
Path: The value of the context root for the hawtio install. See step 10 above. Example: /hawtio-default-1.5.11
So as an example if you attach hawtio to a mis server accessed with the url http://mymosaicserver:7501/mis, and the context root for hawtio is /hawtio-default-1.5.11, then the url to access hawtio will be http://mymosaicserver:7501/hawtio-default-1.5.11.
Using Hawtio to check the contents of a queue
After logging into hawtio click on the ActiveMQ tab in the top menu. When the page loads you will see a list of the different queues. For example, if hawtio is attached to a mis server, you should see the inbound, outbound, and deadletter queues.
Clicking on one of them gives you an overview of the queue, and if you click on the browse option in the queue menu in the right-side panel, you will see a list of any messages that are yet to be processed.