Using JON with AMQ Broker

Red Hat AMQ 7.3

For Use with AMQ Broker 7.3


This document describes how to install the AMQ Broker plug-in for JBoss Operations Network (JON) and how to discover, import, and view resources by using the JON interface.

Chapter 1. Overview

JBoss Operations Network (JON) is an enterprise, Java-based administration and management platform that you can use to develop, test, deploy, and monitor JBoss middleware applications. JON is based on RHQ. When using the JON platform to manage AMQ Brokers, the system comprises three components:

  • JON server
  • JON agent
  • Plug-in pack

The AMQ Broker plug-in is a connector that enables the JON Agent to collect information about the message brokers running in your JBoss environment.

1.1. Key Features

With the AMQ Broker plug-in for JON, you can:

  • Discover and maintain an inventory of AMQ Brokers.
  • Store, manage, and update AMQ Broker configurations.
  • Detect configuration change, correlate them with performance history, and roll back.
  • Automate and schedule execution of operations for managed resources and resource groups.

1.2. Supported Configurations

The supported configurations for both AMQ broker and JON server apply when you are using them together. Ensure that your systems align with the configurations documented in the following Knowledgebase articles:

Chapter 2. Installation

This chapter describes the prerequisites for installing the AMQ Broker plug-in and the process for obtaining and installing it.

2.1. Prerequisites

Before you can install the AMQ Broker plug-in, the following components must be installed, configured, and running:

  • JBoss ON Server
  • AMQ Broker
  • JON Agent

Related information

2.2. Downloading and Installing the AMQ Broker Plug-in

JON uses plug-ins to handle specific JBoss resources, such as AMQ or EAP, and other applications. JON resource plug-ins are distributed in “plug-in packs” that are distributed separately from the JON Server and JON Agents. Plug-in packs may also require a separate subscription to download them.

When you install a plug-in pack on the JON server, its contents are available for download by JON agents. As a result, JBoss resources can be discovered and imported into the inventory to be managed.

To download and install the plug-in pack, complete the following steps:

  1. Log in to the Red Hat Customer Portal and navigate to the Software Download page.
  2. Select JBoss ON for AMQ from the Product drop-down menu. The Software Downloads page reloads and displays available releases.
  3. Select Download. A dialog prompts you to open or save the zip archive file.
  4. Save the zip archive and extract the files to a temporary directory, for example:

    [smith@server rhq-agent]$ unzip -d /tmp

    This creates a subdirectory with the name jon-plugin-pack-3.3.

  5. Copy the extracted plug-in JAR files from the jon-plugin-pack-plugin_3.3/ directory to the JBoss ON server plug-in directory. For example:

    [root@server rhq-agent]# cp /tmp/jon-plugin-pack-plugin_3.3/*.jar /opt/jon/jon-server-3.3.GA/plugins

2.3. Updating the Plug-ins on the JON Server

On stand-alone platforms, prompt the JBoss ON server to update its plug-ins by either restarting the server or by using the JON web interface, as follows:

  1. Click Administration > Configuration > Agent Plugins.
  2. Click Scan For Updates in the bottom left corner.
  3. Locate Red Hat JBoss AMQ 7 in the list of agent plug-ins and verify that the Last Updated timestamp is current.

On managed platforms, you can prompt agents to manually reload their plug-ins by using the plugins command:

[jsmith@server ~]$ agentRoot/rhq-agent/bin/ > plugins update

Alternatively, if the agents are imported into the JON inventory, this can be done in the JON GUI by scheduling an update plugins operation for an agent or a group of agents. To do so, select the agent resource entry in the inventory, open the Operations tab, and schedule the update plug-ins operation.

Related information

JON 3.3 Installation Guide

Chapter 3. Configuration

3.1. Configuring Authorization

AMQ Broker has role based access control (RBAC) that is used to restrict access to the attributes and methods of MBeans. For instructions on how this is configured see Configuring AMQ Broker.

If the broker is configured to use RBAC then the JON plugin must be configured with the correct username and password so that the plugin can authenticate against the broker. Once authenticated any access to MBeans will be restricted based on the BROKER_INSTANCE_DIR/etc/management.xml configuration file.

The JON plugin’s default user is 'admin' and default password is 'activemq'. You can configure the plugin to use a different user/password to connect to the broker. When the JON plugin is being initiated, it loads the JMX credentials from a configuration file located at BROKER_INSTANCE_DIR/etc/org.jboss.rh-messaging.amq.jon.cfg

This configuration file will look something like this.

principal = username
credentials = password
connectorAddress = service:jmx:rmi:///jndi/rmi://localhost:11099/jmxrmi

This configuration file also contains the connectorAddress property which is the JMX address that the plugin will use to connect to the broker.

3.2. Populating the Inventory

The Inventory is where all manageable resources and groups are shown. To populate the AMQ Broker resources, perform the following steps:

  1. Click Resources > Discovery Queue in the left navigation pane. At least one resource, an AMQ Broker instance, is displayed in the Discovery Queue window.
  2. Expand the broker resource entry by clicking the down arrow in the Resource Name column. Sub-entries for at least two servers are displayed, including the AMQ 7 Server and the JMX server. The AMQ 7 Server is the entity for which we need to populate the inventory.
  3. In the Resource Name column, click the checkbox next to the AMQ 7 Server sub-entry. Note that the Import and Ignore buttons are enabled in the bottom left part of the window. Click Import.
  4. A Question dialog opens and asks if you want to discover the platform children. Click Yes. You should see a confirmation message stating that the resources were successfully imported.
  5. Verify that the import was successful by clicking Resources > Platform in the left navigation pane. You should see multiple entries running in the Platforms window, such as the AMQ Server and the JON Server.

Chapter 4. Management

4.1. Browsing Broker Information

Now that you’ve populated the inventory with details about your AMQ 7 Server, you can browse information about most aspects of your AMQ Broker instances. To view details about AMQ 7 Servers, perform the following steps:

  1. Click Resources > Servers - Top Level Imports to view the AMQ 7 Server in the Servers - Top Level Imports window.
  2. Double-click the AMQ 7 Server entry. The left navigation pane now displays the AMQ Server and the areas into which you can drill down to view detailed data about your message brokers, acceptors, addresses, and more.
  3. With each level you drill down into the hierarchy, the main window displays detailed information specific to the AMQ Server you selected. In addition, the main window includes a set of tabs such as Summary, Inventory, Alerts, Monitoring, and Events that you can use to view different aspects of the entities you’ve selected on the left.

4.2. Managing Brokers

You can perform myriad monitoring, deployment, and management operations by using JON. It’s strongly recommended that you browse the JON guide titled Using JBoss Operations Network for Monitoring, Deploying, and Managing Resources to ensure that you’re taking advantage of all the benefits that JON has to offer.

Related information

Using JBoss Operations Network for Monitoring, Deploying, and Managing Resources

Appendix A. Using your subscription

AMQ is provided through a software subscription. To manage your subscriptions, access your account at the Red Hat Customer Portal.

Accessing your account

  1. Go to
  2. If you do not already have an account, create one.
  3. Log in to your account.

Activating a subscription

  1. Go to
  2. Navigate to My Subscriptions.
  3. Navigate to Activate a subscription and enter your 16-digit activation number.

Downloading zip and tar files

To access zip or tar files, use the customer portal to find the relevant files for download. If you are using RPM packages, this step is not required.

  1. Open a browser and log in to the Red Hat Customer Portal Product Downloads page at
  2. Locate the Red Hat AMQ entries in the JBOSS INTEGRATION AND AUTOMATION category.
  3. Select the desired AMQ product. The Software Downloads page opens.
  4. Click the Download link for your component.

Registering your system for packages

To install RPM packages on Red Hat Enterprise Linux, your system must be registered. If you are using zip or tar files, this step is not required.

  1. Go to
  2. Navigate to Registration Assistant.
  3. Select your OS version and continue to the next page.
  4. Use the listed command in your system terminal to complete the registration.

To learn more see How to Register and Subscribe a System to the Red Hat Customer Portal.

Revised on 2019-05-07 15:49:38 UTC

Legal Notice

Copyright © 2019 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.