Chapter 6. Installing JBoss Agent Plug-in Packs

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. Once these plug-ins are installed on the server, they are downloaded by and available to all configured JBoss ON agents, which means that the JBoss resources can be discovered and imported into the inventory to be managed.
  1. Download the plug-in JAR files from the Customer Support Portal.
    In the Customer Support Portal, open the Downloads tab and select the Downloads item in the JBOSS ENTERPRISE MIDDLEWARE area.
  2. Select the JBoss ON for Plug-in product in the drop-down box.
  3. Download the plug-in packs.
  4. Extract the additional plug-in pack archives to a temporary location. This creates a subdirectory with the name jon-plugin-pack-plugin_name-version. For example:
    [root@server rhq-agent]# unzip jon-plugin-pack-eap-3.2.0.GA.zip -d /tmp
  5. Copy the extracted plug-in JAR files from the jon-plugin-pack-plugin_name-3.2.0.GA/ directory to the JBoss ON server plug-in directory. For example:
    [root@server rhq-agent]# cp /tmp/jon-plugin-pack-plugin_name-3.2.0.GA/*.jar /opt/jon/jon-server-3.2.0.GA/plugins
  6. 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 through 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.
  7. 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:
    [root@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.