Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

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

Red Hat JBoss Operations Network has additional agent plug-ins to handle specific JBoss resources — EWS, EDS, EAP, or SOA-P. Although these are JBoss ON resource plug-ins, they are included in separate packages and require a separate subscription to download them.
When plug-ins are installed on the server, they are downloaded by and available to all configured JBoss ON agents. This means that the JBoss resources can be discovered and imported into the inventory to be managed,
Plug-ins can be removed on all JBoss ON agents by removing the plug-in from the plug-in directory and restarting the server, or through resource management through the JBoss ON Management Console.

9.1. Installing 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.