Veritas NetBackup™ 故障排除指南

要解决配置 NetBackup KMS 的设置中的备份失败问题，请执行以下操作

1. 如果 NetBackup 策略配置为使用磁带、AdvanceDisk 或云存储，请检查作业详细信息。如果看到任何错误，请参考 NetBackup 状态码参考指南。

   例如，对于磁带存储类型，“作业详细信息”选项卡中可能会显示以下错误：

   Mar 27, 2020 5:20:40 PM - Error bptm (pid=11143) KMS failed with error status: Error details : 
   Error Code : 1298, Error Message : Cannot communicate with one or more key management servers., 
   Server - example.master.com:0, Error code - 25, .    
   Mar 27, 2020 5:20:40 PM - Info bptm (pid=11143) EXITING with status 83 <----------    
   Mar 27, 2020 5:20:43 PM - Info bpbkar (pid=11132) done. status: 83: media open error

2. 在主服务器上运行以下命令，验证是否配置了 NetBackup KMS：

   Install_Path/bin/nbkmscmd -listKMSConfig -name nbkms

   如果未列出 NetBackup KMS 配置，请检查 nbkms 服务是否正在运行。

   • 如果 nbkms 服务正在运行，请运行以下命令，以添加 nbkms 服务配置：

     Install_Path/bin/nbkmscmd -discoverNBkms

   • 如果 nbkms 服务未运行，请检查位于以下位置的 nbkms 日志：

     在 UNIX 上 - /usr/openv/logs/nbkms

     在 Windows 上 - Install_Path\NetBackup\logs\nbkms

     检查是否在 KMS 服务器上使用所需密钥组创建了密钥。

3. 使用以下命令验证 NetBackup KMS 配置：

   Install_Path/bin/nbkmscmd -validateKMSConfig -name KMS_configuration_name

4. 使用以下命令检查是否至少列出了一个活动密钥：

   Install_Path/bin/nbkmscmd -listKeys -name KMS_configuration_name -keyGroupName key_group_name

5. 如果没有列出密钥，请使用所需的密钥组创建密钥，并清除介质服务器上的缓存。运行以下命令：

   Install_Path/bin/bpclntcmd -clear_host_cache

6. 有关更多详细信息，请检查以下日志：

   对于磁带、AdvanceDisk 和云存储：Install_Path/netbackup/logs/bptm

   对于 MSDP 存储：MSDP_config_path/log/spoold/spoold.log

   对于主服务器上的 Web 服务日志：Install_path/logs/nbwebservice/<51216-495-***-***-***.log>

   对于 NetBackup KMS 的 nbkmiputil 日志：Install_Path/logs/nbkms

要解决配置外部 KMS 的设置中的备份失败问题，请执行以下操作

1. 如果 NetBackup 策略配置为使用磁带、AdvanceDisk 或云存储，请检查作业详细信息。如果看到任何错误，请参考 NetBackup 状态码参考指南。
2. 在主服务器上运行以下命令，验证是否配置了外部 KMS：

   Install_Path/bin/nbkmscmd -listKMSConfig -name KMS_configuration_name

   如果未列出配置，请配置外部 KMS 服务器。

3. 使用以下命令验证外部 KMS 配置：

   Install_Path/bin/nbkmscmd -validateKMSConfig -name KMS_configuration_name

4. 如果主服务器上存在证书文件，请运行以下命令。

   Install_Path/netbackup/bin/goodies/nbkmiputil -validate -kmsServer kms_server_name -port 5696 -certPath certificate_file_path -privateKeyPath private_key__file_path -trustStorePath ca_file_path

   输出采用 JSON 格式。

5. 检查是否在外部 KMS 服务器上使用所需密钥组创建了密钥。
6. 使用以下命令检查是否至少列出了一个活动密钥：

   Install_Path/bin/nbkmscmd -listKeys -name KMS_configuration_name -keyGroupName key_group_name

   如果没有列出密钥，请使用所需的密钥组创建密钥，并清除介质服务器上的缓存。运行以下命令：

   Install_Path/bin/bpclntcmd -clear_host_cache

7. 有关更多详细信息，请检查以下日志：

   对于磁带、AdvanceDisk 和云存储：Install_Path/netbackup/logs/bptm

   对于 MSDP 存储：PDDE_Install_Path/log/spoold/spoold.log

   对于主服务器上的 Web 服务日志：Install_Path/logs/nbwebservice/<51216-495-***-***-***.log>

   对于外部 KMS 的 nbkmiputil 日志：Install_Path/netbackup/logs/nbkmiputil

要解决还原失败问题，请执行以下操作

1. 对于磁带、AdvanceDisk 和云存储，请检查作业详细信息。

2. 使用以下命令验证 KMS 配置：

   Install_Path/bin/nbkmscmd -validateKMSConfig -name KMS_configuration_name

3. 如果主服务器上存在证书文件，请运行以下命令。Install_Path/netbackup/bin/goodies/nbkmiputil -validate -kmsServer KMS_server_name -port 5696 -certPath certificate_file_path -privateKeyPath private_key__file_path -trustStorePath ca_file_path

   输出以 JSON 格式显示。

4. 确保加密备份所用的密钥在 KMS 服务器上仍处于活动状态。

   在 nbwebservice 日志中查看以下错误，以获取还原所需的密钥标记。

   在主服务器上的 Web 服务日志中，查看以下日志语句：Install_path/logs/nbwebservice/<51216-495-***-***-***.log>

   以下是日志片段：

   [Debug] NB 51216 nbwebapi 495 PID:10984 TID:149 File ID:495 [No context] 5 
   	[com.netbackup.config.PeerInfoPopulatorFilter] 
   Request URL : https://<Master-Server>:1556/netbackup/security/key-management-services/keys 
   Connection Info :ConnectionInfo

   [Debug] NB 51216 nbwebapi 495 PID:10984 TID:149 File ID:495 [No context] 5 
   [com.netbackup.security.kms.resource.KMSConfigResource] 
   HTTP GET filter query string is : KeyId eq 'bdc3492b015d4a9ab25426465b12adac6a834dfc6b4449c490922d6155719958' 
    and kadlen eq 32

   [Debug] NB 51216 nbwebapi 495 PID:10984 TID:149 File ID:495 [No context] 5 
   [com.netbackup.security.kms.resource.KMSConfigResource] 
   com.netbackup.security.kms.resource.KMSConfigResource getKeys() - NBKMSRecordNotFoundException 
   occured due to missing KMS record.com.netbackup.nbkms.exception.NBKMSRecordNotFoundException: 
   security.error.kms.KeyRecordNotFound

5. 有关更多详细信息，请检查以下日志：

   对于磁带、AdvanceDisk 和云存储：Install_Path/netbackup/logs/bptm

   对于 MSDP 存储：PDDE_Install_Path/log/spoold/spoold.log

   对于主服务器上的 Web 服务日志：Install_Path/logs/nbwebservice/<51216-495-***-***-***.log>

   对于 nbkmiputil 日志：

   • 对于 NetBackup KMS，Install_Path/logs/nbkms

   • 对于外部 KMS，Install_Path/netbackup/logs/nbkmiputil