Red Hat Bugzilla – Bug 811859
[RFE] Change to plugin pack README.txt
Last modified: 2012-04-23 10:30:10 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 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. __ 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 Notes: Just adding a hint for the right path to server plugins would do.
(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.
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. However, 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
Setting medium as per Apr 16 BZ triage