This service will be undergoing maintenance at 00:00 UTC, 2016-08-01. It is expected to last about 1 hours
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:

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. 


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.