Description of problem: The Gatein JON Plugin is new for EPP 5.2.1, however documentation is not yet created for the plugin. Nick Scavelli is tasked with writing the draft material for the Admin Guide in the community. It will be inserted into the https://docs.jboss.org/author/display/GTNPORTAL/Admin+Guide when written. When Nick has completed his initial work, the content will need to be converted to task-based format and productized where required.
Hi Nick I've captured the requirement for JON Plugin docs in the enterprise admin guide. If you have any Wiki or draft info available now, I might be able to knock up a draft skeleton for the enterprise docs. You might be able to reuse the data in the community docs? We may end up running out of time for EPP 5.2.1, however if it is regarded as an important feature we can push an asynchronous update after the release goes out with the info added. Let me know if I can help you out, mate. Cheers Jared
Created initial RHQ documentation for GateIn here https://docs.jboss.org/author/display/GTNPORTAL/Administration+and+Monitoring. If we feel additional information is needed, lets add first to community docs then sync with product docs. May add additional instructions like how to install jon epp plugin pack.
(In reply to comment #2) > Created initial RHQ documentation for GateIn here > https://docs.jboss.org/author/display/GTNPORTAL/ > Administration+and+Monitoring. > > If we feel additional information is needed, lets add first to community > docs then sync with product docs. May add additional instructions like how > to install jon epp plugin pack. The initial content looks great, and I've made a few minor changes (mostly just condensed the tables and removed the GateIn reference.) I can roll these changes back into the Confluence docs if you like (barring limitations with Confluence formatting). Did you want to take a quick look at the docs-stage work and see if you're happy with it? http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platform/5.2/html-single/Administration_Guide/index.html (then click on Administration and Monitoring to view the changes) So what is the procedure to install the jon epp plugin pack? Do customers need to build using Maven, or is it available in the EPP binaries? And do you think it would be better to put the plugin installation information into the Installation Guide? Seems logical to have all installation information in one place, right? Cheers Jared
Technical note added. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. New Contents: GateIn JON Plug-in information was missing from the documentation when the plug-in was initially released in v5.2.1. The content has been added in to a dedicated chapter in the Administration Guide in this release.
Looks good. You can roll those changes into confluence docs as long as you keep the GateIn and RHQ wording as this is aimed for the community. I believe the epp plugin pack is shipped with JON. In the installation docs you can mention the name of the epp plugin pack "jon-plugin-pack-epp-3.1.0.zip" (depending on version of course) and that all the contents of the plugin pack need to be installed/unzipped to the JON plugin directory, and then link to JON installation. I think that would be enough.
(In reply to comment #6) > Looks good. You can roll those changes into confluence docs as long as you > keep the GateIn and RHQ wording as this is aimed for the community. > Changes incorporated.
These guides are ready for review. The changes have been staged to docs-stage, and should display as soon as docs-stage is brought back online after the mass Publican 3.0 retagging. ===Changes to the Administration Guide=== Package: JBoss_Enterprise_Portal_Platform-Administration_Guide-5.2-web-en-US-5.2.2-3.el6eng Link: http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platform/5.2/html-single/Administration_Guide/index.html#Administration_and_Monitoring Remarks: Search for "BZ#803567" for changes relating to this bug. ===Changes to the Installation Guide=== Package: JBoss_Enterprise_Portal_Platform-Installation_Guide-5.2-web-en-US-5.2.2-3.el6eng Link: http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platform/5.2/html-single/Installation_Guide/index.html Remarks: Search for "BZ#803567" for changes relating to this bug.
Technical note updated. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. Diffed Contents: @@ -1 +1 @@ -GateIn JON Plug-in information was missing from the documentation when the plug-in was initially released in v5.2.1. The content has been added in to a dedicated chapter in the Administration Guide in this release.+GateIn JON Plug-in information was missing from the documentation when the plug-in was initially released in v5.2.1. The content has been added in to a dedicated chapter in the Administration Guide in this release. Additionally, the Installation Guide has been updated with JBoss ON installation guidance.
Installation Guide 6.7. JBoss Operations Network Installation Task: Install and Configure JBoss ON. 1. "jon-server-VERSION.zip" is contained in <code> block but it's split by whitespaces after "VERSION" which breaks the whole paragraph 2. Link http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/ doesn't work. These links worked for me: https://access.redhat.com/knowledge/docs/JBoss_Operations_Network/ https://access.redhat.com/knowledge/docs/JBoss_Operations_Network/?locale=en-US Also, it probably should be mentioned in the Installation Guide that it's necessary to enable access to JMX console for JON server to interact with EPP.
(In reply to comment #10) > Installation Guide > 6.7. JBoss Operations Network Installation > Task: Install and Configure JBoss ON. > > 1. "jon-server-VERSION.zip" is contained in <code> block but it's split by > whitespaces after "VERSION" which breaks the whole paragraph > > 2. Link http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/ doesn't > work. > > These links worked for me: > https://access.redhat.com/knowledge/docs/JBoss_Operations_Network/ > https://access.redhat.com/knowledge/docs/JBoss_Operations_Network/?locale=en- > US > > > Also, it probably should be mentioned in the Installation Guide that it's > necessary to enable access to JMX console for JON server to interact with > EPP. I have made all changes as directed to the section in question. I am packaging this up today for release.