Bug 1386487

Summary: [Docs] [Deployment Planning Guide] Update the instructions in the section on Data Collection for RHV4 / RHEL7
Product: Red Hat CloudForms Management Engine Reporter: Suyog Sainkar <ssainkar>
Component: DocumentationAssignee: Suyog Sainkar <ssainkar>
Status: CLOSED CURRENTRELEASE QA Contact: Dayle Parker <dayleparker>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 5.7.0CC: adahms, dayleparker, hhudgeon, itewksbu, jhardy, obarenbo
Target Milestone: GA   
Target Release: 5.7.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-01-31 00:07:15 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: RHEVM Target Upstream Version:

Description Suyog Sainkar 2016-10-19 05:46:05 UTC
Description of problem:

Update the instructions in the section on Data Collection for RHV4 / RHEL7

Customer Comment: 

https://access.redhat.com/documentation/en/red-hat-cloudform
s/4.1/single/deployment-planning-guide/#comment-1106101

"There needs to be an update to "VIRTUALIZATION 3.3 AND 3.4" for 4.0 and/or a new section. The instructions are almost the same but since its RHEL 7 the port rules change and the service restart uses systemctl.

Step 6. Update the server’s firewall to accept TCP communication on port 5432: (RHV 4)
firewall-cmd --add-port=5432/tcp --permanent

Step 9. Reload the PostgreSQL configuration: (RHV 4)
systemctl reload postgresql "

Document URL: https://access.redhat.com/documentation/en/red-hat-cloudforms/4.1/single/deployment-planning-guide/#data_collection_for_rhev_33_34

Comment 2 Andrew Dahms 2016-11-08 05:44:13 UTC
Hi Suyog,

As per our conversation on IRC, I agree it makes sense to add both sets of instructions in the same section.

We may need to make a few others changes as well -

* Generalize the title to remove version numbers, and just mention the product
  name.
* Change the opening paragraph to remove the version numbers here as well, and
  add a short list outlining the versions to which the procedure applies.
  Because we now have RHEV 3.5 and RHEV 3.6 as well, maybe just the major 
  version numbers (RHEV 3.x, RHV 4.x) is enough?
* Convert the relevant steps to have sub-steps - for commands in RHEV, and for
  commands in RHV.

The final step is also currently missing a prompt mark, so we should probably be polite and add one for that as well, and the version of this for RHV as mentioned in the summary above.

Comment 4 Dayle Parker 2016-11-09 05:54:32 UTC
The changes look great, Suyog -- both branches have been merged.
Thanks so much!

Comment 6 Andrew Dahms 2016-11-17 01:43:12 UTC
*** Bug 1382697 has been marked as a duplicate of this bug. ***

Comment 7 Andrew Dahms 2017-01-31 00:07:15 UTC
This content is live on the Customer Portal.

Closing.