Veritas NetBackup for Microsoft Azure Stack Administrator's Guide

Last Published:
Product(s): NetBackup (8.2)
  1. Introduction
    1.  
      Protecting Microsoft Azure Stack VMs using NetBackup
    2.  
      Backing up Microsoft Azure Stack VMs
    3.  
      Restoring Microsoft Azure Stack VMs
    4.  
      NetBackup for Microsoft Azure Stack terminologies
  2. Installing and deploying Microsoft Azure Stack plug-in for NetBackup
    1.  
      About installing and deploying the Microsoft Azure plug-in
    2.  
      Pre-requisites for installing the Microsoft Azure plug-in
    3.  
      Operating system and platform compatibility
    4.  
      License for Microsoft Azure Stack plug-in for NetBackup
    5.  
      Downloading the plug-in
    6.  
      About deployment of NetBackup to protect Microsoft Azure Stack
    7.  
      Installing the Microsoft Azure Stack plug-in
    8.  
      Installing Microsoft Azure Stack plug-in on NetBackup Appliance
  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
    6.  
      Adding Microsoft Azure Stack credentials in NetBackup
    7.  
      Creating a BigData policy for Microsoft Azure Stack using the NetBackup Policies utility
  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 with modified metadata at an alternate location
    7.  
      Using the bprestore command to restore Microsoft Azure VM with modified metadata and an alternate location
  5. Troubleshooting
    1.  
      About NetBackup for Microsoft Azure debug logging
    2.  
      Backup fails with error 6662
    3.  
      Backup fails with error 6661
    4.  
      Backup fails with error 6646
    5.  
      Backup fails with error 6629
    6.  
      Backup fails with error 6626
    7.  
      Backup fails with error 6630
    8.  
      Restore fails with error 2850
    9.  
      Backup fails with error 1
    10.  
      Adding Azure Stack credentials to NetBackup fails with error 9101
    11.  
      Adding Azure Stack credentials to NetBackup fails with error 7610

Adding Microsoft Azure Stack credentials in NetBackup

To establish a seamless communication between Microsoft Azure Stack clusters and NetBackup for successful backup and restore operations, you must add and update Microsoft Azure Stack credentials to the NetBackup master server.

Use the tpconfig command to add credentials in NetBackup master server.

For more information about the tpconfig command, see the NetBackup Commands Reference Guide.

To add credentials in NetBackup

  1. Run tpconfig command from the following directory paths:

    On UNIX systems, /usr/openv/volmgr/bin/

  2. Run the following command by providing appropriate values for each parameter to add Microsoft Azure Stack credentials:

    tpconfig -add -application_server_user_id user_ID -application_type application_type -application_server application_server_name -password password_of_the_nbu_azst_user -host_user_id master_server_admin_user_ID -host_password master_server_admin_password -host_RSA_key host_RSA_key_value -application_server_conf "/usr/<file_path>/azurestack.creds"

    • For host_RSA_key, use a random key or number generator to get a key.

    • For AAD, NetBackup uses clientID and clientSecret, so enter the value for -application_server_user_id as dummy and -password as "dummy.

    Note:

    The user you want to add must have co-owner permissions to the subscription you want to protect.

    For example,

    tpconfig -add -application_server_user_id example_user_ID -application_type azurestack -application_server application_server_name -password password_of_the_nbu_azst_user -host_user_id master_server_admin_user_ID -host_password master_server_admin_password -host_RSA_key 4d:8f:90:bc:f6:fb:1a:b8:99:d9:ac:a6:e6:69:79:2a -application_server_conf "/usr/openv/var/global/azurestack.creds"

    Here, the numeric value 8 can also be specified for the -application_type parameter that corresponds to Microsoft Azure Stack .

  3. Run the tpconfig -dappservers command to verify if the NetBackup master server has the Azure credentials added.

    For example, here is a sample output:

    Application Server Host Name:        management.local.azurestack.external
    Application Server Type:             azurestack
    User Id:                             nbu_azst@azurestack.local
    Required Port:                       0
    User of Application Host:            root
    RSA key fingerprint:                 4d:8f:90:bc:f6:fb:1a:b8:99:d9:ac:a6:e6:69:79:2a
    
  4. After you use tpconfig to add the credentials, you can delete the credentials file from the /usr/<file_path>/azurestack.creds location.
  5. Run the following command to update or delete the tpconfig credentials:
    • Delete

      tpconfig -delete -application_server_user_id user_ID -application_type application_type -application_server application_server_name -password password_of_the_nbu_azst_user -host_user_id master_server_admin_user_ID -host_password master_server_admin_password -host_RSA_key host_RSA_key_value -application_server_conf "/usr/<file_path>/azurestack.creds"

    • Update

      To change the attributes or options in the credentials file, update the credentials and then use the tpconfig -update command.

      tpconfig -update -application_server_user_id user_ID -application_type application_type -application_server application_server_name -password password_of_the_nbu_azst_user -host_user_id master_server_admin_user_ID -host_password master_server_admin_password -host_RSA_key host_RSA_key_value -application_server_conf "/usr/<file_path>/azurestack.creds"