Important Update: Cohesity Products Documentation

All Cohesity product documentation are now managed via the Cohesity Docs Portal: https://docs.cohesity.com/HomePage/Content/home.htm. Some documentation available here may not reflect the latest information or may no longer be accessible.

NetBackup™ for Nutanix AHV Administrator's Guide

Last Published:
Product(s): NetBackup (11.1)
  1. Overview
    1.  
      Overview of configuring and protecting AHV assets in the NetBackup web UI
  2. RBAC roles for the Nutanix AHV administrator
    1.  
      RBAC roles for the Nutanix AHV administrator
    2.  
      Assign both the Default VMware Administrator and Default AHV Administrator roles to a user
    3.  
      Create a custom role for all Nutanix AHV permissions and additional VMware asset permissions
    4.  
      Create a custom role for all VMware permissions and additional Nutanix AHV asset permissions
  3. Managing AHV clusters
    1.  
      Quick configuration checklist to protect AHV virtual machines
    2.  
      Configure secure communication between the AHV cluster and NetBackup host and Nutanix Prism Central and NetBackup host
    3.  
      Enable the iSCSI initiator service on windows backup host
    4.  
      Install the iSCSI initiator package on Linux backup host
    5.  
      Migrate Java GUI/CLI added clusters into the web UI
    6.  
      Prerequisites to configure Nutanix AHV cluster
    7.  
      About support for Nutanix segmented iSCSI network
    8.  
      Configure CHAP settings for iSCSI secure communication with AHV clusters
    9.  
      About the ports that NetBackup uses to communicate with AHV
    10.  
      Add or browse an AHV cluster
    11.  
      Remove AHV Clusters
    12.  
      Add a new Nutanix Prism Central
    13.  
      Add new Prism Central server credentials
    14.  
      Remove Nutanix Prism Central
    15.  
      Create an intelligent VM group
    16.  
      Assign permissions to the intelligent VM group
    17.  
      Update the intelligent VM group
    18.  
      Remove the intelligent VM group
    19.  
      Set CHAP for iSCSI
    20.  
      Add an AHV access host
    21.  
      Remove an AHV access host
    22.  
      Change resource limits for AHV resource types
    23.  
      Change the autodiscovery frequency of AHV assets
    24. Scan for malware
      1.  
        Scanning backup images
      2.  
        Assets by workload type
  4. Managing credentials
    1. Managing AHV cluster credentials
      1.  
        Add new cluster credentials
      2.  
        Update and validate AHV cluster credentials
    2. Managing Nutanix Prism Central credentials
      1.  
        Add new Nutanix Prism Central credentials
      2.  
        Update and validate Nutanix Prism Central credentials
    3.  
      View the credential name that is applied to an asset
    4.  
      Edit or delete a named credential
  5. Instant access
    1.  
      Prerequisites of instant access
    2.  
      Things to consider and limitations before you use the instant access feature
    3.  
      Create an instant access VM
    4.  
      Download files and folders from a VM backup image
    5. Instant access Build Your Own (BYO)
      1.  
        Prerequisites of Instant Access Build Your Own (BYO)
      2.  
        Hardware configuration requirement of Instant Access Build Your Own (BYO)
      3.  
        Frequently asked questions
  6. Protecting AHV virtual machines
    1.  
      Things to know before you protect AHV virtual machines
    2.  
      Protect AHV VMs or intelligent VM groups using Protection plan
    3.  
      Backup AHV VMs or intelligent groups using Policy
    4.  
      Protect AHV VMs within VPC
    5.  
      Protect vTPM enabled AHV VMs
    6.  
      Customize protection settings for an AHV asset
    7.  
      Modify policy for an AHV asset
    8.  
      Schedules and retention
    9.  
      Backup options
    10.  
      Prerequisite to Enable virtual machine quiescing
    11.  
      Remove protection from VMs or intelligent VM groups
    12.  
      View the protection status of VMs or intelligent VM groups
  7. Recovering AHV virtual machines
    1.  
      Things to consider before you recover the AHV virtual machines
    2.  
      About the pre-recovery check
    3.  
      Recover an AHV virtual machine
    4.  
      Recover an AHV VM within VPC
    5.  
      Recover a vTPM enabled AHV VM
    6.  
      About Nutanix AHV agentless files and folders restore
    7.  
      Prerequisites for agentless files and folder recovery
    8.  
      SSH key fingerprint
    9.  
      Recover files and folders with Nutanix AHV agentless restore
    10.  
      Recovery target options
    11.  
      Pre-recovery checks for Nutanix AHV
    12.  
      About Nutanix-AHV agent-based files and folders restore
    13.  
      Prerequisites for agent-based files and folder recovery
    14.  
      Recover files and folders with Nutanix AHV agent based restore
    15.  
      Limitations
  8. Protecting Nutanix Cloud Clusters (NC2)
    1.  
      Protecting Nutanix Cloud Clusters (NC2) on AWS
    2.  
      Protecting Nutanix Cloud Clusters (NC2) on Azure
  9. Troubleshooting AHV operations
    1.  
      Troubleshooting AHV operations: Error during creation of AHV instant access virtual machines
    2.  
      Troubleshooting tips for NetBackup for AHV
    3.  
      Error during AHV credential addition
    4.  
      Error during the AHV virtual machines discovery phase
    5.  
      Errors for the Status for a newly discovered VM
    6.  
      Error run into while backing up AHV virtual machines
    7.  
      Error while restoring AHV virtual machines
  10. API and command line options for AHV
    1.  
      Using APIs and command line options to manage, protect, or recover AHV virtual machines
    2.  
      Additional NetBackup options for AHV configuration
    3.  
      Additional information about the rename file

Troubleshooting AHV operations: Error during creation of AHV instant access virtual machines

The following table describes the problems that may occur when you try to create AHV instant access virtual machines.

Table: Error during creation of AHV instant access virtual machines

Error message or cause

Explanation and recommended action

Failed to create the VM
 in the Nutanix AHV 
cluster. Error: Already
 used VM UUID: 
<VM UUID>. Return 
value 114.
Failed to create 
an instant access 
virtual machine (VM).
(4004)

Before creating an Instant Access VM, the system checks if the VM UUID already exists in the Nutanix cluster. If it does, the recovery fails.

Workaround:

  1. Start the recovery process.

  2. Select Create Instant Access Virtual Machine.

  3. On the Recovery Options page, select Create new VM ID instead of existing one

  4. Continue the recovery and click Start Recovery.

Failed to create 
an instant 
access virtual 
machine (VM).

Error details

Only the Red Hat 
Enterprise Linux 
and SUSE Linux 
Enterprise Server 
operating systems 
are supported.

Instant Access currently supports only RHEL and SLES. If you try to recover unsupported operating system VMs, it fails.

Recommended action:

Use traditional full restore for media server with unsupported operating systems.

Failed to create an 
instant access 
virtual machine (VM).
Specification for 
create VM cannot 
be prepared, as 
RetainMacAddress 
and RemoveNetworkInterface 
can't be used 
together.

The API spec becomes invalid if both RetainMacAddress and RemoveNetworkInterface are used at the same time.

Recommended action:

Do not retain the MAC address if the Network Interface Controllers (NICs) are removed. If the MAC address needs to be retained, NIC cards must remain configured.

Failed to create an 
instant access 
virtual machine (VM).

Error details

Create instant 
access VM 
capability for 
Nutanix is supported 
from NetBackup 
11.1 and above.

You cannot create Instant Access VMs with NetBackup 11.0.0.1 and earlier versions.

Recommended action:

Ensure that the restore is completed with NetBackup version 11.1 or later.

Failed to create 
the VM in the Nutanix 
AHV cluster. 
Error: InUse: 
MAC address <MAC address> 
is in use: 18. 
Return value 114.
Failed to create 
an instant access 
virtual machine (VM).
(4004)

This occurs when the original VM still exists on the Nutanix cluster and the MAC address is already in use, causing a conflict.

Recommended action:

Ensure the original VM is deleted or powered off before instant access recovery to avoid MAC address duplication.