<book_title> を検索 ...

NetBackup™ for VMware 管理者ガイド

Last Published: 2023-12-28

Product(s): NetBackup (10.3)

VMware 仮想マシンディスクのリストアファイル

このトピックでは、NetBackup が仮想マシンの 1 つ以上のディスクをリストアするために使うパラメータについて説明します。NetBackup では、JavaScript Object Notation (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	形式は clientname_backuptime です。*backuptime* は 1970 年 1 月 1 日以降の 10 進数での秒数です。指定しない場合、NetBackup は直近のバックアップイメージを使用します。StartDate、EndDate、有効な BackupId のいずれかを指定すると、NetBackup は BackupId イメージからリストアします。	任意。

VMwareRestoreParameters

ファイルの VMwareRestoreParameters セクションには、次の内容が含まれます。

VM のリストアパラメータ。このセクションにあるフィールドはすべて省略可能ですが、必須のサブセクションが 2 つあるため、このセクション自体は必要です。表: VMwareRestoreParameters セクション (必須)を参照してください。
リストアの宛先パラメータを指定する VMwareVirtualMachineDestination サブセクション。
VMwareVirtualMachineDestinationを参照してください。
リストアするディスクおよびそのディスクのリストアパラメータを指定する VMwareVirtualDiskDestination サブセクション。
VMwareVirtualDiskDestinationを参照してください。
既存の VM にリストアするためのパラメータを指定する VMwareAdvancedRestoreOptions サブセクション。
VMwareAdvancedRestoreOptionsを参照してください。

表: VMwareRestoreParameters セクション (必須)

フィールド名	説明	必須かどうか
vCenterServer	リストアの宛先 vCenter のホスト名。形式は NetBackup Virtual Server のクレデンシャルで指定したものと同じです。 vCenter を介したバックアップをスタンドアロンの ESXi Hypervisor にリストアするには、このフィールドの値を 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	リストアされた 1 つまたは複数のディスク用の、新しい仮想マシンの一意の表示名。nbrestorevm コマンドは、このフィールドが入力されると、元の VM クライアントの名前にタイムスタンプを追加します。タイムスタンプは 1970 年 1 月 1 日以降の 10 進数での秒数です。 NetBackup は、仮想マシンディスクを新しい VM にリストアします。そのため、この名前が既存の表示名と競合すると、リストアは失敗します。	必須。
AttachDisksToExistingVM	選択した VMDK を既存の VM、または新しい VM のどちらにリストアするか。値が Yes の場合、VMName フィールドに指定されている VM がターゲットの vCenter または ESX Server に存在する必要があります。存在しない場合、状態コード 2820 でリストアが失敗します。値が No の場合、VMName フィールドに指定されている VM がターゲットの vCenter または ESX Server に存在してはなりません。存在する場合、状態コード 2820 でリストアが失敗します。値が DeleteAllDisksAndReplace の場合、VMName フィールドに指定されている VM がターゲットの vCenter または ESX Server に存在する必要があります。存在しない場合、状態コード 2820 でリストアが失敗します。デフォルト値は No です。	必須。
PowerOn	リストア後にターゲット VM をオンにするかどうか。値が Yes の場合、正常なリストアの終わりにターゲットの VM の電源がオンになります。値が No の場合、リストアの後にターゲットの VM の電源はオンになりません。既存の VM にリストアする場合、リストア時に、VM がオフになってから VM に仮想ディスクが接続されます。デフォルト値は No です。	必須。
Datacenter	仮想ディスクの VMware データセンターの名前。パス名の形式で表します。 vCenter を介したバックアップをスタンドアロンの ESXi Hypervisor にリストアするには、このフィールドの値を None にする必要があります。指定しない場合、NetBackup はバックアップの値を使用します。	任意。
ESX	NetBackup が仮想マシンディスクをリストアする ESX ホストの名前。指定しない場合、NetBackup はバックアップの値を使用します。	任意。
Folder	NetBackup が仮想マシンディスクをリストアする VM フォルダのパス名。 vCenter を介したバックアップをスタンドアロンの ESXi Hypervisor にリストアするには、このフィールドの値を None にする必要があります。指定しない場合、NetBackup はバックアップの値を使用します。	任意。
ResourcePool/Vapp	NetBackup が仮想マシンディスクをリストアするリストアプールのパス名。vApp にリストアする場合は、vApp のパスを指定します。指定しない場合、NetBackup はバックアップの値を使用します。	任意。
VmxDatastore	NetBackup が .vmx 構成ファイルおよびその他の VM 構成ファイルをリストアする Datastore の名前。名前を角カッコで囲むこともできますが、必須ではありません。指定しない場合、NetBackup はバックアップの値を使用します。	任意。
DefaultDiskDatastore	NetBackup がインプレースディスクリストア用のすべての仮想ディスクをリストアする宛先となる Datastore の名前。指定しない場合、NetBackup はバックアップの値を使用します。このオプションはインプレースディスクリストアでのみ使用され、それ以外の場合は無視されます。	任意。

VMwareVirtualDiskDestination

ファイルの VMwareVirtualDiskDestination セクションは、リストア対象ディスクおよびそのディスク用のリストアパラメータを指定する JSON アレイです。これには、次の表に説明されている 1 つ以上のフィールドセットが含まれます (仮想マシンディスクごとに 1 セット)。セット内のフィールドはカンマで区切り、セット間もカンマで区切る必要があります。これは、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 分) です。

任意。