Bug 811859 - [RFE] Change to plugin pack README.txt
Summary: [RFE] Change to plugin pack README.txt
Status: NEW
Alias: None
Product: RHQ Project
Classification: Other
Component: Plugins
Version: unspecified
Hardware: Unspecified
OS: Unspecified
Target Milestone: ---
: ---
Assignee: Nobody
QA Contact: Mike Foley
Depends On:
TreeView+ depends on / blocked
Reported: 2012-04-12 06:57 UTC by Harri Savolainen
Modified: 2020-04-27 01:20 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Last Closed:

Attachments (Terms of Use)

Description Harri Savolainen 2012-04-12 06:57:59 UTC
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 07:25:06 UTC
(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 09:21:00 UTC
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 14:30:10 UTC
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.