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.