Bug 811859

Summary: [RFE] Change to plugin pack README.txt
Product: [Other] RHQ Project Reporter: Harri Savolainen <hsavolai>
Component: PluginsAssignee: RHQ Project Maintainer <rhq-maint>
Status: NEW --- QA Contact: Mike Foley <mfoley>
Severity: unspecified Docs Contact:
Priority: medium    
Version: unspecifiedCC: hrupp
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Description Harri Savolainen 2012-04-12 02:57:59 EDT
Description of problem:

In plugin pack readme there are the following steps:
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
       > 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.

The step 3 is apparently referring to <JON>\plugins and there is not any clarifications why the step 2 has to be done. This leads user to
 to copy plugin jars directly to <JON>/jbossas/server/default/deploy/rhq.ear.rej/rhq-downloads instead of <JON>/plugins

Expected :

User to copy to files to <JON>/plugins


Just adding a hint for the right path to server plugins would do.
Comment 1 Heiko W. Rupp 2012-04-12 03:25:06 EDT
(Did we really write backslashes in the readme? )

The noted directories are correct.

JON/plugins is a shortcut, for a plugin drop box. Plugins that are put there will be copied over
to rhq.ear/rhq-downloads/rhq-plugins/ for deployment.
So it is correct to inspect the latter directory for which plugins are already there.
Comment 2 Harri Savolainen 2012-04-12 05:21:00 EDT
I just checked from the documentation for 2.4.x [0] and it states to use rhq.ear/rhq-downloads/rhq-plugins/ and so does the plugin pack README. The only execption for this with 2.4.x is <JON>/plugins/README.txt which states "here", so there is not issue here after all.


Documentation for 3.0.x [1] states to use serverRoot/jon-server-3.0.0.GA1/jbossas/server/default/deploy/rhq.ear/rhq-downloads/rhq-plugins, BUT the plugin pack README.txt states using <JON_INSTALL_DIR>/plugins and so does the <JON>/plugins/README.txt as "here".

In my opinion the path should be changed in the documentation of 3.0.x to be in line with plugin pack README.txt and the plugins drop folder README.txt. 

[0] http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/2.4/html/Installation_Guide/JON_Server_Running_The_Installer.html

[1] http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/3.0/html-single/Installation_Guide/index.html
Comment 3 Charles Crouch 2012-04-23 10:30:10 EDT
Setting medium as per Apr 16 BZ triage