
Installation:

To install your JON Plugin Pack, perform the following steps:

1) Unzip your JON Plugin Pack.

   This will create a sub-directory in your current directory, named after the
   Plugin Pack. It will contain the plugins and this README.
  
2a) If your JON Server has not yet been installed, follow these instructions:

    1. If necessary, unzip your JON Server distribution as per the installation
       guide.
    
    2. Examine the current contents of your JON Server's plugin directory:
          
       > ls -l  <JON>/jbossas/server/default/deploy/rhq.ear.rej/rhq-downloads/rhq-plugins
   
       or,
     
       > dir    <JON>\jbossas\server\default\deploy\rhq.ear.rej\rhq-downloads\rhq-plugins
   
    3. Copy the new plugins from your unzipped Plugin Pack directory to the JON
       Server's plugin directory.
       
    4. Install the JON Server as per the installation guide.

2b) If your JON Server is already installed, follow these instructions:

    1. If running, shut down the JON Server where the plugins will be
       installed.

       Note, it is not necessary to shut down all Servers in an HA
       environment.

    2. Examine the current contents of your JON Server's plugin directory:
          
       > ls -l  <JON>/jbossas/server/default/deploy/rhq.ear/rhq-downloads/rhq-plugins
   
       or,
     
       > dir    <JON>\jbossas\server\default\deploy\rhq.ear\rhq-downloads\rhq-plugins
   
    3. Copy the new plugins from your unzipped Plugin Pack directory to the JON
       Server's plugin directory.
       
    4. Restart the JON Server.
  

The new plugins will be recognized by the Server(s) and made available to the
JON Agents.  The JON Agents update plugins at startup.  A plugin update can be
requested of a running Agent in two ways:

From the Agent command line (if running in console mode):
  
  > plugins update
    
Or, via the RHQ Agent Resource operation 'Update Plugins'.  This operation can
also be performed on a compatible group of RHQ Agent resources.
  
For more information see the latest JON documentation: http://www.redhat.com/docs/en-US/JBoss_ON/
