Configuring a NetBackup host (media server, client, or cluster node) to use an external CA-signed certificate after installation
A NetBackup host (media server or client) is configured to use an external certificate during installation or upgrade. You may choose to do the configuration after installation.
Use this section to configure a host to use an external certificate.
You can use this section to configure an external certificate for a cluster node.
See About external certificate configuration for a clustered primary server.
The configuration steps include:
Defining the external certificate configuration options
See Configuration options for external CA-signed certificates.
Ensuring that automatic enrollment is enabled - ECA_DISABLE_AUTO_ENROLLMENT is set to TRUE - or enrolling the external certificate manually for the host
See Enrolling an external certificate for a remote host.
The enrolled certificate is used for communication between the host and the primary server domain that is listed in the SERVER configuration option on the host.
The enrolled certificate is used for host communication.
See Viewing external CA-signed certificates in the NetBackup web UI.
Ensure that the NetBackup domain is enabled to use external CA-signed certificates by configuring the NetBackup web server.
See Configuring an external certificate for the NetBackup web server.
It is recommended that you enroll an external certificate for the primary server host before you enroll one for other hosts.
See Configuring the primary server to use an external CA-signed certificate.
Ensure that the certificate revocation lists (CRLs) for the external CA are stored at the required location.
If CRL distribution point (CDP) is used, ensure that the URLs that are specified in the CDP are accessible.
To configure a host (media server or client) to use an external certificate
- Update the configuration file (
bp.conffile or Windows registry) with the required external certificate-specific parameters on the host:See Configuration options for external CA-signed certificates.
For Windows certificate store
Use the nbsetconfig command to configure the following parameters:
ECA_CERT_PATH
ECA_CRL_CHECK (optional)
ECA_CRL_PATH (optional)
ECA_CRL_PATH_SYNC_HOURS (optional)
ECA_CRL_REFRESH_HOURS (optional)
ECA_DR_BKUP_WIN_CERT_STORE (optional)
For file-based certificates
Use the nbsetconfig command to configure the following parameters:
ECA_CERT_PATH
ECA_PRIVATE_KEY_PATH
ECA_TRUST_STORE_PATH
ECA_KEY_PASSPHRASEFILE (optional)
ECA_CRL_CHECK_LEVEL (optional)
ECA_CRL_PATH (optional)
ECA_CRL_PATH_SYNC_HOURS (optional)
ECA_CRL_REFRESH_HOURS (optional)
Note:
If you have a Flex Appliance application instance, the certificate files must be stored in the following directories on the instance:
ECA_CERT_PATH, ECA_PRIVATE_KEY PATH, and ECA_TRUST_STORE_PATH:
/mnt/nbdata/hostcert/ECA_CRL_PATH:
/mnt/nbdata/hostcert/crl - Ensure that the ECA_DISABLE_AUTO_ENROLLMENT option is set to TRUE using the nbgetconfig command. This ensures that automatic enrollment is enabled.
If the option is disabled and you want to manually enroll the certificate, run the following command on the host to enroll an external certificate with the primary server domain that is defined in the SERVER configuration option on the host:
nbcertcmd -enrollCertificate
See About viewing enrollment status of primary servers.
For more details on the command, refer to the NetBackup Commands Reference Guide.