dispatch

hawtio dispatch router plugin

dispatch-hawtio-console.war is a standalone hawtio plugin that can be deployed in a server alongside the main hawtio-web application.

The project creates a war file that can be deployed in various application services and is also OSGi-ified so it deploys nicely into Apache Karaf.

Docker

The fastest way to use the console is to run the docker image. Follow the installation/run instruction on that page.

Building

The dispatch-hawtio-console.war file is pre-built and can be installed alongside the hawtio.war on any system with a modern java installation. If you want to build the dispatch-hawtio-console.war from source:

• do a maven build of dispatch

  $ cd console/hawtio

  $ mvn clean install

The dispatch-hawtio-console--SNAPSHOT.war file should now be in the target directory.

Apache Tomcat installation

Copy the dispatch-hawtio-console--SNAPSHOT.war file as the following name

dispatch-hawtio-console.war

to the deploy directory of Apache Tomcat or similar Java web container. Ensure the hawtio.war file is present in the same directory. Point a browser at http://<tomcat-host:port>/hawtio Dispatch Router should be available as a tab in the console.

Connecting to a router

On the Dispatch Router's console page, select the Connect sub tab. Enter the address of a dispatch router. Enter the port of a websockets to tcp proxy and click the Connect button.

Websockts to tcp proxy

The console communicates to a router using websockets. The router listens for tcp. Therefore a websockts/tcp proxy is required.

A popular python based proxy is websockify. To use it:

$ yum install python-websockify

Manually running a python websockets/tcp proxy

$ websockify 5673 0.0.0.0:20009 &

In the above, websockify is listening for ws traffic on port 5673 and will proxy it to 0.0.0.0:20009. One of the routers will need a listener on the proxied port. An example router .conf file entry is:

listener {
    name: ProxyListener
    role: normal
    host: 0.0.0.0
    port: 20009
    saslMechanisms: ANONYMOUS
}

Automatically running a proxy with a router

You can automatically start the proxy program when a router starts. Add the listener above and the following console section to a router's config file.

console {
    listener: ProxyListener
    proxy:    wobsockify
    args:     $host:5673 $host:$port
}