About errors during policy creation, restore, and validation
Table: NetBackup troubleshooting scenarios
Problem | Recommended action |
|---|---|
The policy validation or the backup job fails when you have provided invalid or empty value in the backup selection. | Enter the following parameters in backup selections:
|
The backup job fails when the backup selection does not contain the Backup_Host parameter. | Add the Backup_Host parameter to the backup selections as follows: Backup_Host=Fully Qualified Domain Name or the IP address |
The backup job fails when you provide an invalid or an empty value when you specify clients or virtual machines to be backed up. | Enter the name of the virtual machines that you want to backup. In addition, verify that the virtual machine name is correct and meets the character restrictions. See NetBackup character restrictions for virtual machine names . |
The backup host is not reachable. | Verify the backup host name. The backup host name is the FQDN of the backup host. |
Backup fails when the NetBackup client version on the backup host is older than 8.1. | The NetBackup client version on the backup host must be 8.2 and must have the out-of-band plug-in. |
The backup job may fail when the operating system of the backup host is not Linux. | The operating system of the backup host must be Linux. |
The backup job fails when credentials are invalid or not configured for the Application_Server parameter. | Verify that you have provided correct credentials. Ensure that the value that you have provided for the Application_Server parameters matched the one that you provided while specifying Nutanix Acropolis Cluster credentials. See Adding the Nutanix Acropolis Hypervisor Cluster credentials for NetBackup. |
The recovery fails if you select recovery to the original location and the AHV container is unavailable. | Ensure that the AHV container is available, create the container, or use the alternate location option to recover the VM. |
The recovery fails and the VM is not created on the alternate cluster because of the unavailability of network connectivity. | Ensure that there is network connectivity between the NetBackup servers and AHV clusters, and retry the recovery process. |
The recovery fails if a different backup or recovery host is used than the one that was used during the backup. | Add the backup or the recovery host that you want to use during the VM recovery to the file system allowlist using the Nutanix Prism console. |
Unable to unmount a container at the end of a VM restore. The recovery operation is partially successful. The following error is displayed: Failed to unmount container %s from mount path %s OR Failed to mount restore directory |
|
When you select a Windows backup host, VM details are not displayed on the recovery wizard. The No Files Found dialog box is displayed. | Use a Linux backup host. |
The policy validation or the backup job fails when you have not provided the certificate trust store path correctly. | Ensure that the Nutanix cluster name used while adding Nutanix server in NetBackup should match with one of the subject name or alternate subject names in the certificate issued to the Nutanix cluster. Ensure that you have downloaded the root certificate of the CA issuing certificate to the Nutanix cluster, or the self-signed certificate of the Nutanix Acropolis server. This certificate must be stored in a PEM file. ECA_TRUST_STORE_PATH in bp.conf must point to the absolute path of this file. |
The Nutanix AHV VM restores successfully but the VM does not boot up. |
|
During the Nutanix AHV VM restore using the command line, the following error is displayed: Hypervisor policy restore error (2822) | When you use the command line to restore the Nutanix AHV VMs with a backup host that has NetBackup 8.2 but does not have the Nutanix AHV plug-in, the restore fails. Ensure that the plug-in is installed on the backup host that has NetBackup 8.2. |
During the Nutanix AHV VM restore using the command line, the following error is displayed: network read failed (42) | When you use the bprestore command with the -w option to restore the Nutanix AHV VMs that are backed up using the Hypervisor policy, the restore job fails. |
The restore job fails and the following error is displayed in the Activity Monitor: "The combination of the selected recovery options is invalid." | The issue occurs if the recovery option provided is not valid. This error is seen if one of the following scenarios is true:
Workaround: Ensure that the recovery option are correct before you run the restore operation. For detailed errors, refer to the log For more details, refer to the NetBackup for Nutanix AHV Administrator's Guide. |
The following errors are seen during a backup or restore operation: "Unmount operation failed." "Mount operation failed." | The issue occurs if:
Workaround: For backup failures, refer to the You might want to manually unmount the folders of a failed job. |
The restore operation is partially successful and the following error is displayed: "Post Restore cleanup is failed" | The issue occurs if:
Workaround: Restore is successful just the clean-up has failed. Refer to the |
During the policy validation for Incremental policy, if the backup host specified in policy is has NetBackup version 8.2 or earlier, the following error is displayed: "Backup host has an older version of NetBackup. Upgrade to the latest version." | For incremental backups, the NetBackup client on the backup host must be upgraded to version 8.3 or later. |
When you restore using NetBackup version 8.2 and the out-of-band plugin the restore process can fail. The following error is displayed in the activity monitor: Hypervisor policy restore error. (2822) In the <16> preRestoreVM: Failed to create: dir /usr/openv/tmp/ntxmnt/*, ret = 6647 <2> bpVMutil main: error code: 2879: invalid error number <2> bpVMutil main: EXIT STATUS 2879: invalid error number | This issue occurs in the following scenario: During the backup, a ntxmnt folder is created that is used during the restore process. If the ntxmnt folder is not available during restore, then the restore process fails. Workaround: Manually create the ntxmnt in the |
In the Hypervisor Policy > Backup Selections tab, if you delete any entry, the New button remains disabled and you are unable to re-add the entry that you have deleted. | Workaround: Close the policy without saving the changes and re-open to get the previously saved values. You can then modify the existing entries, if required. |
If a policy is created using the command line and an incremental schedule is added but the -blkincr option is not set to 1, the following error is displayed: Incorrect configuration for the incremental backup schedule. Set the correct block level incremental value for the backup policy. | Workaround: Modify the policy and set the -blkincr option to 1. |
When the target server for AIR is a Nutanix AHV server, a failed to get the container list error is seen in the Activity Monitor for a backup operation. | This error can happen when the Nutanix AHV server is not available or accessible when the backups are taken. This can be due to the following reasons:
|