Search <book_title>...

Veritas NetBackup™ Troubleshooting Guide

Last Published: 2019-07-01

Product(s): NetBackup (8.2)

Restoring disaster recovery package on Windows

After a disaster, you need to restore disaster recovery package corresponding to the catalog backup that you want to restore. Disaster recovery package gets the master server host identity back. You need to restore the host identity before you perform catalog recovery.

Important notes

In a clustered master server setup:
- The disaster recovery package contains the identity files and configuration only for the virtual name.
- After the DR installation, the virtual name's certificate is restored.
- Cluster node-specific certificates and configuration options are not backed up and therefore are not recovered. You need to redeploy or reconfigure NetBackup or external certificates after the DR installation.

Prerequisites

If external CA-signed certificates are used in your NetBackup domain, ensure the following:

The certificate file path is configured, accessible, and is the same as the one that was backed up.
You have configured the required certificate revocation lists (CRL) before you begin the disaster recovery installation, if applicable.
Refer to the NetBackup Security and Encryption Guide.
You have copied the required external certificates in Windows certificate store, if applicable.
If an external certificate was configured on the master server before the disaster and DR installation fails, you can set the environment variable called DR_PKG_MARKER_FILE to enable you to correct the external certificate configuration towards the end of the DR installation.
See About the DR_PKG_MARKER_FILE environment variable.

To restore the disaster recovery package during NetBackup installation

Start the NetBackup software installation.
Refer to the Installing server software on Windows systems section from the NetBackup Installation Guide.
On the NetBackup License Key and Server Type screen, select the Disaster Recovery Master Server option.
On the NetBackup Disaster Recovery screen, specify the location of the disaster recovery package. Click Browse to select the package location that you want to restore.
Specify the passphrase that is associated with the disaster recovery package that you want to restore.
Ensure that you specify the appropriate passphrase:
- If you specify a wrong passphrase or the passphrase is lost, you need to deploy security certificates on all hosts after installation. The disaster recovery package cannot be restored during installation. To restore the disaster recovery package after installation, refer to the following article:
  http://www.veritas.com/docs/000125933
- If the passphrase is validated, continue with the installation.
If external CA-signed certificates were used in your NetBackup domain at the time of catalog backup before the disaster, during the DR installation, the Installer shows a WARNING message to configure the certificate revocation list (CRL). The CRL settings are also displayed that you can configure.
- Review the value of the ECA_CRL_CHECK configuration option.
  For more information on catalog backup and external certificate configuration options, refer to the NetBackup Administrator's Guide, Volume I.
  - If the ECA_CRL_CHECK configuration option is set to DISABLE, you do not need to do the CRL configurations.
  - If the ECA_CRL_CHECK configuration option is enabled, you are prompted to configure the CRL.
    Configure the CRLs and continue with the DR installation.
- Depending on the value that is specified for the ECA_CRL_PATH option, make the required CRLs available.
  - If ECA_CRL_PATH is not specified, NetBackup uses the CRLs from CRL distribution point (CDP) of the peer host's certificate. Ensure that the URLs that are available in the CDP are accessible.
  - If ECA_CRL_PATH is specified, NetBackup uses the CRLs that are available in the directory specified for this option. Copy the valid CRLs in the directory that you specify for ECA_CRL_PATH.
- In case Windows certificate store was used to store the external CA-signed and this certificate was not backed up in the DR package, you can see a warning to configure the external CA-signed certificates. Configure the following external certificate configuration options on the master server as per the values provided in the Installer or in the corresponding disaster recovery email:
  - ECA_CERT_PATH
  - ECA_PRIVATE_KEY_PATH
  - ECA_KEY_PASSPHRASEFILE
  - ECA_TRUST_STORE_PATH
  - ECA_CRL_PATH
  For more information on catalog backup and external certificate configuration options, refer to the NetBackup Administrator's Guide, Volume I.
- In case the DR_PKG_MARKER_FILE environment variable was set before the DR installation, the installer displays a message, which conveys that the touch file exists. Once the external certificate configuration is done, delete the touch file that you have set for the DR_PKG_MARKER_FILE environment variable.
  NetBackup services are started.
Refer to the Installing server software on Windows systems section from the NetBackup Installation Guide.

To restore the disaster recovery package after NetBackup installation

Run the nbhostidentity -import -infile file_path command after NetBackup installation.
Refer to the NetBackup Commands Reference Guide.
Clean up the whitelist cache and restart the NetBackup services on all hosts in the domain.
Carry out this step to remove the NetBackup certificate files in the following scenario:
NetBackup was configured to use only external CA-signed certificates before the disaster and NetBackup was configured to use NetBackup certificates or both NetBackup and external certificates before you manually imported the disaster recovery package.
Run the following command to remove NetBackup certificate files:
configureWebServerCerts -removeNBCert