Veritas NetBackup for Acropolis Hypervisor (AHV) Administrator's Guide

  • Last Published:
  • Product(s): NetBackup (8.1)
  1. Introduction to NetBackup for Acropolis Hypervisor (AHV)
    1.  
      Protect AHV using NetBackup
    2.  
      NetBackup terminology related to the AHV backup
    3.  
      NetBackup for AHV environment
    4.  
      Tasks to protect the AHV
  2. Prerequisites, notes, and restrictions
    1.  
      Prerequisites
    2. Notes and restrictions
      1.  
        NetBackup character restrictions for virtual machine names
  3. Download and install the Nutanix plug-in
    1.  
      Plan the installation for Nutanix AHV
    2.  
      Verify the operating system and platform compatibility
    3.  
      NetBackup server and client requirements
    4.  
      License requirements for the Nutanix AHV
    5.  
      Download the Nutanix AHV plug-in binaries
    6.  
      Install the Nutanix AHV plug-in
  4. Configure NetBackup communication with AHV
    1.  
      Establish communication between components
    2. Add a backup host to the NetBackup master server
      1.  
        Add a backup host to the NetBackup master access list
      2.  
        Configure a NetBackup Appliance as a backup host
    3.  
      Add a backup host to the Acropolis Cluster access list
    4.  
      Add the Nutanix Acropolis Cluster credentials for NetBackup
    5. Manage SSL certificates
      1.  
        Manage SSL certificates on NetBackup Appliance
    6.  
      About the nb_nutanix-ahv configuration file
  5. Configure NetBackup policies for AHV
    1.  
      About the BigData policy type
    2.  
      Create a BigData policy using the NetBackup Policies utility
    3.  
      Create a BigData policy using the Backup Policy Configuration Wizard
    4.  
      Create a BigData policy using the NetBackup Command Line Interface
  6. Backup and restore
    1. Back up the Nutanix AHV virtual machines
      1.  
        Basic phases in a NetBackup backup of an AHV
    2.  
      Restore the Nutanix AHV virtual machines
  7. Troubleshoot issues
    1.  
      Troubleshoot issues related to AHV backup
    2.  
      NetBackup logs
    3.  
      Error during policy creation and validation
    4.  
      NetBackup status codes
  8. Appendix A. NetBackup commands to backup and restore Nutanix AHV virtual machines
    1.  
      NetBackup commands for protecting the AHV

NetBackup status codes

NetBackup provides status codes to help you understand and troubleshoot issues, if they may occur.

For information about NetBackup status codes, refer to the NetBackup Status Codes Reference Guide.

Table: Status codes related to NetBackup for AHV

Problem

Recommended action

You try to run a backup job and it fails with the following message:

Unknown error <status_code>

To determine the specific issue, search the NetBackup Troubleshooter for the given status code number. The status code provides you with a problem statement and a recommended action to resolve the issue.

When the following status code is displayed:

Status 6625: The backup host is either unauthorized to complete operation or it is unable to establish a connection with the application server.

The backup host may be unauthorized to complete an operation due to one of the following reasons:

  • You may not have validated the SSL certificate from the Nutanix Acropolis cluster.

  • Alternatively, you might have a valid SSL certificate. The certificate is issued on the Fully Qualified Domain Name of the cluster. However, when you create a BigData policy, you have provided the short name for the cluster in the Application_Server parameter. Therefore, ensure that the Acropolis cluster name that you provide is the same for which the SSL certificate is issued.

See Manage SSL certificates .

When the mount operation fails with the following message in the nbaapidiscv process logs:

status_code aapi_logmsg: session_id:xxxx_ Nutanix Plugin :Failed to mount :/user/.acropolis/snapshot/containerID/vmdisk; Error: Permission denied. You may want to check whether you have added the backup host to the Nutanix Acropolis Cluster using the appropriate whitelist option available through the Prism web console or its command line interface.

The backup host is unable to mount the snapshot.

As suggested in the error message, you may want to verify whether you have added the backup host to the Nutanix Acropolis Cluster using the appropriate whitelist option available through the Prism web console or its command line interface.

See Add a backup host to the Acropolis Cluster access list.

When you try to backup the virtual machines that have volume group disks, the backup fails with following message in the nbaapidiscv process logs:

status_code aapi_logmsg: session_id: xxxx_ Nutanix Plugin: failed to get snapshot_file_path for the disk. AAPI_Errno = 6647

To determine the specific issue, search the NetBackup Troubleshooter for the given status code number. The status code provides you with a problem statement and a recommended action to resolve the issue.

Backup of the virtual machines that have volume groups attached is not supported.

When the following status code is displayed:

Error code 223: an invalid entry was encountered

This error may occur if you have provided invalid credentials to access the Nutanix Acropolis cluster.

When the following status code is displayed:

Status code 6654: Unable to retrieve the credentials for the server.

This error may occur if you have not configured the Nutanix Acropolis cluster credentials on the NetBackup master server.

This error may also occur if the backup host is unable to access NetBackup and fetch the cluster credentials.

See Add the Nutanix Acropolis Cluster credentials for NetBackup.

See Add a backup host to the NetBackup master access list.

When the following status code is displayed:

Error code 6622: An internal error occurred in the NetBackup process.

This error might occur if you do not have appropriate administrative rights for backing up AHV virtual machines.

Ensure that you have appropriate administrative rights and permissions from Nutanix to complete a backup for AHV virtual machines.

For information about NetBackup status codes, refer to the NetBackup Status Codes Reference Guide

Table of Contents

  1. Introduction to NetBackup for Acropolis Hypervisor (AHV)
    1.  
      Protect AHV using NetBackup
    2.  
      NetBackup terminology related to the AHV backup
    3.  
      NetBackup for AHV environment
    4.  
      Tasks to protect the AHV
  2. Prerequisites, notes, and restrictions
    1.  
      Prerequisites
    2. Notes and restrictions
      1.  
        NetBackup character restrictions for virtual machine names
  3. Download and install the Nutanix plug-in
    1.  
      Plan the installation for Nutanix AHV
    2.  
      Verify the operating system and platform compatibility
    3.  
      NetBackup server and client requirements
    4.  
      License requirements for the Nutanix AHV
    5.  
      Download the Nutanix AHV plug-in binaries
    6.  
      Install the Nutanix AHV plug-in
  4. Configure NetBackup communication with AHV
    1.  
      Establish communication between components
    2. Add a backup host to the NetBackup master server
      1.  
        Add a backup host to the NetBackup master access list
      2.  
        Configure a NetBackup Appliance as a backup host
    3.  
      Add a backup host to the Acropolis Cluster access list
    4.  
      Add the Nutanix Acropolis Cluster credentials for NetBackup
    5. Manage SSL certificates
      1.  
        Manage SSL certificates on NetBackup Appliance
    6.  
      About the nb_nutanix-ahv configuration file
  5. Configure NetBackup policies for AHV
    1.  
      About the BigData policy type
    2.  
      Create a BigData policy using the NetBackup Policies utility
    3.  
      Create a BigData policy using the Backup Policy Configuration Wizard
    4.  
      Create a BigData policy using the NetBackup Command Line Interface
  6. Backup and restore
    1. Back up the Nutanix AHV virtual machines
      1.  
        Basic phases in a NetBackup backup of an AHV
    2.  
      Restore the Nutanix AHV virtual machines
  7. Troubleshoot issues
    1.  
      Troubleshoot issues related to AHV backup
    2.  
      NetBackup logs
    3.  
      Error during policy creation and validation
    4.  
      NetBackup status codes
  8. Appendix A. NetBackup commands to backup and restore Nutanix AHV virtual machines
    1.  
      NetBackup commands for protecting the AHV

NetBackup status codes

NetBackup provides status codes to help you understand and troubleshoot issues, if they may occur.

For information about NetBackup status codes, refer to the NetBackup Status Codes Reference Guide.

Table: Status codes related to NetBackup for AHV

Problem

Recommended action

You try to run a backup job and it fails with the following message:

Unknown error <status_code>

To determine the specific issue, search the NetBackup Troubleshooter for the given status code number. The status code provides you with a problem statement and a recommended action to resolve the issue.

When the following status code is displayed:

Status 6625: The backup host is either unauthorized to complete operation or it is unable to establish a connection with the application server.

The backup host may be unauthorized to complete an operation due to one of the following reasons:

  • You may not have validated the SSL certificate from the Nutanix Acropolis cluster.

  • Alternatively, you might have a valid SSL certificate. The certificate is issued on the Fully Qualified Domain Name of the cluster. However, when you create a BigData policy, you have provided the short name for the cluster in the Application_Server parameter. Therefore, ensure that the Acropolis cluster name that you provide is the same for which the SSL certificate is issued.

See Manage SSL certificates .

When the mount operation fails with the following message in the nbaapidiscv process logs:

status_code aapi_logmsg: session_id:xxxx_ Nutanix Plugin :Failed to mount :/user/.acropolis/snapshot/containerID/vmdisk; Error: Permission denied. You may want to check whether you have added the backup host to the Nutanix Acropolis Cluster using the appropriate whitelist option available through the Prism web console or its command line interface.

The backup host is unable to mount the snapshot.

As suggested in the error message, you may want to verify whether you have added the backup host to the Nutanix Acropolis Cluster using the appropriate whitelist option available through the Prism web console or its command line interface.

See Add a backup host to the Acropolis Cluster access list.

When you try to backup the virtual machines that have volume group disks, the backup fails with following message in the nbaapidiscv process logs:

status_code aapi_logmsg: session_id: xxxx_ Nutanix Plugin: failed to get snapshot_file_path for the disk. AAPI_Errno = 6647

To determine the specific issue, search the NetBackup Troubleshooter for the given status code number. The status code provides you with a problem statement and a recommended action to resolve the issue.

Backup of the virtual machines that have volume groups attached is not supported.

When the following status code is displayed:

Error code 223: an invalid entry was encountered

This error may occur if you have provided invalid credentials to access the Nutanix Acropolis cluster.

When the following status code is displayed:

Status code 6654: Unable to retrieve the credentials for the server.

This error may occur if you have not configured the Nutanix Acropolis cluster credentials on the NetBackup master server.

This error may also occur if the backup host is unable to access NetBackup and fetch the cluster credentials.

See Add the Nutanix Acropolis Cluster credentials for NetBackup.

See Add a backup host to the NetBackup master access list.

When the following status code is displayed:

Error code 6622: An internal error occurred in the NetBackup process.

This error might occur if you do not have appropriate administrative rights for backing up AHV virtual machines.

Ensure that you have appropriate administrative rights and permissions from Nutanix to complete a backup for AHV virtual machines.

For information about NetBackup status codes, refer to the NetBackup Status Codes Reference Guide

Get Support