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:
- 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
jon-plugin-pack-3.3.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 plugins command:
[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.
Related information
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.