Bug 1138686

Summary: JBoss ON Installation Guide should be updated to include preferred directory structure when installing JBoss ON components
Product: [JBoss] JBoss Operations Network Reporter: bkramer <bkramer>
Component: DocumentationAssignee: Jared MORGAN <jmorgan>
Status: CLOSED CURRENTRELEASE QA Contact: Mike Foley <mfoley>
Severity: unspecified Docs Contact: Jared MORGAN <jmorgan>
Priority: unspecified    
Version: JON 3.2CC: dlackey, jshaughn, mmurray, myarboro
Target Milestone: GAKeywords: Documentation, EasyFix
Target Release: JON 3.3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
The JBoss ON Agent must be installed in a writable directory, however this was not described in the product docs. A new section in the Installation Guide describes the preferred directory structure, and is available from access.redhat.com/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.3/html-single/Installation_Guide/index.html#before-agent-install
Story Points: ---
Clone Of: Environment:
[Install Guide]
Last Closed: 2014-12-11 14:01:57 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description bkramer 2014-09-05 12:58:45 UTC
Description of problem:

The JBoss ON Agent should be installed in a writable directory. This information is provided in community product - see [1].


[1] https://docs.jboss.org/author/display/RHQ/RHQ+Agent+Installation#RHQAgentInstallation-InstallTheAgentInAWritableDirectory

Version-Release number of selected component (if applicable):
JBoss ON 3.2

How reproducible:


Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:

Comment 2 Jared MORGAN 2014-10-02 23:19:31 UTC
I feel this should be an Easy Fix for the Installation Guide. Commit for 3.3 GA.

Comment 3 Jared MORGAN 2014-10-08 02:16:39 UTC
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.3/html-single/Installation_Guide/index.html#before-agent-install contains the new section (or search for BZ#1138686 in html-single)

svn commit -m "BZ#1138686 - Created a section to capture the guidance in https://docs.jboss.org/author/display/RHQ/RHQ+Agent+Installation#RHQAgentInstallation-InstallTheAgentInAWritableDirectory. I did a search for &quot;RHQ_AGENT_HOME&quot; to find the filename location of the environment variable. This must be verified to ensure the guidance I put in the second para is correct."
Sending        en-US/Agent.xml
Sending        en-US/Revision_History.xml
Sending        publican.cfg
Transmitting file data ...
Committed revision 97859.

Changes will be live later my Wednesday for the docs review.

Comment 4 Jared MORGAN 2014-10-09 03:06:25 UTC
Changes passed Docs Review 8th October. Sending to ON_QA