Red Hat Training

A Red Hat training course is available for Red Hat AMQ

Chapter 7. Managing AMQ Interconnect

You can use AMQ Console to view important information about AMQ Interconnect routers and the router network, change a router’s configuration, and add new routers to the network.

7.1. Viewing Information about the Router Network

You can view details about routers, message addresses, links, and connections. You can also view the status of the router network.

7.1.1. Viewing Router Details

You can view a list of routers in the router network. You can also view detailed attributes for each router.

Procedure

  1. On the Dispatch Router tab, click Overview.
  2. In the folder tree, click Routers.

    The Routers page appears, displaying information about each router on the network.

  3. To view additional details for a router, click a router in the table.

    To sort the list of routers, click a column header. To sort the routers in descending order, click the header a second time.

Related Information

7.1.2. Viewing Message Address Details

You can view a list of message-routed and link-routed addresses known to the router.

Procedure

  1. On the Dispatch Router tab, click Overview.
  2. In the folder tree, click Addresses.

    The Addresses page appears, displaying information about each message address known to the router.

  3. To view additional details for a message address, click an address in the table.

    To sort the list of addresses, click a column header. To sort the addresses in descending order, click the header a second time.

7.1.4. Viewing Connection Details

You can view a list of connections to the router from clients (senders and receivers), from and to other routers in the network, and to other containers (such as brokers).

Procedure

  1. On the Dispatch Router tab, click Overview.
  2. In the folder tree, click Connections.

    The Connections page appears, displaying information about each connection to or from the router.

  3. To view additional details for a connection, click a connection in the table.

    To sort the list of connections, click a column header. To sort the connections in descending order, click the header a second time.

7.1.5. Viewing Recent Log Entries

You can view recent log entries for all of the routers in your router network.

Procedure

  1. On the Dispatch Router tab, click Overview.
  2. In the folder tree, click Logs.

    The Recent Log Entries page appears, showing a list of the logging modules along with the level at which they’re enabled and the number of available log entries.

  3. Click a logging module to view its log entries.

Related Information

7.1.6. Viewing the Router Topology

You can view a graphical topology of the router network to see how the routers are connected.

Procedure

  1. On the Dispatch Router tab, click Topology.

    The router topology is displayed.

  2. To view more information about the topology, do one of the following:

    To view…​Do this…​

    Details about links between a client and router

    Click a client.

    Details about a router in the network

    Click the router.

    Details about a connection between routers

    Click the connection arrow.

Related Information

7.1.7. Viewing Charts About Router Status

You can view charts about the real-time status of a router, policy, message address, or link.

Procedure

  1. On the Dispatch Router tab, click Entities.

    A page appears displaying all of the management entities for the router.

  2. At the top of the folder tree, select a router from the drop-down menu.

    The management entities are displayed for the router you selected.

  3. To view additional details about a management entity, select an entity in the folder tree.

    The entity’s attributes are displayed. The Value column shows the value for the router you selected, and the Aggregate column (if applicable) shows the aggregate value for the entire router network.

    The values and aggregate values of these attributes can be either static or dynamic. Static values do not change unless you change them (for example, the Id of the router). However, the values of some attributes change in real time (for example, the Delivery Count for an address), and are designated by a chart icon.

  4. To view the real-time value of an attribute in a chart, click the chart icon next to the attribute’s value or aggregate value.

7.2. Modifying Routers

AMQ Console provides a list of router management entities that enable you to quickly make temporary updates to the following for any router in your router network:

  • Network connections (listeners and connectors)
  • Routing mechanisms (message routing and link routing)
  • Logging
  • Security (SSL/TLS)

If you modify a router by updating a router management entity, the changes take effect immediately. However, the changes will be lost if the router is stopped. To make permanent changes to a router, you should edit the router’s configuration file. For more information, see Configuration in Using AMQ Interconnect.

7.2.1. Creating Network Connections

You can create incoming and outgoing network connections for a router.

Procedure

  1. On the Dispatch Router tab, click Entities.

    A page appears displaying all of the management entities for the router.

  2. At the top of the folder tree, select a router from the drop-down menu.

    The management entities are displayed for the router you selected.

  3. Do one of the following:

    • To create an incoming connection, click listener.
    • To create an outgoing connection, click connector.
  4. On the toolbar, click Create.

    The attributes become editable.

  5. Update the attributes as needed.

    At a minimum, you must update the Name to ensure that this network connection is unique. You can hover over an attribute to see a definition of the attribute.

    For additional information about network connections, see Network Connections in Using AMQ Interconnect.

  6. Click Create.

7.2.2. Deleting Network Connections

You can delete incoming and outgoing network connections for a router.

Procedure

  1. On the Dispatch Router tab, click Entities.

    A page appears displaying all of the management entities for the router.

  2. At the top of the folder tree, select a router from the drop-down menu.

    The management entities are displayed for the router you selected.

  3. Do one of the following:

    • To delete an incoming connection, click listener.
    • To delete an outgoing connection, click connector.
  4. Click the listener or connector that you want to delete.

    The connection is displayed with all of its attributes.

  5. On the toolbar, click Delete.

7.2.3. Defining a Message Address Routing Configuration

You can specify the routing pattern to be used for a message address.

Procedure

  1. On the Dispatch Router tab, click Entities.

    A page appears displaying all of the management entities for the router.

  2. At the top of the folder tree, select a router from the drop-down menu.

    The management entities are displayed for the router you selected.

  3. Click address.
  4. On the toolbar, click Create.

    The attributes become editable.

  5. Update the attributes as needed.

    At a minimum, you must update the Name to ensure that this address configuration is unique. You can hover over an attribute to see a definition of the attribute.

    For additional information about message routing, see Configuring Message Routing in Using AMQ Interconnect.

  6. Click Create.
  7. If this message address should be routed to a queue on a broker, add an autolink.

    1. In the folder tree, click autoLink.
    2. On the toolbar, click Create.
    3. Update the attributes as needed.

      At a minimum, you must update the Name to ensure that this autolink is unique. You can hover over an attribute to see a definition of the attribute.

      For additional information about autolinks, see Configuring Waypoints and Autolinks in Using AMQ Interconnect.

7.2.4. Deleting a Message Address Routing Configuration

If you do not want messages with a particular address prefix to be routed in a particular way, you can delete the message address configuration that defines the routing pattern for those message addresses.

Procedure

  1. On the Dispatch Router tab, click Entities.

    A page appears displaying all of the management entities for the router.

  2. At the top of the folder tree, select a router from the drop-down menu.

    The management entities are displayed for the router you selected.

  3. Click address.
  4. Click the message address configuration you want to delete.

    The address is displayed with all of its attributes.

  5. On the toolbar, click Delete.

7.2.7. Updating Logging Modules

For each logging module, you can set the logging level, and update where the log messages are sent and how they are formatted.

Procedure

  1. On the Dispatch Router tab, click Entities.

    A page appears displaying all of the management entities for the router.

  2. At the top of the folder tree, select a router from the drop-down menu.

    The management entities are displayed for the router you selected.

  3. Click log.
  4. Click a logging module, and then click Update.
  5. Update the logging module’s attributes as needed.

    You can hover over an attribute to see a definition of the attribute.

    For additional information about logging, see Configuring Logging Modules in Using AMQ Interconnect.

  6. Click Update.

Related Information

7.2.8. Fetching Logs

You can fetch logs for any of the routers in the router network.

Procedure

  1. On the Dispatch Router tab, click Entities.

    A page appears displaying all of the configuration entities for the router.

  2. At the top of the folder tree, select a router from the drop-down menu.

    The configuration entities are displayed for the router you selected.

  3. Expand the log folder.
  4. Click a log, and then click Fetch.

    The log is sent to the destination defined in its Output attribute.

7.2.9. Creating SSL/TLS Profiles

You can create SSL/TLS profiles to enable a router’s network connections to be secured.

Prerequisites

Before you can set up SSL/TLS, you must have the following files in PEM format:

  • An X.509 CA certificate (used for signing the router certificate for the SSL server authentication feature).
  • A private key (with or without password protection) for the router.
  • An X.509 router certificate signed by the X.509 CA certificate.

Procedure

  1. On the Dispatch Router tab, click Entities.

    A page appears displaying all of the management entities for the router.

  2. At the top of the folder tree, select a router from the drop-down menu.

    The management entities are displayed for the router you selected.

  3. Click sslProfile.
  4. On the toolbar, click Create.

    The attributes become editable.

  5. Update the attributes as needed.

    At a minimum, you must update the Name to ensure that this SSL/TLS profile is unique. You can hover over an attribute to see a definition of the attribute.

    For additional information about SSL/TLS profiles, see Setting Up SSL for Encryption and Authentication in Using AMQ Interconnect.

  6. Click Create.

7.2.10. Deleting SSL/TLS Profiles

You can delete SSL/TLS profiles that you no longer want to use.

Procedure

  1. On the Dispatch Router tab, click Entities.

    A page appears displaying all of the management entities for the router.

  2. At the top of the folder tree, select a router from the drop-down menu.

    The management entities are displayed for the router you selected.

  3. Click sslProfile.
  4. Click the SSL/TLS profile you want to delete.

    The SSL/TLS profile is displayed with all of its attributes.

  5. On the toolbar, click Delete.

Revised on 2017-10-25 13:55:54 EDT