Chapter 2. Installation
This chapter describes the prerequisites for installing the AMQ Broker plug-in and the process for obtaining and installing it.
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
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:
- Log in to the Red Hat Customer Portal and navigate to the Software Download page.
- Select JBoss ON for AMQ from the Product drop-down menu. The Software Downloads page reloads and displays available releases.
- Select Download. A dialog prompts you to open or save the zip archive file.
Save the zip archive and extract the files to a temporary directory, for example:
[smith@server rhq-agent]$ unzip jon-plugin-pack-3.3.zip -d /tmp
This creates a subdirectory with the name
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:
- Click Administration > Configuration > Agent Plugins.
- Click Scan For Updates in the bottom left corner.
- 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
[jsmith@server ~]$ agentRoot/rhq-agent/bin/rhq-agent.sh > 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.