搜索 <book_title>...

NetBackup™ for VMware 管理指南

Last Published: 2023-04-28

Product(s): NetBackup (10.2)

VMware 虚拟机磁盘还原文件

本主题介绍了 NetBackup 用于还原一个或多个虚拟机磁盘的参数。NetBackup 要求在使用 JavaScript 对象表示法 (JSON) 格式的文本文件中描述这些参数。NetBackup nbrestorevm 命令将读取该文件以获取有关虚拟机磁盘的必要信息。除操作系统对文件名的要求以外，NetBackup 对文件名没有任何要求。

您可以使用 nbrestorevm 命令从现有备份生成此文件。如何执行此操作在另一个主题中进行了介绍。

请参见创建 VMware 虚拟机磁盘还原文件。

以下是该所需文件的模板示例：

{
  "ClientType": "VMware",
  "ClientName": "VM-client-name",
  "RestoreType": "SelectiveDiskRestore",
  "BackupImageSelection": {
    "PrimaryServer": "Primary-server-name",
    "StartDate": "mm/dd/yy hh:mm:ss",
    "EndDate": "mm/dd/yy hh:mm:ss",
    "BackupId": "clientname_timestamp"
  },
  "VMwareRestoreParameters": {
    "vCenterServer": "vCenter-name-for-restore",
    "VMwareRecoveryHost": "Recovery-host-name",
    "DefaultDiskProvisioning": "thin",
    "TransportMode": "san:hotadd:nbd",
    "vmdk_compression": "none",
    "VMwareVirtualMachineDestination": {
      "VMName": "Restore-vm-name",
      "AttachDisksToExistingVM": "No",
      "PowerOn": "No",
      "Datacenter": "Path-of-Datacenter-for-destination-vm",
      "ESX": "Hostname-of-the-ESX-host",
      "Folder": "Path-to-destination-VM-folder",
      "ResourcePool/Vapp": "Path-of-vApp-or-resource-pool-destination",
      "VmxDatastore": ""
    },
    "VMwareVirtualDiskDestination": [
      {
         "VirtualDisk" : "/DS1/BackedupVM/BackedupVM.vmdk",
         "OverwriteExistingDisk": "No",
         "Datastore": "[Datastore-name]",
         "Path": "”,
         "Provisioning": "thin"
         "Controller": "scsi0-0"     
      },
      {
         "VirtualDisk": "/DS2/BackedupVM/BackedupVM_1.vmdk",
         "OverwriteExistingDisk": "No",
         "Datastore": "",
         "Path": "[datastore_name] MyVm/MyVM_1.vmdk”,
         "Provisioning": "eagerzeroed"
         "Controller": "scsi0-1"
      }
    ]
    "VMwareAdvancedRestoreOptions": {
      "DeleteRestoredVMOnError": "No",
      "VMShutdownWaitSeconds": 900
    }
  }
}

以下是执行就地磁盘还原所需文件的示例：

{
  "BackupImageSelection": {
    "StartDate": "mm/dd/yy hh:mm:ss",
    "BackupId": "clientname_timestamp"
    "EndDate": "mm/dd/yy hh:mm:ss",
    "PrimaryServer": "Primary-server-name",
  },
  "ClientName": "VM-client-name",
  "VMwareRestoreParameters": {
    "vmdk_compression": "none",
    "VMwareAdvancedRestoreOptions": {
      "VMShutdownWaitSeconds": 900,
      "DeleteRestoredVMOnError": "No"
    },
    "VMwareRecoveryHost": "VM-recovery-host-name",
    "VMwareVirtualMachineDestination": {
      "ResourcePool/Vapp": "Path-of-vApp-or-resource-pool-destination",
      "VmxDatastore": "Vmx-datastore-name",
      "Datacenter": "Path-of-Datacenter-for-destination-vm",
      "AttachDisksToExistingVM": "DeleteAllDisksAndReplace",
      "ESX": "Hostname-of-the-ESX-host",
      "VMName": "Restore-vm-name",
      "Folder": "Path-to-destination-VM-folder",
      "PowerOn": "Yes"
    },
    "DefaultDiskProvisioning": "unknown",
    "TransportMode": "nbdssl",
    "VMwareVirtualDiskDestination": [],
    "vCenterServer": "vCenter-name-for-restore"
  },
  "ClientType": "VMware",
  "RestoreType": "SelectiveDiskRestore"
}

以下各小节介绍了此文件中的参数。此文件中必须省去不想使用的可选部分或可选字段。

请参见关于 VMware 虚拟机磁盘还原。

全局字段

此文件的第一部分指定有关包含要还原的磁盘的客户端的所需信息。下表介绍了第一个全局部分中的字段：

表：全局字段（必填）

字段名称	描述	是否必需
ClientType	备份策略中配置的客户端类型。对于 VMware 虚拟机磁盘还原，请使用 VMware。	必需。
ClientName	备份策略中配置的客户端名称。	必需。
RestoreType	还原类型。对于 VMware 虚拟机磁盘还原，请使用 SelectiveDiskRestore。	必需。

BackupImageSelection

此文件的 BackupImageSelection 部分指定 NetBackup 标识要还原的备份映像所需的信息。如果未指定此部分，则 NetBackup 将还原最新备份。下表介绍了 BackupImageSelection 部分中的字段：

表：BackupImageSelection 部分（可选）

字段名称	描述	是否必需
PrimaryServer	用于查询 VM 详细信息的 NetBackup 主服务器的完全限定域名。如果未指定此字段，则 NetBackup 将使用备份 VM 的主服务器。	可选。
StartDate	查找备份映像的开始日期，使用 mm/dd/yyhh:mm:ss 格式。如果日期范围内存在多个备份映像，NetBackup 将选择最新备份。如果未指定，则开始日期为当前日期前的 6 个月。	可选。
EndDate	查找备份映像的结束日期，使用 mm/dd/yyhh:mm:ss 格式。如果日期范围内存在多个备份映像，NetBackup 将选择最新备份。如果未指定，则 NetBackup 使用当前日期。	可选。
BackupId	用于还原的备份映像的 ID，使用 clientname_backuptime 格式。*backuptime* 是自 1970 年 1 月 1 日以来的十进制秒数。如果未指定，NetBackup 将使用最新备份映像。如果指定 StartDate、EndDate 和有效 BackupId，NetBackup 将从 BackupId 映像执行还原。	可选。

VMwareRestoreParameters

此文件的 VMwareRestoreParameters 部分包含以下内容：

VM 的还原参数。这部分的所有字段均为可选字段；但是，由于该部分还包含两个必填的子部分，所以为必填部分。请参见表：VMwareRestoreParameters 部分（必填）。
VMwareVirtualMachineDestination 子部分，用于指定还原的目标参数。
请参见VMwareVirtualMachineDestination。
VMwareVirtualDiskDestination 子部分，用于指定要还原的磁盘以及用于这些磁盘的还原参数。
请参见VMwareVirtualDiskDestination。
VMwareAdvancedRestoreOptions 子部分，用于指定要还原到现有 VM 的参数。
请参见VMwareAdvancedRestoreOptions。

表：VMwareRestoreParameters 部分（必填）

字段名称	描述	是否必需
vCenterServer	还原目标 vCenter 的主机名，所用的格式与 NetBackup Virtual Server 凭据中指定的格式相同。要在通过 vCenter 备份时还原独立 ESXi 虚拟机管理程序，则此字段的值必须为 None。	可选。
VMwareRecoveryHost	执行还原的主机。如果未指定，则 NetBackup 将使用备份映像中的备份主机值。	可选。
DefaultDiskProvisioning	要还原的所有磁盘的默认磁盘置备：thin、thick、eagerzeroed 或 unknown。您可以通过在此文件的 VMwareVirtualDiskDestination 部分指定不同的 Provisioning 值来覆盖每个磁盘上的默认值。如果既未指定 DefaultDiskProvisioning，也未指定 Provisioning，则 NetBackup 将使用备份中指定的置备。	可选。
TransportMode	用于还原的传输模式组合指定为小写冒号分隔值：hotadd:nbd:nbdssl:san。指定顺序很重要；NetBackup 会依次尝试每种方法，直至还原成功。如果所有方法均失败，则还原失败。如果未指定，则 NetBackup 将使用备份使用的传输模式组合。	可选。
vmdk_compression	用于完全和选择性 vmdk 还原的 vmdk 压缩类型。VMDK 压缩类型包括：zlib、skipz 和 fastlz。如果未指定，则 NetBackup 使用 none 作为值。	可选。

VMwareVirtualMachineDestination

此文件的 VMwareVirtualMachineDestination 部分用于指定还原的目标参数。下表介绍了 VMwareVirtualMachineDestination 部分中的字段。此部分从属于 VMwareRestoreParameters 部分。

表：VMwareVirtualMachineDestination 部分（必填）

字段名称	描述	是否必需
VMName	还原的一个或多个磁盘的新虚拟机的唯一显示名称。nbrestorevm 命令可在填充此字段时为原始 VM 客户端名称添加时间戳。时间戳是自 1970 年 1 月 1 日以来的十进制秒数。 NetBackup 将虚拟机磁盘还原到新 VM。因此，如果此名称与现有显示名称冲突，还原将失败。	必需。
AttachDisksToExistingVM	将选定的 VMDK 还原到现有 VM 还是还原到新 VM，如下所示：如果值为 Yes，则在 VMName 字段中指定的 VM 必须存在于目标 vCenter 或 ESX Server 中。如果其不存在，还原将失败且状态码为 2820。如果值为 No，则在 VMName 字段中指定的 VM 不得存在于目标 vCenter 或 ESX 服务器中。如果其存在，还原将失败且状态码为 2820。如果值为 DeleteAllDisksAndReplace，则在 VMName 字段中指定的 VM 必须存在于目标 vCenter 或 ESX Server 中。如果其不存在，还原将失败且状态码为 2820。默认值为 No。	必需。
PowerOn	在还原后是否打开目标 VM，如下所示：如果值为 Yes，则在成功结束还原时打开目标 VM。如果值为 No，则还原后不打开目标 VM。如果是还原到现有 VM，则在还原期间向其挂接虚拟机之前会先关闭 VM。默认值为 No。	必需。
Datacenter	VMware“数据中心”虚拟磁盘的名称，使用路径名格式。要在通过 vCenter 备份时还原独立 ESXi 虚拟机管理程序，则此字段的值必须为 None。如果未指定，则 NetBackup 将使用备份的相应值。	可选。
ESX	NetBackup 应将虚拟机磁盘还原到的 ESX 主机的名称。如果未指定，则 NetBackup 将使用备份的相应值。	可选。
Folder	NetBackup 应将虚拟机磁盘还原到的 VM 文件夹的路径名。要在通过 vCenter 备份时还原独立 ESXi 虚拟机管理程序，则此字段的值必须为 None。如果未指定，则 NetBackup 将使用备份的相应值。	可选。
ResourcePool/Vapp	NetBackup 应将虚拟机磁盘还原到的资源池的路径名。如果还原到 vApp，请指定 vApp 的路径。如果未指定，则 NetBackup 将使用备份的相应值。	可选。
VmxDatastore	NetBackup 应将 .vmx 配置文件及其他 VM 配置文件还原到的 Datastore 的名称。您可以用方括号将名称括起来，但并非必须这样做。如果未指定，则 NetBackup 将使用备份的相应值。	可选。
DefaultDiskDatastore	对于就地磁盘还原，NetBackup 应将所有虚拟磁盘还原到的 Datastore 的名称。如果未指定，则 NetBackup 将使用备份的相应值。此选项仅用于就地磁盘还原，否则将被忽略。	可选。

VMwareVirtualDiskDestination

此文件的 VMwareVirtualDiskDestination 部分是用于指定还原磁盘以及这些磁盘的还原参数的 JSON 阵列。它可以包含下表中描述的一个或多个字段组，每个字段组对应一个虚拟机磁盘。必须用逗号分隔组内的字段，必须用逗号分隔不同的组。此部分从属于 VMwareRestoreParameters 部分。

注意:

此部分不适用于就地磁盘还原。

表：VMwareVirtualDiskDestination 部分（必填）

字段名称	描述	是否必需
VirtualDisk	要还原的虚拟磁盘的完整路径名。此路径必须与 .vmdk 文件备份时的路径完全匹配。	必需。
OverwriteExistingDisk	是否覆盖目标 VM 上的现有虚拟磁盘，如下所示：如果值为 Yes，则覆盖原始虚拟磁盘并保留磁盘 UUID。如果值为 No，则将虚拟磁盘还原到目标 VM 作为新磁盘。VMware 会向该磁盘分配一个新 UUID。默认值为 No。	必需。
Datastore	作为还原目标的 Datastore 的名称。您可以用方括号将名称括起来，但并非必须这样做。（VMware 使用 VM 命名约定生成 Datastore 路径名。）若要将虚拟磁盘还原到数据存储群集，请在此字段中指定数据存储群集的名称。如果未指定，NetBackup 将使用 Path 字段中指定的值。如果既未指定 Datastore，也未指定 Path，则 NetBackup 使用备份映像中的 Datastore。	可选。
Path	虚拟磁盘的还原目标的完整路径名，格式如下： *[datastore_name] MyVM/MyVM.vmdk* nbrestorevm-restorespecout 选项不会填充 Path 字段。如果指定 Path 但它不可用，或者该路径已存在磁盘，则还原失败。如果既未指定 Datastore，也未指定 Path，则 NetBackup 使用备份映像中的 Datastore。如果特定 vmdk 名称不是必需的，Veritas 建议您将此字段留空。	可选。
Provisioning	特定磁盘的磁盘置备：thin、thick、eagerzeroed 或 unknown。如果未指定，则 NetBackup 使用 DefaultDiskProvisioning 值。	可选。
Controller	原始 VM 中磁盘挂接的虚拟磁盘控制器。此字段仅供参考，帮助您确定要还原的一个或多个虚拟磁盘。还原期间不会用到这个值。	可选

VMwareAdvancedRestoreOptions

该文件的 VMwareAdvancedRestoreOptions 部分用于指定要还原到现有 VM 的参数。此部分从属于 VMwareRestoreParameters 部分。

表：VMwareAdvancedRestoreOptions 部分（可选）

字段名称	描述	是否必需
DeleteRestoredVMOnError	NetBackup 在还原过程中会创建一个临时 VM，然后将虚拟磁盘挂接到目标 VM。此参数的值确定磁盘挂接操作失败时 NetBackup 是否删除临时 VM，如下所示：如果值为 Yes，则删除临时 VM。如果值为 No，则不删除临时 VM。如果磁盘未成功挂接到目标 VM，您可以访问临时 VM 上的数据。默认值为 No。	可选。
VMShutdownWaitSeconds	若要还原到现有 VM，还原过程会在挂接磁盘之前关闭目标虚拟机。关闭操作的持续时间取决于 VMware 工作负载。使用此参数可指定还原过程在放弃还原之前应等待关闭的时间。默认值为 900 秒（15 分钟）。	可选。

字段名称

描述

是否必需

DeleteRestoredVMOnError

NetBackup 在还原过程中会创建一个临时 VM，然后将虚拟磁盘挂接到目标 VM。此参数的值确定磁盘挂接操作失败时 NetBackup 是否删除临时 VM，如下所示：

如果值为 Yes，则删除临时 VM。
如果值为 No，则不删除临时 VM。如果磁盘未成功挂接到目标 VM，您可以访问临时 VM 上的数据。

默认值为 No。

可选。

VMShutdownWaitSeconds

若要还原到现有 VM，还原过程会在挂接磁盘之前关闭目标虚拟机。关闭操作的持续时间取决于 VMware 工作负载。使用此参数可指定还原过程在放弃还原之前应等待关闭的时间。

默认值为 900 秒（15 分钟）。

可选。