Bug 811859 - [RFE] Change to plugin pack README.txt
[RFE] Change to plugin pack README.txt
Status: NEW
Product: RHQ Project
Classification: Other
Component: Plugins (Show other bugs)
Unspecified Unspecified
medium Severity unspecified (vote)
: ---
: ---
Assigned To: RHQ Project Maintainer
Mike Foley
Depends On:
  Show dependency treegraph
Reported: 2012-04-12 02:57 EDT by Harri Savolainen
Modified: 2012-04-23 10:30 EDT (History)
1 user (show)

See Also:
Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
Last Closed:
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---

Attachments (Terms of Use)

  None (edit)
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

Note You need to log in before you can comment on or make changes to this bug.