Table Of Contents

Previous topic

4.1. Console overview

Next topic

4.3. Console operation

4.2. Console installation

4.2.1. Prerequisites

The following need to be installed before running a console:

  • One or more dispatch routers. See the documentation for the dispatch router for help in starting a router network.
  • A websockets to tcp proxy.
  • A web server. This can be any server capable of serving static html/js/css/image files.

To install a websockets to tcp proxy:

sudo dnf install python-websockify
websockify localhost:5673 localhost:5672

This will start the proxy listening to ws traffic on port 5673 and translating it to tcp on port 5672. One of the routers in the network needs to have a listener configured on port 5672. That listener’s role should be ‘normal’. For example:

listener {
   host: 0.0.0.0
   role: normal
   port: amqp
   saslMechanisms: ANONYMOUS
}

4.2.2. The console files

The files for the console are located under the console/stand-alone directory in the source tree.::
index.html plugin/
Copy these files to a directory under the the html or webapps directory of your web server. For example, for apache tomcat the files should be under webapps/dispatch. Then the console is available as::
http://localhost:8080/dispatch