Cloned from upstream: https://pagure.io/freeipa/issue/6795
The customers are often confused by ipa-cacert-manage install. The man page currently states:
- Install a CA certificate
This command can be used to install the certificate contained in
CERTFILE as an additional CA certificate to IPA.
The man page should make it clear that IPA CA is not modified in any way by this command.
[root@bkr-hv03-guest08 ~]# rpm -q ipa-server
[root@bkr-hv03-guest08 ~]# man ipa-cacert-manage | grep "install"
ipa-cacert-manage [OPTIONS...] install CERTFILE
When the IPA CA is subordinate of an external CA, the renewal process involves submitting a CSR to the external CA and installing the newly issued certificate in IPA, which cannot be done
This command can be used to install the certificate contained in CERTFILE as an additional CA certificate to IPA.
Important: this does not replace IPA CA but adds the provided certificate as a known CA. This is useful for instance when using ipa-server-certinstall to replace HTTP/LDAP certificates with third-party certificates signed by this additional CA.
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.
For information on the advisory, and where to find the updated
files, follow the link below.
If the solution does not work for you, open a new bug report.