Bug 1417399

Summary: Incorrect section/command for generating capsule certs-tar
Product: Red Hat Satellite Reporter: Craig Donnelly <cdonnell>
Component: Docs Install GuideAssignee: Russell Dickenson <rdickens>
Status: CLOSED CURRENTRELEASE QA Contact: Charles Wood <chwood>
Severity: medium Docs Contact:
Priority: high    
Version: 6.2.7CC: adahms, cdonnell, chrobert, rdickens
Target Milestone: UnspecifiedKeywords: PrioBumpGSS
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: 2017-02-21 23:13:22 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: 1417734, 1426416    
Bug Blocks: 1420975    

Description Craig Donnelly 2017-01-28 17:57:41 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.2 - Create the Capsule Server’s Certificates Archive File

Describe the issue: 

Incorrect instructions documented for creating the certs-tar for a capsule.
Section as it exists:

C. Run the resulting command on the Satellite Server. The key parameter in this command is --certs-update-server, which indicates that the existing certificates are to be updated.

# capsule-certs-generate --capsule-fqdn "capsule.example.com"\
  --certs-tar  "/root/sat_cert/capsule_certs.tar"\
  --server-cert "/root/sat_cert/satellite_cert.pem"\
  --server-cert-req "/root/sat_cert/satellite_cert_csr.pem"\
  --server-key "/root/sat_cert/satellite_cert_key.pem"\
  --server-ca-cert "/root/sat_cert/ca_cert_bundle.pem"\
  --certs-update-server

Suggestions for improvement: 

Remove section C, as this is false for creating a certs-tar used for a capsule. '--certs-update-server' is not going to have any effect on a freshly created certs bundle, especially one not related to the Satellite.

Remove --certs-update-server from the command.

If the command is run with --certs-update-server now and the folder for the hostname of the capsule doesn't exist, the command will fail out with a traceback. If we remove this option, it will perform its job correctly.

Comment 10 Andrew Dahms 2017-02-21 23:13:22 UTC
This content is live on the Customer Portal.

Closing.