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

Last Published:
Product(s): NetBackup (8.2)
  1. Introduction to NetBackup for Acropolis Hypervisor (AHV)
    1.  
      Protect AHV using NetBackup
    2. About the Hypervisor policy type to protect Nutanix AHV VMs
      1.  
        Migrating BigData policy to Hypervisor policy
    3.  
      NetBackup terminology related to the AHV backup
    4.  
      NetBackup for AHV environment
  2. Prerequisites and things to consider before using the plug-in
    1.  
      Prerequisites
    2. Things to consider before using the NetBackup plug-in for Nutanix AHV
      1.  
        NetBackup character restrictions for virtual machine names
  3. Downloading and installing the Nutanix plug-in
    1.  
      Plan the installation for Nutanix AHV
    2.  
      NetBackup server and client requirements
    3.  
      License requirements for the Nutanix AHV
    4.  
      Download the Nutanix AHV plug-in binaries
    5.  
      Install the Nutanix AHV plug-in
  4. Configuring NetBackup communication with AHV
    1.  
      Establishing communication between NetBackup and Nutanix AHV
    2. Configuring secure communication between the Nutanix Acropolis Hypervisor server and NetBackup host
      1.  
        About the nb_nutanix-ahv configuration file
      2. Managing SSL certificates through ECA framework
        1.  
          ECA_TRUST_STORE_PATH for NetBackup servers and clients
        2.  
          ECA_CRL_PATH for NetBackup servers and clients
        3.  
          VIRTUALIZATION_HOSTS_SECURE_CONNECT_ENABLED for servers and clients
        4.  
          VIRTUALIZATION_CRL_CHECK for NetBackup servers and clients
    3.  
      Adding the Nutanix Acropolis Cluster credentials for NetBackup
    4. Adding a backup host to the NetBackup master server
      1.  
        Adding a backup host to the NetBackup master access list
    5.  
      Adding a backup host to the Acropolis Cluster access list
  5. Configuring NetBackup policies for AHV
    1.  
      Creating a backup policy using the NetBackup Policies utility
    2.  
      Creating a backup policy using the NetBackup Command Line Interface
  6. Backup and recovery
    1. Back up the Nutanix AHV virtual machines
      1.  
        Basic phases in a NetBackup backup of an AHV
    2. Overview of the Nutanix AHV virtual machines recovery process
      1.  
        About recovering the Nutanix AHV virtual machines
      2.  
        Planning the recovery of a Nutanix AHV VM
      3.  
        Recovering a Nutanix AHV VM using the Backup, Archive, and Restore console
      4.  
        About recovering AHV VMs from the images that are backed up using NetBackup versions 8.1, 8.1.1, or 8.1.2
      5. Recovering a Nutanix AHV VM using the command line for Hypervisor policy
        1.  
          Creating or modifying the rename file
        2.  
          Using the command line to recover Nutanix AHV virtual machines for Hypervisor policy
  7. Troubleshooting issues
    1.  
      Troubleshooting issues related to AHV backup
    2.  
      NetBackup logs
    3.  
      About errors during policy creation, restore, 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
  9. Appendix B. Protect Nutanix AHV virtual machines with BigData policy
    1.  
      Using the BigData policy to backup and restore Nutanix AHV virtual machines
    2. Recovering a Nutanix AHV VM using the command line for BigData policy
      1.  
        Creating or modifying the rename file
      2.  
        Using the command line to recover Nutanix AHV virtual machines for BigData policy

Planning the recovery of a Nutanix AHV VM

You can recover your Nutanix AHV VM using NetBackup's Backup, Archive, and Restore console or the command line interface. Planning the recovery location and the recovery options is an important pre-requisite before you start the recovery process.

About the recovery location

You have the following recovery location options:

    Table: Recovery location options

    Original location

    Alternate location

    Recover the virtual machine in the same Nutanix AHV cluster or container that was set during the backup.

    Recover the virtual machine to a different AHV cluster or container.

    You can modify or set the following configurations before recovering to the original location:

    • Overwrite the existing VM

    • Create new VM ID instead of existing one

    • Remove the network interfaces

    • Retain the MAC address

    • Power on the VM after recovery

    • Overwrite the default job priority

    You can modify or set the following configurations before recovering to the original location:

    • Change the AHV cluster

    • Change the storage container

    • Overwrite the existing VM

    • Change the VM name

    • Create new VM ID instead of existing one

    • Remove the network interfaces

      Note:

      To restore to an alternate location, you must select this option.

    • Power on the VM after recovery

    • Overwrite the default job priority

    About the recovery options

    Use the recovery options to modify the virtual machine configuration before you recover the VMs. The recovery options are available in the Virtual Machine Options dialog box in the Backup, Archive, and Restore console and must be set as the command line options or in the rename file with the command line.

    For more information about the rename file, See Creating or modifying the rename file.

    The following table describes the various recovery options for the Backup, Archive, and Restore console and the command line interface:

    Table: Recovery options for the Backup, Archive, and Restore console and the command line interface

    Recovery option - Backup, Archive, and Restore

    Recovery option or keywords - command line

    Hypervisor policy

    Description of recovery options

    Overwrite the existing virtual machine

    K

    Overwrite the existing virtual machine in the AHV cluster.

    Use the K command line option to not overwrite the existing virtual machine.

    Create new VM ID instead of existing one

    vmid

    Create a new ID for the VM that is different from the existing value that was set during the backup.

    Use the vmid command line option to retain the VM UUID.

    Note:

    If you select this option or set it to false, the new value is set automatically.

    Power on virtual machine after recovery

    vmpoweron

    Turn on the VM after recovery.

    Remove network interfaces

    vmsn

    Remove the network interface that was set for the VM during the backup.

    For command line, to remove the network interface, set the value to true.

    Retain the MAC address

    vmmacid

    Retain the MAC address that was set for the VM during the backup.

    Change Virtual Machine Name

    vmname in the rename file:

    change vmname to new_name

    Change the virtual machine name to a unique name.

    Nutanix Acropolis Cluster

    vmserver

    Set the Nutanix AHV cluster where you want to recover the virtual machine.

    Override default job priority

    NA

    Set a custom priority for the recovery job.

    Destination Container

    change 
    /<orig_container1>
    /<disk_uuid1> 
    to /<alt_container1>

    Add in the rename file.

    Select the Nutanix AHV container where you want to recover the virtual machine. You can select a different destination container for every source container.

    Note:

    Restore the disks from the same source container to the same destination container.

    For more information on using the recovery options using the command line interface, See Using the command line to recover Nutanix AHV virtual machines for Hypervisor policy.