Bug 1308434

Summary:	The Deployment Planning Guide is ambiguous in several areas
Product:	Red Hat CloudForms Management Engine	Reporter:	Peter McGowan <pmcgowan>
Component:	Documentation	Assignee:	Red Hat CloudForms Documentation <cloudforms-docs>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Red Hat CloudForms Documentation <cloudforms-docs>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	5.5.0	CC:	adahms, jhardy, mfeifer, obarenbo
Target Milestone:	GA
Target Release:	cfme-future
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:	doc
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-05-09 01:58:34 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:

Description Peter McGowan 2016-02-15 08:50:52 UTC

Document URL: 
https://access.redhat.com/documentation/en/red-hat-cloudforms/4.0/deployment-planning-guide/deployment-planning-guide

Section Number and Name: 
Security: PORTS USED BY CLOUDFORMS MANAGEMENT ENGINE. The port numbers are not displayed correctly (the numbers are line-wrapped mid-number which is confusing), and not all ports seem to be mentioned when compared to https://access.redhat.com/articles/417343 (Ports used by Red Hat CloudForms Management Engine 5.1 and above)

Also in section 4.3. DATA COLLECTION FOR RED HAT ENTERPRISE VIRTUALIZATION 3.3 AND 3.4

This is also ambiguous, given that RED HAT ENTERPRISE VIRTUALIZATION 3.5 is the current version when CloudForms 4.0 was released. Do the procedures described in this section no longer need to be applied with RHEV 3.5?


Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 2 Andrew Dahms 2017-05-09 01:58:34 UTC

Hi Peter,

Thank you for raising this bug.

I am just going through and reviewing the bugs in our queue, and wanted to address the changes that have since taken place for this one.

First, the ports table has now been moved into the Appliance Hardening Guide and is in a little better shape -

https://doc-stage.usersys.redhat.com/documentation/en-us/red_hat_cloudforms/4.2/html-single/appliance_hardening_guide/#chap_red_hat_cloudforms_security_guide_firewall

We are also having discussions with our tooling team specifically about tables and how we can improve their presentation.

The section on data collection for RHV has also since been updated to now include instructions for RHEV 3.X and RHV 4.X, and we have a Support Matrix document that talks more about support for specific versions.

I'll close this one now, but let us know if you have any further feedback.

Kind regards,

Andrew