Bug 743309

Summary: Installation guide section 1.7 is vague
Product: [Other] RHQ Project Reporter: Peter Larsen <plarsen>
Component: DocumentationAssignee: Deon Ballard <dlackey>
Status: CLOSED CURRENTRELEASE QA Contact: Mike Foley <mfoley>
Severity: medium Docs Contact:
Priority: high    
Version: 4.2CC: hrupp, rbuck
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-06-06 14:34:38 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Peter Larsen 2011-10-04 14:50:24 UTC
Description of problem:


http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/2.4/html/Installation_Guide/JON_Server_Preparation.html

States the following:
1.7. Prepping the Host Machine
Before installing JBoss ON, make sure that the machines are properly configured so that communication between servers and agents performs as expected. 


This should be rephrased to either refer to the steps to determine if a host is properly configured or refer to the sections elsewhere in the guide where this is explained.

Comment 1 Deon Ballard 2011-10-17 00:29:13 UTC
The steps to take to prep the host machine were the three sections immediately following that statement. I turned that into a bulleted list to, hopefully, make that more explicit.

http://docs.redhat.com/docs/en-US/JBoss_Operations_Network/2.4/html/Installation_Guide/JON_Server_Preparation.html

Comment 2 Peter Larsen 2011-10-17 13:38:18 UTC
Deon - I was visiting a customer who had first brought this to my attention last week and he was ecstatic :)  Looks great and easier to understand.

Comment 3 Deon Ballard 2011-11-28 17:06:03 UTC
Hooray! I like happy customers. :)

Comment 4 Robert Buck 2011-11-29 15:53:30 UTC
Verified.