Veritas NetBackup™ コマンドリファレンスガイド

1 つ以上の VMware 仮想マシンディスクのリストアのためにパラメータファイルを作成するときに使用するバックアップイメージの ID。形式は clientname_backuptime です。backuptime は 1970 年 1 月 1 日以降の 10 進数での秒数です。

このオプションは、--restorespecout オプションとともに使用します。-s オプションまたは -e オプションとは組み合わせないでください。

BMR サーバーに接続し、クライアントバックアップから仮想マシン関連のタスクを実行します。

バックアップで識別される仮想マシンの名前。たとえば、ホスト名によってポリシーで仮想マシンをバックアップした場合は、そのホスト名を指定します。

別の場所にリストアするには、-vmserver オプションと -R オプションを使います。

BMR 構成名を指定します。デフォルト名は current です。BMR の VM 変換にのみ適用されます。

vSphere リストア操作でリストアするコピー番号を指定します。このオプションでは、プライマリコピー以外のコピーからリストアできます。たとえば、-copy 3 の場合、バックアップイメージのコピー 3 がリストアされます。

このオプションは、VMware 仮想マシンの完全バックアップでのみサポートされます。指定したコピー番号が存在しない場合は、プライマリコピーが使用されます。

どのメディアサーバーがインスタントリカバリを実行するか指定します。

このオプションは負荷分散など、NetBackup のストレージが複数のメディアサーバーにまたがって構成されている場合に役立ちます。-disk_media_server オプションを指定しないと、インスタントリカバリジョブは利用可能な任意のメディアサーバーを選択してリストアする可能性があります。インスタントリカバリのために構成されているメディアサーバーが 1 つだけの場合、-disk_media_server オプションでそのサーバーを指定します。

確認のプロンプトを抑止します。

指定した仮想マシンのインスタントリカバリを開始します。VMware に対して、コマンドはバックアップイメージを NFS データストアとしてマウントします。VM ホストで仮想マシンデータにアクセスできる場合、仮想マシンは即座にリカバリされます。

指定したリストア済みの仮想マシンを ESX のホストから削除し、NetBackup メディアサーバーのリソースを解除します。-force オプションは確認のプロンプトを抑止します。

データが移行された後、仮想マシンのインスタントリカバリジョブを完了します。NetBackup ストレージが削除され、メディアサーバーのリソースが解除されます。NetBackup ストレージは ESX ホストにマウントされているデータストアです。

インスタントリカバリによって有効にされた仮想マシンの詳細をリストします。

NetBackup NFS データストアをマウントし直すことによってリストアされた仮想マシンを再アクティブ化します。この操作によって、ESX ホストの一時データストアから 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 管理者ガイド Vol. 1』の「NetBackup サーバーおよびクライアントの BPCD_WHITELIST_PATH オプション」のトピックを参照してください。

仮想マシンを再アクティブ化するとき、バックアップイメージを含んでいる NFS データストアがマウントされたメディアサーバーを指定します。このオプションは -ir_reactivate_all 関数とのみ使われます。

VM が同じ名前ですでに存在する場合はそれらの VM を上書きします。これらのリソースは、既存の VM に明示的に属している仮想マシンディスク形式ファイル (VMDK) のようなエンティティです。-O が指定された場合、VM をリストアする前に 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 管理者ガイド Vol. 1』の「NetBackup サーバーおよびクライアントの BPCD_WHITELIST_PATH オプション」のトピックを参照してください。

新しい仮想マシンを作成して、filename で指定した NetBackup クライアントとディスクを新しい VM にリストアします。インプレースディスクリストアと呼ばれる特殊なケースでは、既存の VM のすべてのディスクがバックアップ内のデータに置き換えられます。RDM と独立ディスクは交換または削除されません。インプレースディスクリストアの場合、ディスクはバックアップ時に取得されたものと同じディスクコントローラ構成にリストアされます。filename は JSON (JavaScript Object Notation) 形式を使用したテキストファイルです。

テキストファイルの文字エンコードは 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 から除外する必要があります。

第 1 セクション (必須): filename の冒頭のセクションには、リストア対象のディスクを含むクライアントに関する必須情報が示されます。

第 2 セクション (省略可能): filename の BackupImageSelection セクションは、リストアするバックアップイメージの特定に必要な情報を指定します。このセクションを指定しない場合、NetBackup は直近のバックアップからリストアを実行します。以下は、BackupImageSelection のフィールドです。

第 3 セクション (必須): filename の VMwareRestoreParameters セクションは、リストアする仮想ディスクの VMware 属性を指定します。このセクションにあるフィールドはすべて省略可能ですが、必須のサブセクションが 2 つあるため、このセクション自体は必要です。以下は、VMwareRestoreParameters のフィールドです。

第 4 セクション (必須): filename の VMwareVirtualMachineDestination セクションは、リストアの宛先パラメータを指定します。これは、VMwareRestoreParameters セクションの下位セクションです。次のフィールドが含まれます。

第 5 セクション (必須、ただし VMwareVirtualDestinationAttachDisksToExistingVM パラメータが DeleteAllDisksAndReplace である場合を除きます。このオプションがインプレースディスクリストアに指定されていると、リストアの検証は失敗します): filename の VMwareVirtualDiskDestination セクションは、リストア対象ディスクと、それらのディスク用のリストアパラメータを指定した一覧を示します。これは、VMwareRestoreParameters セクションの下位セクションです。ここには、仮想マシンディスクごとに、以下のフィールドセットを 1 つ以上含めることができます。セット内のフィールドはカンマで区切り、セット間もカンマで区切る必要があります。

6 番目のセクション (任意)。ファイルの VMwareAdvancedRestoreOptions セクションは、既存の VM にリストアするパラメータを指定します。これは、VMwareRestoreParameters セクションの下位セクションです。

ファイル (nbrestorevm が、リストアする 1 つ以上の仮想マシンディスクのパラメータを記述するファイル) のパス名を指定します。デフォルトでは、nbrestorevm は現在の作業ディレクトリにファイルを作成します。パラメータを取得するバックアップイメージを指定するには、-backupid オプションを使用するか、-s オプションと -e オプションを使用します。-s オプションと -e オプションを指定した場合、NetBackup は日付範囲内で直近のバックアップを使用します。

適切な情報を含めるようにファイルを編集します。VMName フィールドに新しい VM の名前が含まれていることを確認します。ファイルの VMwareVirtualDiskDestination セクションに、1 つ以上のリストア対象の仮想マシンディスクのみが含まれていることを確認します。編集したファイルを -restorespec オプションの入力ファイルとして使用します。このオプションにより、ファイル内で識別された 1 つ以上の仮想マシンディスクがリストアされます。

デフォルトでは、nbrestorevm は現在の作業ディレクトリにファイルを作成します。別のディレクトリにファイルを作成するには、filename のパス名を指定します。そのパスは NetBackup のパスのホワイトリストに含まれている必要があります。カスタムパスを追加する方法について詳しくは、『NetBackup 管理者ガイド Vol. 1』の「NetBackup サーバーおよびクライアントの BPCD_WHITELIST_PATH オプション」のトピックを参照してください。

マスターサーバーを指定して、そのマスターによって作成されたバックアップから仮想マシンをリストアします。

選択可能なバックアップイメージを、指定された期間内のタイムスタンプがあるものに制限します。NetBackup は範囲内で最新の適切なバックアップイメージを選択します。表示の対象とする開始日時 (-s) と終了日時 (-e) を指定します。開始日および終了日は有効なバックアップイメージを検索する時間範囲を示します。指定された時間範囲内の最新の有効なバックアップイメージを使ってリストアを実行します。これらのオプションは、BMR の VM 変換を除くすべての関数と使われます。

仮想マシンがリストアされるまでにすべての書き込みが行われる VM ホストサーバー上の一時データストアを指定します。ストレージ vMotion が完了するか、仮想マシンでのトラブルシューティングのためなどの作業が終了するまで、すべての書き込みがこのデータストアで発生します。このデータストアは nbrestorevm を実行する前に存在する必要があります。このオプションは -ir_activate とのみ使うことができます。このオプションはインスタントリカバリとのみ使われます。

filename 内の仮想マシンディスクのリストアパラメータを検証します。-restorespec オプションは必須で、-validate オプションを続けて指定する必要があります。

filename の説明については、-restorespec オプションの説明を参照してください。

vCloud 仮想マシンをリストアします。このオプションは vCloud の元の場所または代替の場所にリストアするときに必要になります。

利用可能な最も大きい領域があるデータストアを使って vCloud 仮想マシンをリストアします。このオプションは元の場所にダイレクトされないリストア操作にだけ適用されます。

既存の vCloud vApp を上書きします。

vCloud のリストアをリダイレクトします。

-vcdtemplate オプションを使用して vApp をテンプレートとして保存する場合は vApp を削除します。

既存の vCloud vApp に vCloud 仮想マシンをリストアします。このオプションは、元の場所のリストアを含む既存の 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)"

次に、これらのエントリに関する注意点を示します。

リストアされたディスクのディスク形式は「eager zero」となります。

フラットディスクとして VMDK ファイルをリストアします。

仮想マシンを再アクティブ化するとき、仮想マシンがマウントされた VM ホストを指定します。

元の位置に Hyper-V 仮想マシンをリストアします。

新しい場所に Hyper-V 仮想マシンをリストアします。

ステージングの場所に Hyper-V 仮想マシンのファイルをリストアします。

新しいものを作成するかわりに、仮想マシンの BIOS UUID をリストアします。

VMware の場合: 新しいものを作成するかわりに、仮想マシンの BIOS UUID をリストアします。

Hyper-V の場合: 新しいものを作成するかわりに、仮想マシンの 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 です。

VMX ファイルが指定された同じデータストアに VMware VMDK ファイルをリストアすることを許可します。別の vmdk ファイルパスを指定する名前変更ファイルは、このオプションを上書きします。

VMware 仮想マシンをリストアします。

このオプションを指定すると、NetBackup はサーバーから完了状態が送信されるまで待機し、その後、システムプロンプトに戻ります。

NetBackup コマンドの日時の値に求められる形式は、使用しているロケールによって異なります。/usr/openv/msg/.conf ファイル (UNIX) と install_path\VERITAS\msg\LC.CONF ファイル (Windows) はそれぞれのサポート対象ロケールの日時形式などの情報を含んでいます。これらのファイルには、サポートされているロケールおよび書式のリストを追加および変更するための、具体的な方法が含まれています。

『NetBackup 管理者ガイド Vol. 2』の NetBackup インストールのロケールの指定に関する項を参照してください。

必要に応じて、待機時間を時間、分、秒で指定できます。指定可能な最大待機時間は、23:59:59 です。リストアが完了する前に待機時間が経過すると、コマンドはタイムアウト状態で終了します。ただし、サーバー上ではリストアが完了します。

0 (ゼロ) を指定した場合または時間を指定しない場合、完了状態が無期限に待機されます。