Bug 1383602 - Capsule certificate installation duplication and capsule cert create workflow unclear
Summary: Capsule certificate installation duplication and capsule cert create workflow...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Documentation
Version: 6.2.2
Hardware: Unspecified
OS: Unspecified
medium
medium vote
Target Milestone: Unspecified
Assignee: Russell Dickenson
QA Contact: Brandi Munilla
URL:
Whiteboard:
Depends On:
Blocks: 1122832
TreeView+ depends on / blocked
 
Reported: 2016-10-11 08:11 UTC by Peter Vreman
Modified: 2019-09-25 20:38 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-11-04 05:11:31 UTC
Target Upstream Version:


Attachments (Terms of Use)
Red Hat Satellite "Installation Guide" revised version with changes from BZ1249288 (410.32 KB, application/pdf)
2016-10-17 22:29 UTC, Russell Dickenson
no flags Details

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.


Note You need to log in before you can comment on or make changes to this bug.