Veritas NetBackup™ for Microsoft Azure Stack Administrator's Guide

Last Published:
Product(s): NetBackup & Alta Data Protection (9.0.0.1, 9.0)
  1. Introduction
    1.  
      Protecting Microsoft Azure Stack VMs using NetBackup
    2.  
      Backing up Microsoft Azure Stack VMs
    3.  
      Restoring Microsoft Azure Stack VMs
    4.  
      Managed disk VM
    5.  
      NetBackup for Microsoft Azure Stack terminologies
  2. Pre-requisites for configuring the Microsoft Azure Stack plug-in for NetBackup
    1.  
      Operating system and platform compatibility
    2.  
      License for Microsoft Azure Stack plug-in for NetBackup
    3.  
      Settings for Backup host in IPV6 setup
    4.  
      Time Sync with Azure Stack
    5.  
      About deployment of NetBackup to protect Microsoft Azure Stack
  3. Configuring NetBackup and Microsoft Azure Stack
    1.  
      Overview of configuring NetBackup and Microsoft Azure Stack
    2. Managing backup hosts
      1.  
        Whitelisting a backup host on NetBackup master server
    3.  
      Adding a Microsoft Azure Stack custom role to provide access permissions to NetBackup administrator
    4. Configuring the Microsoft Azure plug-in using the azurestack.conf configuration file
      1.  
        Whitelisting the configuration file path on NetBackup master server
    5. Creating a file that contains Microsoft Azure Stack credentials
      1.  
        Configuring proxy settings for communication with Microsoft Azure Stack AAD authentication
    6.  
      Adding Microsoft Azure Stack credentials in NetBackup
    7.  
      Creating a BigData policy for Microsoft Azure Stack using the NetBackup Policies utility
    8.  
      Stale Snapshot cleanup
  4. Performing backups and restores of Microsoft Azure Stack
    1.  
      About backing up Microsoft Azure virtual machines
    2.  
      About restoring Microsoft Azure Stack virtual machines
    3. About the restore scenarios for Microsoft Azure Stack VMs from the BAR interface
      1.  
        Considerations for Microsoft Azure Stack VM restore and recovery
    4.  
      Using the BAR interface to restore an Microsoft Azure Stack VM at the same location
    5.  
      Using the bprestore command to restore Microsoft Azure Stack VM at the same location
    6.  
      Using the BAR interface to restore an Microsoft Azure Stack VM to different location
    7. Using the BAR interface to restore an Microsoft Azure Stack VM with modified metadata at a different location
      1.  
        Conversion of Unmanaged disk VM to Managed disk VM
      2.  
        Conversion of Unmanaged disk VM backed up using old plugin to Managed disk VM
    8.  
      Using the bprestore command to restore Microsoft Azure VM with modified metadata to an alternate location
    9.  
      Using the bprestore command to restore Microsoft Azure Stack VM with modified metadata to an alternate region
  5. Troubleshooting
    1.  
      About NetBackup for Microsoft Azure debug logging
    2.  
      Known limitations for Microsoft Azure protection using NetBackup
    3.  
      Backup fails with error 6662
    4.  
      Backup fails with error 6661
    5.  
      Backup fails with error 6646
    6.  
      Backup fails with error 6629
    7.  
      Backup fails with error 6626
    8.  
      Backup fails with error 6630
    9.  
      Restore fails with error 2850
    10.  
      Backup fails with error 1
    11.  
      Adding Azure Stack credentials to NetBackup fails with error 9101
    12.  
      Adding Azure Stack credentials to NetBackup fails with error 7610

Using the bprestore command to restore Microsoft Azure Stack VM with modified metadata to an alternate region

NetBackup lets you restore Microsoft Azure Stack data to another resource group and modify the metadata. This type of restore method is also referred to as redirected restores.

To perform redirected restore for Microsoft Azure Stack

  1. Modify the values for rename_file and listfile as follows:

    Parameter

    Value

    rename_file

    Add ALT_APPLICATION_SERVER= entry to specify ARM endpoint of the alternate region

    Too update the VmName metadata, add:

    change

    /21c71fdf-3ee5-4b57-8c51-18ebe7032237/SKRG/MSvm15/Metadata/VmName=OldVmName

    to

    /21c71fdf-3ee5-4b57-8c51-18ebe7032237/SKRG/MSvm15/Metadata/VmName=NewVmName

    To change the power state of the VM, add:

    change

    /21c71fdf-3ee5-4b57-8c51-18ebe7032237/SKRG/MSvm15/Metadata/PowerState=running

    to

    /21c71fdf-3ee5-4b57-8c51-18ebe7032237/SKRG/MSvm15/Metadata/PowerState=deallocate

    The file paths must start with / (slash).

    Add a new entry for all the metadata options that you want to modify.

    Note:

    For the VM size metadata, specify the modified value in the Microsoft Azure Stack recommended format. The new VM size must be part of your subscription.

    For more information, refer to Virtual machine sizes supported in Azure Stack.

    listfile

    List of all the Microsoft Azure files to be restored

  2. To fetch the credentials information for the alternate Azure Stack:

    Add a tpconfig entry for the new Azure Stack ARM end point.

    Change the name of the generated encrypted file in /usr/openv/var/global to match the name of the source client encrypted credentials file.

    For example, if arm-end-point1.conf is the encrypted source client file and arm-end-point2.conf is the encrypted alternate client file. Make a copy of arm-end-point1.conf to arm-end-point1.conf_org and then copy arm-end-point2.conf to arm-end-point1.conf before running the bprestore command.

  3. List of files can be obtained by running the following bplist command:

    bplist -S master_server -C configuration_server_01 -unix_files -R 3 -t 44 -X -s <bktime> -e <bktime> "/21c71fdf-3ee5-4b57-8c51-18ebe7032237/skrg1/bkvm15" > listfile

    Open the listfile in the editor and remove the special characters at the end of the line. Remove all the paths ending with / that correspond to directories.

  4. Run the following command on the NetBackup master server using the modified values for the mentioned parameters in step 1.

    bprestore -S master_server -D backup_host-C client -R rename_file -t 44 -X -s bktime -e bktime -L progress log -f listfile | filenames

    Where,

    -S master_server

    Specifies the name of the NetBackup master server.

    -D backup_host

    Specifies the name of the backup host.

    -C client

    Specifies a configuration server as a source to use for finding backups or archives from which to restore files. This name must be as it appears in the NetBackup catalog.

    -f listfile

    Specifies a file (listfile) that contains a list of files to be restored and can be used instead of the file names option (filenames). In listfile, list each file path must be on a separate line.

    -L progress_log

    Specifies the name of whitelisted file path in which to write progress information.

    -t 44

    Specifies BigData as the policy type.

    -R rename_file

    Specifies the name of a file with name changes for alternate-path restores.

ALT_APPLICATION_SERVER=management.vtsz2.vxi.vs.com

change /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/BootDiagnostics=hupsta
to /3f6a2463-d473-4639-a1d0-f762c4e0371a/HeadsUp-RestoreRG20/skuvm1/Metadata/BootDiagnostics=stasub2testrgg

change /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/Nsg=HUp-RestoreRG20-nsg
to /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/Nsg=rs-md-21-nsg

change /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/RgName=HUp-RestoreRG20
to /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/RgName=rshney-perf-set6

change /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/
SubId=3f6a2463-d473-4639-a1d0-f762c4e0371a
to /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/
SubId=b326ed58-7537-4c81-b2ac-5b16d6a524b3

change /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/VmName=skuvm1
to /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/VmName=skuvm1-restore2

change /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/Vnet=HUp-RestoreRG20-vnet
to /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/Metadata/Vnet=rshney-perf-set6-vnet

change /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/HUpsta.blob.vtszs1.vxi.vs.com/vhds/
skuvm1-UMD-RESTORE-1599155872.vhd
to /3f6a2463-d473-4639-a1d0-f762c4e0371a/HUp-RestoreRG20/skuvm1/stasub2testrgg.blob.vtszs2.vxi.veritas.com/
vhds/skuvm1-UMD-RESTORE-1599155872.vhd