Chapter 13. Monitoring using AMQ Console

Procedure

1. On the router from which you want to access the web console, open the /etc/qpid-dispatch/qdrouterd.conf configuration file.

2. Add a listener to serve the console.

   This example creates a listener that clients can use to access the web console:

   listener {
       host: 0.0.0.0
       port: 8672
       role: normal
       http: true
       httpRootDir: /usr/share/qpid-dispatch/console
   }

   host

   The IP address (IPv4 or IPv6) or hostname on which the router will listen.

   port

   The port number or symbolic service name on which the router will listen.

   role

   The role of the connection. Specify normal to indicate that this connection is used for client traffic.

   http

   Set this attribute to true to specify that this listener should accept HTTP connections instead of plain AMQP connections.

   httpRootDir

   Specify the absolute path to the directory that contains the web console HTML files. The default directory is the stand-alone console installation directory, usually /usr/share/qpid-dispatch/console.

3. If you want to secure access to the console, secure the listener.

   For more information, see Section 9.2, “Securing incoming client connections”. This example adds basic user name and password authentication using SASL PLAIN:

   listener {
       host: 0.0.0.0
       port: 8672
       role: normal
       http: true
       httpRootDir: /usr/share/qpid-dispatch/console
       authenticatePeer: yes
       saslMechanisms: PLAIN
   }

4. If you want to set up access to the web console from any other router in the router network, repeat this procedure for each router.

Procedure

1. In a web browser, navigate to the web console URL.

   The web console URL is the <host>:<port> from the listener that you created to serve the web console. For example: localhost:8672.

   The AMQ Console opens. If you set up user name and password authentication, the Connect tab is displayed.

2. If necessary, log in to the web console.

   If you set up user name and password authentication, enter your user name and password to access the web console.

   The syntax for the user name is <user>@<domain>. For example: admin@my-domain.