新しいクラスターへデータを移行する

オフラインのみ

1. ソース クラスターで実行されている Docker レジストリを、アップグレード後のバージョンに対応するバンドルでハイドレートします。/uipath マウント ポイントで UiPath® バンドル ディスクを接続したソース クラスターのサーバー マシンに as.tar.gz をダウンロードしてください。推奨される場所は /uipath/<new_version>/as.tar.gzです。

2. バンドルを解凍するための一時的な場所を作成します。

   mkdir -p /uipath/tmp

3. ソース クラスターの Docker レジストリを最新のオフライン バンドルでハイドレートします。

   ./bin/uipathctl registry upload --offline-bundle /uipath/<new_version>/as.tar.gz --offline-tmp-folder /uipath/tmp

注:

クラスターをメンテナンス モードにする前にデータ移行スクリプトを実行して、ダウンタイム期間中の移行時間を短縮できます。

ソース クラスター データベースを複製する

重要:

• 共有コンポーネントとサービスのインストール中に、インストーラーが既定の名前で新しいデータベースを作成できるよう許可できます。 詳しくは、「 Microsoft SQL Server を構成する」をご覧ください。

• データベース名が異なる場合は、インストーラーによって作成されたデータベースを削除し、ソース SQL Server から新しい SQL Server にデータベースをコピーし、データベース名を保持する必要があります。

• 新しい SQL Server でデータベースの名前を変更する場合は、インストールする各製品の cluster_config.json ファイルを慎重に編集する必要があります。

1. 必ずソース クラスターで新しいインストーラーを入手して、データを新しいターゲット クラスターに移行してください。 移行をトリガーする予定のソース クラスターのいずれかのサーバー ノードにある「マシンにインストール パッケージをダウンロードして取得する」の手順を実行します。

2. ソースク ラスターをメンテナンス モードにします。

   ./bin/uipathctl cluster maintenance enable

   重要:

   ダウンタイムが始まります。

3. 任意の方法を使用して、データベースをターゲット クラスターにコピーします。たとえば、データベース コピー ウィザードを使用できます。

ソース クラスター データを複製する

1. 次のコマンドを実行して、データ移行を実行するターゲット クラスターの target_kubeconfig ファイルを取得します。

   ./bin/uipathctl config kubeconfig get --migration

   注: ターゲットのクラスター内 ObjectStore の情報を取得し、ターゲット バージョンに必要なデータ コピーを実行するには、target_kubeconfig ファイルが必要です。
2. 生成されたファイルをソース クラスターにコピーします。このファイルは、データ移行中に使用する必要があります。次の手順では、 <target_kubeconfig> をこのファイル パスに置き換える必要があります。

3. ソース クラスターでデータ移行スクリプトを実行して、ソース クラスターからターゲット クラスターにデータをコピーします。

   cd /opt/UiPathAutomationSuite/<new_version>/installer
   ./bin/uipathctl cluster migration run cluster_config.json --target-kubeconfig <target_kubeconfig> --versions versions/helm-charts.json

   注:

   • 前の移行コマンドはべき等です。 ネットワーク接続が原因でコマンドが途中で失敗した場合は、コマンドを再実行すると、中断した場所から移行プロセスが続行されます。
   • 必要に応じて、移行コマンドを再度実行して、データ移行の差分同期を実行できます。
   重要:

   クラスターがクラスター内 ObjectStore (Ceph) を使用していて、サイドバイサイド アップグレード (シングル ノード起動) を選択している場合、 CEPH_SPACE_VALIDATION 前提条件の確認で移行コマンドが失敗することがあります。

   これは、ソース クラスターにデータのレプリカが 3 つあり、ターゲット クラスターが単一ノードの非 HA であるために発生します。この場合、前提条件の確認をスキップできます。

   ./bin/uipathctl cluster migration run cluster_config.json --target-kubeconfig
           <target_kubeconfig> --versions versions/helm-chart.json
       --skip-pre-reqs

4. ソース クラスターで外部 ObjectStore を使用する場合は、ObjectStore のバケットを複製します。