Appendix B. Configuring Bus Type Restore Priority
When restoring a VM that originally resided on a platform other than Nutanix AHV, Veeam Plug-in for Nutanix AHV attaches disks with the restored data to the target Nutanix AHV VM taking into account the original disk bus types unless the following limits are exceeded: 6 SATA, 256 SCSI, 4 IDE, 7 PCI disks. Since the maximum number of disk nodes to which disks of a specific bus type can be attached varies depending on the virtualization platform, Veeam Plug-in for Nutanix AHV may fail to attach some of the VM disks using their original bus types. Those disks will be attached to free nodes of other bus types in the following default priority: SATA, SCSI, IDE, PCI.
You can modify the default priority to define the order in which Veeam Plug-in for Nutanix AHV will process disks that cannot be attached using their original bus types. You can also instruct Veeam Plug-in for Nutanix AHV to ignore the original bus types of VM disks. In the latter case, Veeam Plug-in for Nutanix AHV will attach disks according to the specified bus type priority — this may be useful if some bus type is not configured in the Nutanix AHV environment.
Note |
Veeam Plug-in for Nutanix AHV takes into account the bus type restore priority only when performing the following operations:
|
Consider the following example. You want to restore a VMware VM that originally had 30 SATA disks and 2 IDE disks. Depending on the bus type restore priority, Veeam Plug-in for Nutanix AHV will attach disks to the following nodes of the target VM:
Bus Type Priority | Ignore Original Bus | Target VM Disk Nodes |
|---|---|---|
SATA, SCSI, IDE, PCI | False |
|
SATA, IDE, PCI, SCSI | False |
|
SCSI, IDE, PCI, SATA | False |
|
SCSI, IDE, PCI, SATA | True |
|
Configuring Bus Type Priority on Linux Server
To modify the default bus type restore priority on a Linux-based backup server, do the following:
- In a web browser, log in to the Host Management web console as described in the Veeam Backup & Replication User Guide, section Accessing Host Management Console.
- Navigate to Logs and Services > Host Configuration.
- In the Configuration Files section, select the /etc/veeam/platform-service-ahv/appsettings.json file and click Export.
The file will be downloaded to your local machine.
- Use a plain text editor to open the .JSON file.
- Locate the RestoreDefaults configuration section.
To instruct Veeam Plug-in for Nutanix AHV to ignore the original bus types of VM disks, set the following parameter to true:
"IgnoreOriginalBus": "true", |
To change the bus type priority, update the following parameter value:
"BusesFillingOrder": "SCSI, IDE, PCI, SATA", |
- Save the appsettings.json file.
- Back to the web browser, select the /etc/veeam/platform-service-ahv/appsettings.json file, click Import, choose the updated appsettings.json file and click Open.
- Restart the Veeam Nutanix AHV Platform Service. To do that, navigate to Logs and Services > Services, select veeam-platform-service-ahv.service and click Restart.
Configuring Bus Type Priority on Windows Server
To modify the default bus type restore priority on a Windows-based backup server, do the following:
- Close the Veeam Backup & Replication console.
- Open a plain text editor (for example, Notepad) as Administrator.
- In the editor, open the appsettings.json file located in the {plug-in location}\Service folder.
The default location of Nutanix AHV plug-in is C:\Program Files\Veeam\Plugins\Nutanix AHV. However, the location may differ depending on the specified setup settings.
- Locate the RestoreDefaults configuration section.
To instruct Veeam Plug-In for Nutanix AHV to ignore the original bus types of VM disks, set the following parameter to true:
"IgnoreOriginalBus": "true", |
To change the bus type priority, update the following parameter value:
"BusesFillingOrder": "SCSI, IDE, PCI, SATA", |
- Save the appsettings.json file.
- Restart the Veeam AHV Service.