Veritas NetBackup™ 命令参考指南

用于创建参数文件以还原一个或多个 VMware 虚拟机磁盘的备份映像的 ID，使用 clientname_backuptime 格式。backuptime 是自 1970 年 1 月 1 日以来的十进制秒数。

请将此选项与 -restorespecout 选项结合使用。不要将其与 -s 或 -e 选项结合使用。

联系 BMR 服务器以便从客户端备份执行与虚拟机创建相关的任务。

虚拟机的名称，如备份中所标明。例如，如果策略按主机名备份了虚拟机，则指定该主机名。

要还原到一个不同的位置，请使用 -vmserver 和 -R 选项。

指定 BMR 配置名称。默认名称为 current。仅适用于 BMR VM 转换。

为 vSphere 还原操作指定要用于还原的副本号。此选项允许从主副本之外的其他副本进行还原。例如，-copy 3 还原备份映像的副本 3。

只有 VMware 虚拟机的完全备份支持此选项。如果指定的副本号不存在，则使用主副本。

指定执行即时恢复的介质服务器。

如果 NetBackup 存储是通过几台介质服务器进行配置的，则此选项非常有用，例如用于负载平衡。如果没有 -disk_media_server 选项，即时恢复作业可能会选择任意一台可用的介质服务器执行还原。如果仅为即时恢复配置其中一台介质服务器，请使用 -disk_media_server 选项指定该服务器。

取消确认提示。

启动指定虚拟机的即时恢复。对于 VMware，该命令把备份映像作为 NFS DataStore 装入。当虚拟机数据在 VM 主机上可访问时，即时恢复虚拟机。

从 ESX 主机删除指定的已还原虚拟机，并释放 NetBackup 介质服务器资源。-force 选项取消确认提示。

迁移数据后，完成虚拟机的即时恢复作业。它会移除 NetBackup 存储，并释放介质服务器资源。NetBackup 存储是在 ESX 主机上装入的 Datastore。

列出有关由即时恢复激活的虚拟机的详细信息。

通过重新装入 NetBackup NFS DataStore 来重新激活已还原的虚拟机。它还从 ESX 主机上的临时 DataStore 将已还原虚拟机注册到 ESX 主机上。

ir_identifier 是 -ir_listvm 输出的虚拟机数字标识符。

-force 选项取消确认提示。

重新启动 ESX 主机和 NetBackup 介质服务器组合上所有虚拟机的中断即时恢复作业。

指定要在其中写入进度信息的现有文件的名称。此选项适用于 vSphere 还原和 Hyper-V 还原。

仅允许对此选项使用默认路径，Veritas 建议使用默认路径。如果无法在您的设置中使用 NetBackup 默认路径，应向 NetBackup 配置中添加自定义路径。下面是默认路径：

UNIX 系统：/usr/openv/netbackup/logs/user_ops/proglog

Windows 系统：install_path\NetBackup\logs\user_ops\proglog

有关如何添加自定义路径的更多信息，请参见NetBackup 管理指南，第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_PATH 选项”主题。

指定介质服务器，重新激活虚拟机时会在该服务器上装入包含备份映像的 NFS DataStore。此选项仅与 -ir_reactivate_all 功能一起使用。

如果已存在同名的 VM 和关联资源，则将其重写。这些资源是实体，例如，显式属于现有 VM 的虚拟机磁盘格式文件 (VMDK)。如果指定了 -O，则请求 VMware 服务器在还原 VM 之前将其删除。如果未指定，则还原可能会失败。此选项用于 VClient 还原、Hyper-V 还原和 BMR VM 转换。

指定到重命名文件的绝对目录路径，该文件用于还原 VMware 虚拟机。重命名文件指示还原将重定向到备用位置，并指定有关备用客户端位置的详细信息。对于 VMware，重命名文件可以包括下列任一条目：

change /first_vmdk_path to /new_first_vmdk_path change /second_vmdk_path to /new_second_vmdk_path ... change /n’th_vmdk_path to /new_nth_vmdk_path change vmname to NEW_VM_NAME change esxhost to NEW_ESX_HOST change datacenter to NEW_DATACENTER change folder to NEW_FOLDER change resourcepool to NEW_RESOURCEPOOL change datastore to NEW_DATASTORE change network to NEW_NETWORK change organization to NEW_ORGANIZATION change orgvdc to NEW_ORGVDC change vcdserver to NEW_VCDSERVER change vcdvapp to NEW_VCDVAPP change vcdvapptemplate to NEW_VCDVAPPTEMPLATE change vcdvmname to NEW_VCDVMNAME change vcdcatalog to NEW_VCDCATALOG

即时恢复使用此列表的以下子集：

change vmname to NEW_VM_NAME change esxhost to NEW_ESX_HOST change resourcepool to NEW_RESOURCEPOOL change network to NEW_NETWORK

下面是有关这些条目的说明：

在 NetBackup 7.7.2 及更高版本中，仅允许对此选项使用默认路径，Veritas 建议使用默认路径。如果无法在您的设置中使用 NetBackup 默认路径，应向 NetBackup 配置中添加自定义路径。

有关如何添加自定义路径的更多信息，请参见NetBackup 管理指南，第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_PATH 选项”主题。

创建新虚拟机并将您在 filename 中指定的 NetBackup 客户端和磁盘还原到新的 VM。“就地磁盘还原”的一个特例是，将现有 VM 的所有磁盘替换为其备份中的数据。不会替换或删除 RDM 和独立磁盘。对于就地磁盘还原，磁盘将还原到备份时获取的相同磁盘控制器配置。filename 是一种使用 JavaScript 对象表示法 (JSON) 格式的文本文件。

文本文件必须采用 UTF-8 字符编码。

您可以使用 -restorespecout 选项创建 JSON 格式的文本文件。您可以编辑文本文件，使其仅包含要还原的虚拟机磁盘。

以下是 -restorespec 选项所需的还原参数的示例：

{ "ClientType": "VMware", "ClientName": "VM-client-name", "RestoreType": "SelectiveDiskRestore", "BackupImageSelection": { "MasterServer": "Master-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", "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 } } } 

以下是“就地磁盘还原”的 -restorespec 选项需要的还原参数示例：

{ "BackupImageSelection": { "StartDate": "05/03/20 21:50:34", "BackupId": "bptesx60l-19vm1.rmnus.sen.symantec.com_1588560634", "EndDate": "05/03/20 21:50:34", "MasterServer": "bptms-lnr73-0029" }, "ClientName": "bptesx60l-19vm1.rmnus.sen.symantec.com", "VMwareRestoreParameters": { "vmdk_compression": "none", "VMwareAdvancedRestoreOptions": { "VMShutdownWaitSeconds": 900, "DeleteRestoredVMOnError": "No" }, "VMwareRecoveryHost": "bptms-lnr73-0029", "VMwareVirtualMachineDestination": { "ResourcePool/Vapp": "/New Datacenter/host/Test01/Resources", "VmxDatastore": "datastore1", "Datacenter": "/New Datacenter", "AttachDisksToExistingVM": "DeleteAllDisksAndReplace", "ESX": "bptesx60l-19.rmnus.sen.symantec.com", "VMName": "bptesx60l-19vm1", "Folder": "/New Datacenter/vm/", "PowerOn": "Yes" }, "DefaultDiskProvisioning": "unknown", "TransportMode": "nbdssl", "VMwareVirtualDiskDestination": [], "vCenterServer": "bptesx60l-19vc" }, "ClientType": "VMware", "RestoreType": "SelectiveDiskRestore" }

以下分项列表介绍了 filename 的 5 个部分。filename 中必须省去不想使用的可选部分或可选字段。

第一部分（必填）：filename 的开头部门提供了有关包含要还原的磁盘的客户端的所需信息。

第二部分（可选）：filename 的 BackupImageSelection 部分指定识别要还原的备份映像所需的信息。如果未指定此部分，则 NetBackup 从最新备份进行还原。以下是描述 BackupImageSelection 的字段：

第三部分（必填）：filename 的 VMwareRestoreParameters 部分指定要还原的虚拟磁盘的 VMware 属性。这部分的所有字段均为可选字段；但是，由于该部分还包含两个必填的子部分，所以为必填部分。以下是描述 VMwareRestoreParameters 的字段：

第四部分（必填）：filename 的 VMwareVirtualMachineDestination 部分指定还原的目标参数。此部分从属于 VMwareRestoreParameters 部分。它包含以下字段：

第五部分（必填，VMwareVirtualDestinationAttachDisksToExistingVM 参数为 DeleteAllDisksAndReplace 时除外。如果为“就地磁盘还原”指定此选项，则还原验证将失败。）：filename 的 VMwareVirtualDiskDestination 部分是一个阵列，用于指定要还原的磁盘以及这些磁盘的还原参数。此部分从属于 VMwareRestoreParameters 部分。其中可包含一组或多组下列字段，每个虚拟机磁盘一组。必须用逗号分隔组内的字段，必须用逗号分隔不同的组。

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

指定 nbrestorevm 在其中写入要还原的各虚拟机磁盘的参数的文件的路径名。默认情况下，nbrestorevm 会在当前工作目录中创建文件。要指定从中获取参数的备份映像，请使用 -backupid 选项或者 -s 和 -e 选项。如果指定 -s 和 -e 选项，NetBackup 将使用该日期范围内的最新备份。

编辑文件，使其包含相应的信息。确保 VMName 字段包含新 VM 的名称。确保文件的 VMwareVirtualDiskDestination 部分仅包含要还原的一个或多个虚拟机磁盘。使用编辑后的文件作为 -restorespec 选项的输入文件，用于还原在文件中识别的一个或多个虚拟机磁盘。

默认情况下，nbrestorevm 会在当前工作目录中创建文件。要在其他目录中创建文件，请为 filename 指定路径名。该路径必须在 NetBackup 路径白名单中。有关如何添加自定义路径的更多信息，请参见 NetBackup 管理指南，第 I 卷中的“NetBackup 服务器和客户端的 BPCD_WHITELIST_PATH 选项”主题。

指定其他主服务器从备份还原虚拟机，该备份由此主服务器制作。

将可选择的备份映像限制为具有指定时间段内的时间戳的备份映像。NetBackup 会选择该范围内的最新且合适的备份映像。指定列表的开始日期 (-s) 和结束日期 (-e)。开始日期和结束日期表示搜索一个有效备份映像的时间范围。将使用在指定时间范围内的最新的有效备份映像来执行还原。这些选项与除 BMR VM 转换之外的所有功能一起使用。

在 VM 主机服务器上指定一个临时 DataStore，在虚拟机被还原之前所有写入操作都将在这里进行。所有写入操作都在此 Datastore 中进行，直到 Storage vMotion 完成操作，或直到您完成虚拟机操作（例如，进行故障排除）。在运行 nbrestorevm 之前，此 Datastore 必须存在。此选项只能与 -ir_activate 一起使用。此选项仅与即时恢复一起使用。

验证 filename 中的虚拟机磁盘还原参数。必需填写 -restorespec 选项，而且该选项必须紧跟 -validate 选项。

有关 filename 的说明，请参见 -restorespec 选项说明。

还原 vCloud 虚拟机。还原到 vCloud 中的原始位置或备用位置时，需要此选项。

通过使用具有最大可用空间的 Datastore 来还原 vCloud 虚拟机。此选项仅适用于没有定向到原始位置的还原操作。

重写现有的 vCloud vApp。

重定向 vCloud 还原。

如果使用 -vcdtemplate 选项将 vApp 另存为模板，则删除 vApp。

将 vCloud 虚拟机还原到现有的 vCloud vApp。还原到现有的 vApp（包括原始位置还原）时，需要此选项。

将 vCloud 虚拟机还原为模板。

包含虚拟环境详细信息且采用 param=value 格式的完整（绝对）文件路径。veconfig 文件通常包含以下条目：

esxhost="bmresx.xyz.com" name="Test_NBRestoreVM" network="VM Network" nbrestorediskformat="ThinVdisk" toolsIsoPath="C:\B2V\windows_esx5.iso" datacenter="/Test/XyzDatacenter" folder="/Test/XyzDatacenter/vm" resourcepool="/Test/XyzDatacenter/host/bmresx.xyz.com/Resources/resourcepoolname" harddisk=0:"B2V_4TB" harddisk=1:"storage1 (2)" harddisk=2:"storage2 (1)" 

下面是有关这些条目的说明：

已还原磁盘的磁盘格式将为“急速清零”。

将 VMDK 文件还原为平面磁盘。

指定重新激活虚拟机时在其上装入虚拟机的 VM 主机。

在原始位置还原 Hyper-V 虚拟机。

将 Hyper-V 虚拟机还原到一个新位置。

将 Hyper-V 虚拟机文件还原到分段位置。

还原虚拟机的 BIOS UUID 而非创建新的 UUID。

对于 VMware：还原虚拟机的 BIOS UUID 而不创建新的 UUID。

对于 Hyper-V：还原虚拟机的 GUID 而不创建新的 GUID。

保留原始虚拟机的实例 UUID（注意，实例 UUID 是虚拟机的 vCenter 特定唯一标识符）。虚拟机使用备份时采用的相同实例 UUID 进行还原。

如果虚拟机还原到独立 ESXi 主机，则将忽略此选项。

如果目标还原位置存在具有相同实例 UUID 的虚拟机，NetBackup 将为虚拟机分配一个新的 UUID。

在恢复时保留硬件版本。此选项仅适用于 VMware VM 恢复。

在即时恢复期间生成新的虚拟机磁盘 UUID。请将此选项与 –ir_activate 选项结合使用。

使用此选项激活的 VM 在后续 –ir_reactivate 操作过程中不会保留新的 vmdk UUID。在这种情况下，VMDK 将还原为备份时的 UUID。

指定在还原 Hyper-V 虚拟机时不想还原公用文件。

执行还原操作后自动启动虚拟机。

指定 VMware 访问主机。它会覆盖用于备份虚拟机的默认 VMProxy。

存储生命周期策略 (SLP) 可以使用自动映像复制将一个虚拟机备份映像复制到另一个 NetBackup 域。要从复制的映像还原虚拟机，您必须包括 -vmproxy 选项。使用 -vmproxy 选项指定位于虚拟机复制到的域中的备份主机（访问主机）。

删除任何已装入的可移动设备，例如 cd-rom 或 dvd-rom 映像。

指定用于还原操作的不同目标位置（例如，ESX Server 或 vCenter）。它会覆盖用于备份虚拟机的默认 VM 服务器。要还原到虚拟机最初所在的同一 vCenter，请省略此选项。

去除虚拟机的网络接口。

从还原中去除 VMware 标记。

已还原磁盘的磁盘格式将为“精简”。

指定 VMware 传输模式。vm_transport_mode 格式的示例：san:hotadd:nbd:nbdssl。

允许将 VMware VMDK 文件还原到同一 DataStore 中，其中指定了 VMX 文件。分配其他 vmdk 文件路径的重命名文件覆盖此选项。

还原 VMware 虚拟机。

使 NetBackup 在返回到系统提示符状态之前等待来自服务器的完成状态。

NetBackup 命令所需要的日期和时间值格式因区域设置的不同而不同。/usr/openv/msg/.conf 文件 (UNIX) 和 install_path\VERITAS\msg\LC.CONF 文件 (Windows) 包含诸如每个所支持的区域设置的日期时间格式等信息。这些文件包含有关如何添加或修改所支持的区域设置和格式列表的具体说明。

请参见《NetBackup 管理指南，第 II 卷》中的“关于指定 NetBackup 安装的区域设置”主题。

可以选择用小时、分钟和秒的形式来指定等待时间。可以指定的最长等待时间是 23:59:59。如果等待时间在还原完成前过期，则该命令以超时状态退出。但仍会在服务器上完成还原操作。

如果指定 0 或者未指定时间，则将无限期等待完成状态。