Veritas NetBackup™ for Microsoft Azure Stack Administrator's Guide

Last Published:
Product(s): NetBackup (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 BAR interface to restore an Microsoft Azure Stack VM with modified metadata at a different location

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

This topic describes how to use the NetBackup Admin console's BAR interface to restore an Microsoft Azure Stack VM with modified metadata at an alternate location or another resource group on Microsoft Azure Stack.

To use the NetBackup Admin console's BAR interface to perform a restore

  1. Open the Backup, Archive, and Restore interface.
  2. On the Specify NetBackup Machines and Policy Type wizard, enter the source and destination details for restore.
    • Specify the Microsoft Azure Application Endpoint as the source for which you want to perform the restore operation.

      From the Source client for restores list, select the required Application server.

    • Specify the backup host as the destination client.

      From the Destination client for restores list, select the required backup host.

    • On the Specify NetBackup Machines and Policy Type wizard, enter the policy type details for restore.

      From the Policy type for restores list, choose BigData as the policy type for restore.

      Click Ok.

  3. Select the appropriate date range to restore the complete data set.
  4. In the Browse directory, specify the root directory ( "/") as the path to browse.
  5. From the File menu (Windows) or Actions menu (UNIX), choose Specify NetBackup Machines and Policy Type.
  6. Go to the Backup History and select the backup images that you want to restore.
  7. In the Directory Structure pane, expand the Directory.

    All the subsequent files and folders under the directory are displayed in the Contents of Selected Directory pane.

  8. Select the VM that you want to restore. Ensure that the storage account directories are selected.

    For example:

    For Managed disk VM, select all the disks under ManagedDisks.

    If you wish to change the disk property, for example, disk RG, disk name select individual disks file.

    Note:

    You must select all the metadata files and rename or modify only the metadata that you want to change.

    Select the Metadata folder and unselect and select any metadata in the contents of selection column so that all the options appear in the restore marked file dialog box.

  9. Click the selected Metadata directory, and in the Contents of Selected Directory pane, select the metadata that you want to modify.

    You can modify the following metadata:

    Metadata or property

    Description

    Default value

    Valid Value

    VmName

    Name of the VM.

    Name of the VM during backup.

    Valid VM Name that is unique in the resource group.

    PowerState

    State of the VM after restore.

    Power state of the VM during backup.

    Stopped, Deallocate, or Running

    Size

    Size of the VM in the Microsoft Azure Stack recommended format. For more information, refer to Azure Stack VM Sizes.

    Size of the VM during backup.

    Valid VM size.

    Vnet

    The virtual network that contains the VM.

    Vnet of the VM during backup.

    Virtual network in the target subscription.

    If empty value is specified, for example, Vnet, RgName-vnet if exists in target RG for VM is used.

    Nsg

    The Network Security Group of the VM.

    Nsg of the VM during backup.

    NSG in the target subscription.

    If empty value is specified, for example, Nsg, Network security group is not set for the VM.

    RgName

    Location or the resource group of the Microsoft Azure Stack VM.

    Resource Group of the VM during backup.

    Resource group that is a part of the target subscription.

    Storage Account

    The storage account that contains the unmanaged VM disks. This is part of the VHD path and not a separate metadata file.

    Storage account of the VM during backup.

    Valid storage account that is a part of the target subscription.

    SubId

    Microsoft Azure Stack subscription ID.

    Subscription ID of the VM during backup.

    Subscription ID that a NetBackup role can access.

    Boot Diagnostics

    Boot Diagnostics settings.

    If the boot diagnostics storage account that is specified during restore does not exist in the destination subscription or Azure Stack then boot diagnostics settings are disabled

    Boot diagnostics settings of the unmanaged VM during backup.

    Valid storage account that is part of the target subscription.

    UseManagedDisk

    VM has managed disk or unmanaged disks

    Managed disks setting for the backed up VM.

    Yes for VM with managed disks.

    No for VM with unmanaged disks.

    StagingStorageAccount

    Storage account to be used for creating temporary VHD file during a managed disk VM restore.

    Empty

    Valid storage account that is part of the target subscription.

    Storage Account Type

    Managed disk storage type. This is part of managed disk path and not Metadata file.

    If StorageAccountType is not detected during backup. User needs to specify it during restore

    Storage Account Type of the backed up managed disk.

    Supported Storage Account Type string by Azure Stack, for example, Standard_LRS, Premium_LRS.

    Disk RG

    Resource Group of the Managed disk. This is part of managed disk path and not Metdata file.

    Resource group of the backed up Managed disk

    Resource group that is part of the target subscription.

  10. Click Restore.
  11. In the Restore Marked Files dialog box, select Restore individual directories and files to different locations..

    Note:

    For more information about the restore scenarios, See About the restore scenarios for Microsoft Azure Stack VMs from the BAR interface.

    For every metadata value that you want to change, select the value, click Change Selected Destination(s), and in the Destination field modify the metadata value at the end of the URL.

    For example, if you want to change the VmName, change:

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

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

    Here, VMName is the key and OldVmName is the value. The metadata and its value have the Key=Value format. You must modify the value of all the metadata that you want to change.

    Changing managed disk properties

    Change 
    /3f6a2463-d473-4639-a1d0-f762c4e0371a/HeadsUp-RestoreRG20/skvm1/
    ManagedDisks:Standard_LRS/HeadsUp-RestoreRG20/
    skvm1_OsDisk_1_be667512b2a44ecfb1ffa43506aaa48c-RESTORE-1598299429 
    to 
    /3f6a2463-d473-4639-a1d0-f762c4e0371a/HeadsUp-RestoreRG20/skvm1/
    ManagedDisks:Premium_LRS/HeadsUp-RestoreRG30/osdisk_1
    

    Changing unmanaged disk storage account

    Change 
    /3f6a2463-d473-4639-a1d0-f762c4e0371a/HeadsUp-RestoreRG20/skuvm1/
    headsupsta.blob.tasz.vxi.vwx.com/vhds/skuvm1-UMD-RESTORE-1599155872.vhd 
    to 
    /3f6a2463-d473-4639-a1d0-f762c4e0371a/HeadsUp-RestoreRG20/skuvm1/
    stasub2testrgg.blob.tasz2.vxi.vwx.com/vhds/skuvm1-UMD-RESTORE-1599155872.vhd

    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 https://docs.microsoft.com/en-us/azure/azure-stack/user/azure-stack-vm-sizes.

  12. Click Start Restore.
  13. Use the Azure Stack Admin Portal to view the VM creation process.