VM の移行（マイグレーション）、エクスポート、インポート

本番データを含まない使い捨ての VM を使用します。管理者として XOA-HL アプライアンスにログインし、ホスト、ストレージ、VM が利用できることを確認してください。移行とエクスポートは VM 全体を移動またはコピーする操作であり、どちらも独立したバックアップと復元テストの代わりにはなりません。

1. 操作を選ぶ

このガイドは、同じプール内のホスト間の移行、圧縮なしの XVA エクスポート、XVA ファイルのインポートを扱います。プール間の移行、ネットワークの再割り当て、OVA ファイル、URL からのインポート、ディスク単体のインポート・エクスポート、VMware からのインポートは対象外です。HomeLab のメニューでは VMware インポートの項目が非表示になっています。

2. プール内で VM を移行する

開始前に確認する前提条件：

• プールに接続済みのホストが 2 台以上あり、VM と移行先ホストに対する管理権限を持っていること。
• 移行先ホストから VM のネットワークとストレージに到達できること。共有 SR 上のディスクはコピーされません。ローカル SR など、移行先から到達できないストレージ上のディスクはコピーされます。
• メンテナンス時間を確保すること。ライブマイグレーション中は実行中のゲストが短時間停止します。ディスクのコピーには時間がかかり、移行先 SR の空き容量が必要です。
• VM の ID、現在のホスト、各ディスクとその SR を記録し、コンソールへのログインやアプリケーションのテストなど、ゲストの確認方法を用意すること。

1. VM を開き、移設(マイグレーション) を選びます。実行中と停止中の VM で表示され、サスペンド中や一時停止中の VM では表示されません。セルフサービスのユーザーには表示されません。
2. Migrate VM で、Select a destination host: から同じプールの別のホストを選びます。このバージョンでは、移行ダイアログのラベルは翻訳されていません。一覧には現在のホストは含まれません。接続済みの別のプールのホストが表示される場合もありますが、この練習では選ばないでください。
3. ストレージの項目を確認します。すべてのディスクが共有 SR 上にあれば、SR の選択は不要です。そうでない場合、XO はメインの SR (Select main SR…) を要求し、VDI ごとに SR を選択できます。十分な空き容量がある書き込み可能な SR を選んでください。これらのディスクはコピーされます。
4. Select a migration network: はプール内の移行では省略できます。移行先ホストがプールに設定された移行用ネットワーク上にアドレスを持つ場合、XO はそのネットワークを事前に選択します。ネットワークを選択すると、XO は単純なプール内移行ではなくストレージ移行の処理を使います。プールの設計で別のネットワークが指定されていない限り、提示された値のままにしてください。
5. 確認してタスクの完了を待ちます。移行中に繰り返しクリックしないでください。
6. VM の一般タブを再読み込みします。ホスト、電源状態、コンソール、ゲストのネットワーク、アプリケーションを確認します。ディスクをコピーした場合は、各ディスクの配置先と両方の SR の空き容量を確認します。

単純なプール内移行で SR が必要と報告されると、XO は自動的にストレージ移行として再試行します。このとき、移行先ホストに接続された SR、またはプールのデフォルト SR が使われます。短時間で終わると想定した移行が、ディスクのコピーになる場合があります。移行が失敗した場合は、タスクのエラーを保存し、再試行する前に VM のホスト、電源状態、関係するすべての SR 上のディスクを確認してください。強制オプションで再試行しないでください。

3. 停止中の VM を XVA ファイルにエクスポートする

VM に対する管理権限と、ブラウザーを実行するコンピューターの十分な空き容量が必要です。

1. ゲストを正常にシャットダウンし、Halted を確認します。VM の ID、名前、ディスクとその合計サイズを記録します。
2. エクスポートを選びます。Type は xva のままにします。圧縮は既定値の Disabled のままにします。その他の選択肢は GZIP (very slow) と、XCP-ng ホストでの Zstd です。圧縮した XVA のインポートはこのガイドの対象外です。
3. 確認します。Download VM には、ダウンロードリンク、OK、キャンセルが表示されます。リンクと OK は同じ URL を開き、メッセージではこの URL は短時間に一度だけ有効と説明されています。どちらか一方だけを使ってください。リンクを選んだ後、キャンセルでダイアログを閉じます。URL には一回限りのアクセストークンが含まれるため、使用するまで秘密情報として扱ってください。
4. ブラウザーは <日付> - <VM 名>.xva という名前のファイルを保存します。ダウンロードは最後まで続けてください。キャンセルするとエクスポートも停止します。記録したディスクサイズと比べて、ファイルサイズが妥当か確認します。
5. ブラウザーを実行するコンピューターで、sha256sum "<ファイル>.xva" などでファイルのチェックサムを記録します。インポート前のファイル確認に使います。

既定では、1 つのプールで同時に実行できる XVA エクスポートは 2 件までです。それを超えるダウンロードは待機せずに失敗します。実行中のエクスポートが終わってから、新しいリンクを取得してください。

XVA には VM のディスクと構成が含まれます。中のデータと同じように保管し、テストが終わったら削除してください。エクスポートファイルにはスケジュール、保持期間、復元の確認がないため、バックアップジョブではありません。

4. XVA を隔離したコピーとしてインポートする

1. インポート > VM (/#/import/vm) を開きます。このメニュー項目は、少なくとも 1 つのプールを操作できる場合にだけ表示されます。
2. 作成先プール: で対象のプールを選びます。作成先SR: にはプールのデフォルト SR が提示されます。十分な空き容量がある書き込み可能な SR を選んでください。
3. OVA、あるいはXVAファイルをドラッグアンドドロップしてください。 と表示された領域に .xva ファイルをドロップします。一覧でファイル名とサイズを確認します。拡張子が .xva または .ova でないファイルは無視されます。From URL は無効のままにします。
4. インポートを選び、アップロードが終わるまでブラウザーのタブを開いたままにします。ファイルが 1 つの場合、成功すると XO は新しい VM のページを開きます。
5. インポートした VM は停止したままにします。ID を記録してください。名前が同じでも、元の VM とは別のオブジェクトです。混同しないよう名前を変更します。
6. 初回起動の前にネットワークを開き、すべての仮想インターフェースを削除するか、確認済みの外部隔離を用意します。コピーには、元の VM と同じゲスト OS、IP 設定、ホスト名、認証情報、アプリケーションの識別情報が含まれます。
7. コピーを起動し、コンソールと記録したテストデータを確認します。

インターフェースの MAC アドレスが、同じ VM の別のインターフェースや実行中の VM のインターフェースと重複している場合、XO は VM の起動を拒否します。エラーコードは DUPLICATED_MAC_ADDRESS です。強制起動はせず、先にインターフェースを削除または隔離してください。

インポートが失敗した場合 (仮想マシン(VM)のインポートに失敗しました。)、オブジェクトが残っている場合があります。再試行する前に、移行先 SR のディスクと VM 一覧で、試行中に作成されたオブジェクトを確認してください。確実に特定できた残りのオブジェクトだけを、使い捨て VM の削除手順で削除します。

5. 後片付け

1. インポートしたテスト VM を使い捨て VM の削除手順で削除します。
2. コンピューターと一時的な保存場所から XVA ファイルを削除します。
3. 元の VM が想定したホスト上に残っており、ディスクとデータが変わっていないことを確認します。

想定と異なる点があれば、記録を保存し、バージョンと機密情報を除いた ID を添えて問題を報告してください。