NetBackup™ Web UI Nutanix AHV Administrator's Guide

Last Published:
Product(s): NetBackup (10.3.0.1, 10.3)
  1. Overview
    1.  
      Overview of configuring and protecting AHV assets in the NetBackup web UI
  2. 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 WebUI
    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
  3. 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
  4. Protecting AHV virtual machines
    1.  
      Things to know before you protect AHV virtual machines
    2.  
      Protect AHV VMs or intelligent VM groups
    3.  
      Protect AHV VMs within VPC
    4.  
      Customize protection settings for an AHV asset
    5.  
      Schedules and retention
    6.  
      Backup options
    7.  
      Prerequisite to Enable virtual machine quiescing
    8.  
      Remove protection from VMs or intelligent VM groups
    9.  
      View the protection status of VMs or intelligent VM groups
  5. 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.  
      About Nutanix AHV agentless files and folders restore
    6.  
      Prerequisites for agentless files and folder recovery
    7.  
      SSH key fingerprint
    8.  
      Recover files and folders with Nutanix AHV agentless restore
    9.  
      Recovery target options
    10.  
      Pre-recovery checks for Nutanix AHV
    11.  
      About Nutanix-AHV agent-based files and folders restore
    12.  
      Prerequisites for agent-based files and folder recovery
    13.  
      Recover files and folders with Nutanix AHV agent based restore
    14.  
      Limitations
  6. Troubleshooting AHV operations
    1.  
      Troubleshooting tips for NetBackup for AHV
    2.  
      Error during AHV credential addition
    3.  
      Error during the AHV virtual machines discovery phase
    4.  
      Errors for the Status for a newly discovered VM
    5.  
      Error run into while backing up AHV virtual machines
    6.  
      Error while restoring AHV virtual machines
  7. 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

Error run into while backing up AHV virtual machines

The following table describes the problem that might occur when you back up AHV virtual machines:

Table: Error while backing up AHV virtual machines

Error message or cause

Explanation and recommended action

After a NetBackup backup operation, the VM snapshot on the AHV cluster is not deleted.

If a disk attached to the VM is in an inactive state, then the AHV cluster does not delete the VM snapshot after a backup operation is complete.

Workaround:

  • Before the backup operation, verify the state of the disks that are attached to the VM and ensure that they are active.

  • Ensure that the disks are not attached while the VM is running, thus preventing the disk to be in an inactive state.

MSiSCSI service is disabled. Enable the MSiSCSI service on the backup host.

Enable Microsoft iSCSI Initiator Service (MSiSCSI) service on the windows backup host and re-run the job.

Unable to establish a connection. Verify that the iSCSI service is installed and running.

  • For Windows: Enable Microsoft iSCSI Initiator Service on backup host.

    Note:

    This is displayed as an error only for windows OS.

  • For Linux, this error is displayed in form of a warning and it falls back to use the NFS for backup/restore. If you use segmented iSCSI data services backup/restore fails.

    Ensure that the backup host is added in Filesystem Whitelists option in Nutanix UI for backups to work via NFS transport.

    For Linux to use iSCSI: Install / Enable iSCSI Initiator package on backup host and re-run the job.

  • Validate connectivity using the following command on Linux host:iscsiadm -m discovery -t sendtargets -p correct IP as per configured iSCSITargetType

    Use following IP address based on your iSCSI transport type:

    • For iSCSI Data services: iSCSI Data services IP from cluster details page

    • For segmented: Use segmented iSCSI Data from cluster details page SEGMENTED_SPECIFIC.

    • For specified segmented: Use Virtual IP specified while configuring cluster in NetBackup.

  • Validate connectivity using the following command on Windows host:

    • Click Server Manager -> Tools -> iSCSI initiator. This opens iSCSI initiator properties dialog.

    • Click Discovery > Discovery portal and provide the IP address as per configured iSCSI Target Type for the AHV cluster.

    • DEFAULT: iSCSI Data services IP from cluster details page

    • SEGMENTED: segmented iSCSI Data from cluster details page

    • SEGMENTED_SPECIFIC: Virtual IP specified while configuring cluster in NetBackup.

  • If you get above error when flex or flex scale appliance used as Backup/Recovery host:

    • Edit the configuration to use default option which uses NFS transport.

    • Use different Backup/Recovery host which has required iSCSI and network configuration.

      • Update the protection plan to use specific Backup host.

      • Use Recovery host with required iSCSI and network configuration.

Authentication failed. Verify whether the provided initiator CHAP is correct.

Either the provided CHAP key is invalid or the iSCSI initiator name is not unique for each backup/recovery host. Please set iSCSI initiator name unique for each backup/recovery host.

Failed to get an external data service IP address for iSCSI. Re-run the job after setting IP address on the Nutanix cluster: {Nutanix AHV clusterName}.

Set the external data service IP address for iSCSI on the Nutanix AHV cluster. More details See Prerequisites to configure Nutanix AHV cluster.

Note:

For Linux it will fall back to use the NFS for backup/restore.

NetBackup version is not supported for one or more backup hosts. Use NetBackup version 9.1 or later on all Linux or Windows backup host to use the Automatic backup host option in Nutanix protection plan.

This error occurs when the Automatic option is selected for backup hosts in the Nutanix protection plan. Upgrade backup host to latest NetBackup version.

For NetBackup media server load balancing, ensure that the backup hosts have either Red Hat Enterprise Linux, SUSE Linux Enterprise Server or Microsoft Windows operating system.

This error occurs when the Automatic option is selected for backup hosts in the Nutanix protection plan.

For Nutanix AHV, supported media server are:

  • Red Hat Enterprise Linux

  • SUSE Linux Enterprise Server

  • Microsoft Windows operating system

Existing version of NetBackup on the media server does not support the incremental backup schedule.

Upgrade NetBackup to the latest version on the backup host.

Unable to set resource limit for specific Nutanix clusters.

If the clusters for which the resource limit is set are deleted from NetBackup environment, in some cases, + Add option is disabled to set the resource limit.

Recommended Action

Delete the resource limit for deleted clusters and then set the resource limit for rest of the clusters.

Snapshot jobs fail with error code 156 with the following job details:

Critical bpbrm (pid=30139) 
from client 9c5dcb07-65d2
-4761-b861-9e517edcf5b6_
<Nutanix-cluster>
vxindia.veritas.com: 
FTL - Value 2 that specifies 
GUID is not supported for 
the nameuse 

If a protection plan is created using Backup option > Select server or host to use for backups > Automatic and the selected storage unit is configured with media servers with both NetBackup 9.1 or prior versions. And when this protection plan is used to back up the AHV VMs or Intelligent VM group, the snapshot job might fail.

Recommended action

All the media servers, which are configured in the selected storage unit, must be upgraded to NetBackup 9.1.

To avoid job failures as upgrades for other media servers are in progress, in the Protection > Customize Protection > Backup options option, manually select a specific media server or backup host as a server or host to use for backups instead of default Automatic option. It is recommended to use already upgraded media server. Once upgrade of all media servers completes, use Protection > Restore Original Settings to go back to original settings.

Error 1

iscsiadm: Could not login 
to [iface: default, target: 
iqn.2010-06.com.nutanix:
nbubackup -2d29da9d-f964-
4157-9595-f0319090bb01-tgt0,
 portal: xx.xx.xx.xx,3260]
iscsiadm: initiator 
reported error (24 - 
iSCSI login failed due
 to authorization failure)
iscsiadm: Could not log 
into all portals

Error 2

 iscsiadm: Could not execute
 operation on all records:
 encountered iSCSI database
 failure

Error 3

iscsiadm: could not 
read session targetname: 5
iscsiadm: could not find 
session info for session28

These errors are seen in the successful job details tab of backup/restore jobs. These errors are output of iscsiadm command execution. These errors are intermittent and may occur due to heavy load on the iSCSI network. NetBackup does a retry operation to fix these errors. Once retry operation is successful, backup/restore job is also successful.

Recommended action

No action is required on NetBackup side. User can still troubleshoot the iscsiadm and ensure correct iSCSI installation/configuration to avoid such errors.

iscsid: 
Ignoring CHAP algorithm 
request for MD5 due to 
crypto lib configuration 
iscsid: Couldn't 
set CHAP algorithm list

Refer In FIPS enabled environment, NetBackup backup/restore of Nutanix AHV VMs (Virtual Machines) using iSCSI fails