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
- On the Dispatch Router tab, click Overview.
In the folder tree, click Routers.
The
Routers
page appears, displaying information about each router on the network.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
- On the Dispatch Router tab, click Overview.
In the folder tree, click Addresses.
The
Addresses
page appears, displaying information about each message address known to the router.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.3. Viewing Link Details
You can view a list of AMQP links attached to the router from clients (senders and receivers), from and to other routers in the network, to other containers (such as brokers), and from the tool itself.
Procedure
- On the Dispatch Router tab, click Overview.
In the folder tree, click Links.
The
Links
page appears, displaying information about each link attached to the router.To view additional details for a link, click a link in the table.
To sort the list of links, click a column header. To sort the links 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
- On the Dispatch Router tab, click Overview.
In the folder tree, click Connections.
The
Connections
page appears, displaying information about each connection to or from the router.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
- On the Dispatch Router tab, click Overview.
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.- Click a logging module to view its log entries.
Related Information
- Fetching Logs
- Logging Module Descriptions in Using AMQ Interconnect
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
On the Dispatch Router tab, click Topology.
The router topology is displayed.
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
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
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 theAggregate
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 therouter
). However, the values of some attributes change in real time (for example, theDelivery Count
for anaddress
), and are designated by a chart icon.- 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
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
Do one of the following:
- To create an incoming connection, click listener.
- To create an outgoing connection, click connector.
On the toolbar, click Create.
The attributes become editable.
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.
- Click Create.
7.2.2. Deleting Network Connections
You can delete incoming and outgoing network connections for a router.
Procedure
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
Do one of the following:
- To delete an incoming connection, click listener.
- To delete an outgoing connection, click connector.
Click the listener or connector that you want to delete.
The connection is displayed with all of its attributes.
- 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
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
- Click address.
On the toolbar, click Create.
The attributes become editable.
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.
- Click Create.
If this message address should be routed to a queue on a broker, add an autolink.
- In the folder tree, click autoLink.
- On the toolbar, click Create.
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
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
- Click address.
Click the message address configuration you want to delete.
The address is displayed with all of its attributes.
- On the toolbar, click Delete.
7.2.5. Creating Link Routes
You can create link routes to connect a client to a broker.
Procedure
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
Add an incoming link route:
- Click linkRoute.
On the toolbar, click Create.
The attributes become editable.
-
Set the
Dir
toIn
. Update the remaining attributes as needed.
At a minimum, you must update the
Name
to ensure that this link route is unique. You can hover over an attribute to see a definition of the attribute.For additional information about link routing, see Configuring Link Routing in Using AMQ Interconnect.
- Click Create.
Repeat Step 3 to create an outgoing link route.
For this link route, the
Dir
should be set toOut
.
7.2.6. Deleting Link Routes
To delete a link route, you should delete both the incoming and outgoing link route entities.
Procedure
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
- Click linkRoute.
Click the incoming link route you want to delete.
The link route is displayed with all of its attributes.
- On the toolbar, click Delete.
- Click the outgoing link route.
- 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
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
- Click log.
- Click a logging module, and then click Update.
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.
- Click Update.
Related Information
- Logging Modules You Can Configure in Using AMQ Interconnect
7.2.8. Fetching Logs
You can fetch logs for any of the routers in the router network.
Procedure
On the Dispatch Router tab, click Entities.
A page appears displaying all of the configuration entities for the router.
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.
-
Expand the
log
folder. Click a log, and then click Fetch.
The log is sent to the destination defined in its
Output
attribute.
Related Information
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
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
- Click sslProfile.
On the toolbar, click Create.
The attributes become editable.
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.
- Click Create.
7.2.10. Deleting SSL/TLS Profiles
You can delete SSL/TLS profiles that you no longer want to use.
Procedure
On the Dispatch Router tab, click Entities.
A page appears displaying all of the management entities for the router.
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.
- Click sslProfile.
Click the SSL/TLS profile you want to delete.
The SSL/TLS profile is displayed with all of its attributes.
- On the toolbar, click Delete.
Revised on 2017-10-25 13:55:54 EDT