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
- 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:
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.
- 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.
- 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.
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.
- Click Start Restore.
- Use the Azure Stack Admin Portal to view the VM creation process.
