JBoss Community Archive (Read Only)

RHQ 4.9

Plugins - Checklists

Tasks per Resource Type in a Plugin

Plugin Descriptor Metadata
images/author/images/icons/emoticons/check.gif Define the resource type in the plugin descriptor, specifying general information on the resource type such as name and description.
images/author/images/icons/emoticons/check.gif Specify the name of the class that will be used to discover resources of this type.
images/author/images/icons/emoticons/check.gif Specify the name of the class that will be used to connect to and provide hooks for any subsystems in use.
images/author/images/icons/emoticons/check.gif Add metadata to describe which subsystems the plugin will support for the resource type, such as indicating what properties may be used to configure the resource or what operations may be executed.

Code Implementations
images/author/images/icons/emoticons/check.gif Implement the class that will perform discovery of resources (the name of this class is indicated in the metadata above).
images/author/images/icons/emoticons/check.gif Implement the class that will connect to the resource (resource component). There will be one instantiation of this class for each resource of this type that is discovered.
images/author/images/icons/emoticons/check.gif Implement the required interfaces on the resource component for each subsystem indicated in use by the plugin descriptor. In other words, if the plugin descriptor indicates the resource can be configured, the configuration interface must be implemented by the resource component for this resource type.

Packaging Structure Checklist

images/author/images/icons/emoticons/check.gif Include plugin descriptor with the correct name and location
images/author/images/icons/emoticons/check.gif Include compiled classes for the plugin API interfaces and any supporting classes
images/author/images/icons/emoticons/check.gif Optional: Include any dependency JARs and files in the correct location

Plugin Deployment Checklist

images/author/images/icons/emoticons/check.gif Copy the plugin file to the plugins directory on the RHQ server
images/author/images/icons/emoticons/check.gif Get the agent to download the plugin by doing one of the following:

  • restarting the agent

  • execute the "plugins update" command in the agent console

  • execute the agent's Update Plugins operation (only if you have the RHQ Agent imported in inventory)

Skeleton Plugin Template Changes

images/author/images/icons/emoticons/check.gif Changes to the pom.xml file

  • Rename the artifactId and groupId

  • Change the name attribute to reflect the new plugin

  • Optional: Change the description attribute to reflect the new plugin

  • Optional: Select a logging framework dependency (see descriptor for more details)

  • Optional: Add any dependencies the new plugin requires

images/author/images/icons/emoticons/check.gif Remove or rename and modify the sample resource types from the plugin descriptor
images/author/images/icons/emoticons/check.gif Once the references to the sample code components are removed from the plugin descriptor, those classes may be deleted

JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-13 07:57:29 UTC, last content change 2013-09-18 19:42:09 UTC.