Red Hat Training

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

5.4. Deploying Agent Plug-ins

Agent plug-in files are stored in the agentInstallDir/rhq-agent/plugins/ directory. Agent plug-ins are deployed by uploading them to the JBoss ON server, and the JBoss ON servers distribute them to the agents. As with server-side plug-ins, agent plug-ins can be deployed to a local JBoss ON server or through the JBoss ON UI.
Agent plug-ins are loaded when the agent starts. When a new agent plug-in is added, the agent can be restarted or a manual plug-in load operation launched.
Report a bug

5.4.1. Remotely Deploying Agent Plug-ins

  1. In the top menu, click the Administration tab.
  2. In the Configuration box on the left navigation bar, click the Agent Plugins link.
  3. Scroll to the Upload Plugin section at the bottom of the page.
  4. Click the Browse... button, and browse to the plug-in JAR file's location.
  5. When the plug-in to be deployed is listed in the box, click the Upload button.
  6. Once you have finished uploading agent plug-ins, use the Scan For Updates button. The update process may take several minutes depending on the size and number of resource types defined by the added plug-ins.
  7. To deploy the plug-in updates to the agents within the system, use the Update Plugins On Agents button.
    Note
    The plug-in can also be deployed by restarting each RHQ Agent or by invoking the Update All Plugins resource operation for each RHQ Agent resource:
    • Select main Inventory tab,
    • select the All Resources option from the Resources menu on the left,
    • select the name of the relevant agent,
    • create a schedule under the Operations tab.
Report a bug

5.4.2. Locally Deploying Agent Plug-ins

Each server installation has a top-level plugins/ directory. The server periodically polls this directory. Any new or updated JAR files are copied to the appropriate directory in the server configuration, and then the original JAR file is deleted from the plugins/ directory.
If the JAR file is on the same host machine as an JBoss ON server, the JAR file can just be copied into that sourceRoot/plugins/ directory and the server will deploy it.
Report a bug