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

Creating or modifying the rename file

Create or modify the rename file in the following scenarios:

  • Recover the VM to the original location with modified configuration

  • Recover the VM to an alternate location

  • Recover the VM to an alternate location with modified configuration

For additional information, See Planning the recovery of a Nutanix AHV VM.

If the rename file is not available, then you must create it and save it as rename.txt on the NetBackup master server.

To set the alternate location or modify the configuration, add the following lines in the rename file in the given format:

Scenario

Line to add in the rename file

Overwrite the existing virtual machine

change overwriteexistingvm to true

Create a new UUID instead of the existing one

change retainvmuuid to false

Note:

If you set the keyword to false, the new value is set automatically.

Power on virtual machine after recovery

change poweronafterrecovery to true

Remove network interfaces

change removenetworkinterfaces to false

Retain the MAC address

change retainnicmacaddress to true

Note:

If you set the keyword to false, the new value is set automatically.

Change Virtual Machine Name

change vmname to newVMname

Recover the virtual machine to a different AHV cluster

Use the ALT_APPLICATION_SERVER keyword.

For example, ALT_APPLICATION_SERVER=FQDN.altapp.server

Recover the virtual machine to a different AHV container

change /<original_container> to /<alternate_container>

Sample rename file

The following rename.txt lets you change the VM name, VM UUID, and the MAC Address.

change vmname to newVMname
change retainvmuuid to false
change retainnicmacaddress to false

After making the required changes in the rename file, you can run the bprestore command. For more information, See Using the command line to recover Nutanix AHV virtual machines for BigData policy.

Default values of the keywords in the rename file

If you do not add the keywords in the rename file, the recovery process considers the following default values:

Keyword

Default value

poweronafterrecovery

false

overwriteexistingvm

false

removenetworkinterfaces

false

retainvmuuid

true

retainnicmacaddress

true

vmname

no change

ALT_APPLICATION_SERVER

no change