Using the BAR interface to restore an Microsoft Azure Stack VM with modified metadata at an alternate 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
- Open the Backup, Archive, and Restore interface.
- 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.
- Select the appropriate date range to restore the complete data set.
- In the Browse directory, specify the root directory ( "/") as the path to browse.
- From the File menu (Windows) or Actions menu (UNIX), choose Specify NetBackup Machines and Policy Type.
- Go to the Backup History and select the backup images that you want to restore.
- 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.
- Select the VM that you want to restore. Ensure that the storage account directories are selected.
For example:
- 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.
Running
Poweroff, Deallocate, or Running
VMSize
Size of the VM in the Microsoft Azure Stack recommended format. The new VM size must be part of your subscription. For more information, refer to Azure Stack VM Sizes.
Size of the VM during backup.
VM size that the target subscription ID supports.
Vnet
The virtual network that contains the VM.
ResourceGroup_Name-vnetVirtual network in the target resource group.
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 VMs.
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.
You must select the VmName metadata even if do not plan to change the name.
- Click Restore.
- 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=OldVmNameto/21c71fdf-3ee5-4b57-8c51-18ebe7032237/SKRG/MSvm15/Metadata/VmName=NewVmNameHere, 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.
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.
- Click Start Restore.
- Use the Azure Stack Admin Portal to view the VM creation process.
