Chapter 9. Installing and Removing JBoss Agent Plug-in Packs

Procedure 9.1. How To Install JBoss ON Agent Plug-in Packs using the Command Line or GUI

1. Download the plug-in JAR files.
   1. Load the JBoss ON Software Download page and log on using your Red Hat Network credentials.
   2. Open the Product drop-down, and select the JBoss ON for Plug-in product in the drop-down box.
   3. Select the JBoss ON for Plug-in product in the drop-down box.
   4. Download the required plug-in packs.
2. Extract the plug-in pack archives to a temporary location. This creates a subdirectory with the name jon-plugin-pack-plugin_name-version. For example:

   [jsmith@server rhq-agent]$ unzip jon-plugin-pack-eap-3.3.zip -d /tmp

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

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

4. Standalone Platforms

   Have the JBoss ON server update its plug-ins. This can be done through the JBoss ON GUI or by restarting the server.
   To load the plug-ins using the GUI:
   1. Open the Administration tab.
   2. In the Configuration area on the left, select the Agent Plug-ins link.
   3. At the bottom of the list of loaded agent plug-ins, click the SCAN FOR UPDATES button.

5. Managed Platforms

   All agents installed on managed platforms must update their plug-ins to use the newly-installed JBoss plug-ins. The agents can manually reload their plug-ins to load the new plug-ins from the agent's command prompt using the plugins command:

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

   Alternatively, if the agents have been imported into the JBoss ON inventory, this can be done in the JBoss ON GUI by scheduling an update plugins operation for an agent or a group or agents. Select the agent resource entry in the inventory, open the Operations tab, and schedule the update plug-ins operation.