Veritas NetBackup™ for Nutanix Acropolis Hypervisor (AHV) Administrator's Guide
- Introduction to NetBackup for Acropolis Hypervisor (AHV)
- Prerequisites and things to consider before using the plug-in
- Downloading and installing the Nutanix plug-in
- Configuring NetBackup communication with AHV
- Adding a backup host to the NetBackup master server
- Configuring secure communication between the Nutanix Acropolis Hypervisor server and NetBackup host
- Managing SSL certificates through ECA framework
- Configuring NetBackup policies for AHV
- Backup and recovery
- Back up the Nutanix AHV virtual machines
- Overview of the Nutanix AHV virtual machines recovery process
- Recovering a Nutanix AHV VM using the command line for Hypervisor policy
- Troubleshooting issues
- Appendix A. NetBackup commands to backup and restore Nutanix AHV virtual machines
- Appendix B. Protect Nutanix AHV virtual machines with BigData policy
About errors during policy creation, restore, and validation
Table: NetBackup troubleshooting scenarios
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
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.
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.1 or later.
Thepolicy is unable to determine version of backup host.
Verify that the NetBackup client version on the backup host is older than 8.1. The NetBackup client version on the backup host must be 8.1 or later.
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.
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 whitelist using the Nutanix Prism console.
Unable to unmount a container at the end of a VM restore. The recovery operation is partially successful.
Error 6622 is displayed.
Unable to unmount the file system or cleanup the directory from </directory_path_of_mount_point> with error . You can manually complete these actions.
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 should be stored in a PEM file, and both the configuration variables cert_authority_file parameter in the nb_nutanix-ahv.conf and ECA_TRUST_STORE_PATH in bp.conf should point to the absolute path of this file.
Insecure workaround: If you are not sure whether your trust store configuration is correct, or if you are fine with disabling certificate validation for Nutanix Acropolis, you can also edit the nb_nutanix-ahv.conf file and set the enable_ssl_validations to false.
Hypervisor failed to delete the VM snapshot.
Manually delete the snapshots.
The Nutanix AHV VM restores successfully but the VM does not boot up.