Chapter 3. Getting Started

After installing AMQ Console, you can log in and connect to the brokers and routers in your environment.

3.1. Accessing AMQ Console

You access AMQ Console through a single broker instance, regardless of how many brokers and routers are installed in your environment.

Procedure

  1. Start the AMQ broker and router instances that you want to manage in AMQ Console.

    For more information, see:

  2. Navigate to the web console address for the broker instance that you started.

    The web console address is http://HOST:PORT/console/login. If you are using the default address, navigate to http://localhost:8161/console/login.

    AMQ Console Login Page
  3. Log in to AMQ Console using the default username and password that you created when you created the broker instance.

3.2. Connecting to Multiple Brokers

When you access AMQ Console, you are automatically connected to the broker through which you accessed AMQ Console. If you have additional brokers running in your environment, you must connect to them before you can manage them through AMQ Console.

Prerequisites

  • At least one broker instance must be running.

Procedure

  1. In AMQ Console, click the Connect tab.

    AMQ Console Connect Page
  2. In the Connection Settings section, complete the following fields:

    Name
    A name that describes the broker instance to which you are connecting.
    Scheme
    If you have not configured AMQ Console security, choose http. If you have configured security, choose https.
    Host
    The host name of the web server on the broker instance to which you want to connect. The host is defined in the broker instance’s bootstrap.xml configuration file, in the <web> element. The default host is localhost.
    Port
    The port number on which to connect on the host. The port is defined in the broker instance’s bootstrap.xml configuration file, in the <web> element. The default port is 8161.
  3. Click Connect to remote server.

    A new AMQ Console session appears in a new browser window.

3.3. Connecting to Routers

Before you can manage AMQ Interconnect from AMQ Console, you must first connect to a router running on your router network. After you connect to a router, you can access and manage any router on the network using the Dispatch Router page.

Prerequisites

  • At least one AMQ Interconnect router must be running.

Procedure

  1. In AMQ Console, click the Dispatch Router tab.

    A connection page appears.

  2. Enter the Address and Port of the router to which you want to connect, and then click Connect. Set http (boolean) to yes in the listener section of the broker configuration file to accept HTTP connections using AMQP over WebSockets. For more information about the broker configuration file, see the Configuration Reference section in the Using AMQ Interconnect guide.

    The Overview page appears, showing a list of all routers running on your network.