Bug 1383602

Summary: Capsule certificate installation duplication and capsule cert create workflow unclear
Product: Red Hat Satellite Reporter: Peter Vreman <peter.vreman>
Component: DocumentationAssignee: Russell Dickenson <rdickens>
Status: CLOSED CURRENTRELEASE QA Contact: Brandi Munilla <bmcelvee>
Severity: medium Docs Contact:
Priority: medium    
Version: 6.2.2CC: adahms
Target Milestone: Unspecified   
Target Release: Unused   
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: 2016-11-04 05:11:31 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:
Bug Depends On:    
Bug Blocks: 1122832    
Attachments:
Description Flags
Red Hat Satellite "Installation Guide" revised version with changes from BZ1249288 none

Description Peter Vreman 2016-10-11 08:11:00 UTC 
Document URL:  https://access.redhat.com/documentation/en/red-hat-satellite/6.2/paged/installation-guide/chapter-4-installing-capsule-server

Section Number and Name:  4.7.5

Describe the issue: 

"Configuring Capsule Server with a Custom Server Certificate Before Running the Installer" contains duplicate steps 1-4 that are the same as already in 4.6.1. The duplicated texts are in some parts even better. E.g. the 'You must have installed the katello-ca-consumer-latest package' has a command in 4.7.5 and not in 4.6.1.

the in the part 'Configure Capsule with a Custom Server Certificate After Running the Installer' there comes generating the certs tar with custom capsule certificates. Why is this not needed in the step before insatllation described before?


Suggestions for improvement: 
Remove duplication were needed. Keep the certificate installation on the capsule to be only the additional part. At least the 

Improve work flow when custom capsule certificates need to be generated and used.


Additional information:
Comment 1 Andrew Dahms 2016-10-13 01:30:59 UTC 
Assigning to Russell for review.
Comment 4 Russell Dickenson 2016-10-17 22:27:07 UTC 
Attention: Peter Vremen

I have recently been working to improve the documentation of using custom certificates on Red Hat Satellite Server 6.2. I have attached a version of the updated Installation Guide, in PDF format. Please review the following sections and confirm whether or not your issues have been resolved. Any other feedback on the updated version is also welcome.

The updated version is undergoing review by subject matter experts, also peer review by fellow technical writers. Once that is complete it will be published to the Customer Portal.


3.3.1. Configuring Satellite Server with a Custom Server Certificate
4.5.1. Configuring Capsule Server with a Custom Server Certificate
Comment 5 Russell Dickenson 2016-10-17 22:29:54 UTC 
Created attachment 1211553 [details]
Red Hat Satellite "Installation Guide" revised version with changes from BZ1249288

I have attached this version of the Installation Guide, from BZ1249288, as it contains changes relevant to *this* Bugzilla ticket.