Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

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:
Embargoed:
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.