オフラインのマルチノードの高可用性対応の運用環境モード

準備

1. オフライン インストールのディスク要件を満たすサーバー (エージェントではない) を特定します。これは、このドキュメントでは、プライマリ サーバーと呼ばれています。

   自己署名証明書を使用している場合は、次のコマンドを実行します。

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   sudo ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   
   ### Update the trust store
   sudo update-ca-trust

2. 選択したサーバーで、オフライン バンドルをすべて (sf.tar.gz) ダウンロードします。
3. その他すべてのノードで、インフラストラクチャのみのオフライン バンドル (sf-infra.tar.gz) をダウンロードします。
4. すべてのノードで、新しいインストーラー (installer.zip) をダウンロードして解凍します。
   注: sudo chmod 755 -R <installer-folder> を実行し、フォルダーに適切な権限を付与します。
5. 元の cluster_config.json をプライマリ サーバーで使用できるようにします。
6. 次のように、新しい cluster_config.json ファイルを生成します。

   • 古い cluster_config.json ファイルがある場合は、次のコマンドを使用して、クラスターから構成ファイルを生成します。

     cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

   • 古い cluster config ファイルがない場合は、次のコマンドを実行します。

     cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

     注: 残りのパラメーターを入力するには、「高度なインストール」をご覧ください。
7. この cluster_config.json を、すべてのノードのインストーラー フォルダーにコピーします。

実行

メンテナンスとバックアップ

1. クラスターのバックアップが有効化されていることを確認します。詳細については、「クラスターをバックアップおよび復元する」をご覧ください。
2. SSH を介していずれかのサーバー ノードに接続します。
3. 次のコマンドを実行し、必要なすべてのボリュームがクラスターにバックアップされていることを確認します。

   /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup

   注: バックアップには時間がかかることがあるため、その場合は 15 分から 20 分ほど待ってから再度ボリュームのバックアップを確認してください。
4. Automation Suite が正常かどうかを確認するには、以下を実行します。

   kubectl get applications -n argocd

5. 次の手順に従って、クラスターをメンテナンス モードにします。
   1. 次のコマンドを実行します。

      /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

   2. 次のコマンドを実行して、クラスターがメンテナンス モードであることを確認します。

      /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

6. SQL データベースのバックアップを作成します。

サーバー上のインフラストラクチャをアップグレードする

注: サーバーおよびエージェントでのインフラストラクチャの同時アップグレードはサポートされていません。実行すると、エラーが発生します。これらの手順は連続して実行してください。

1. SSH を介して各サーバーに接続します。
2. sudo su - を実行してルートになります。
3. すべてのサーバー ノードで次のコマンドを実行します。

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

   注: また、このコマンドは、クラスター ステートのバックアップを作成し、スケジュールされているその他すべてのバックアップを一時停止します。

エージェント上のインフラストラクチャをアップグレードする

注: サーバーおよびエージェントでのインフラストラクチャの同時アップグレードはサポートされていません。実行すると、エラーが発生します。これらの手順は連続して実行してください。

1. SSH を介して各サーバーに接続します。
2. sudo su - を実行してルートになります。
3. 次のコマンドを実行します。

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

プライマリ サーバーでアップグレードの残りを実行する

1. SSH を介してプライマリ サーバーに接続します。
2. sudo su - を実行してルートになります。
3. 次のコマンドを実行します。

   /path/to/new-installer/install-uipath.sh --upgrade -f -s -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json

   注: アップグレード中にはすべてのサービスが起動されている必要があるため、このコマンドは有効化したメンテナンス モードをアップグレード前に無効化します。
4. アップグレードと検証が正常に終了したら、次のコマンドを実行することにより、ノード上でバックアップ スケジュールを再開します。

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

エラー時のロールバック

準備

1. 古いバンドルを保存するための個別フォルダーを作成し、そのフォルダー内で次の操作を実行します。
2. 旧バージョンのインストーラー (installer.zip) をすべてのノードにダウンロードして解凍します。
   注: sudo chmod 755 -R <installer-folder> を実行し、フォルダーに適切な権限を付与します。
3. restore.json ファイルを作成し、これをすべてのノードにコピーします。詳細については、「クラスターをバックアップおよび復元する」をご覧ください。
4. プライマリ サーバーの次の場所に etcd バックアップ データが存在することを確認します。/mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots
   • etcdBackupPath - これは、バックアップの node-name を有効化している場合に backup.json で指定されたものと同じです。
   • node-name - プライマリ サーバーの仮想マシンのホスト名。

クラスター クリーンアップ

1. 専用のスクリプトをコピーして実行し、そのノードからすべてをアンインストールします。これをすべてのノードに対して実行します。詳細については、「トラブルシューティング」をご覧ください。
2. すべての UiPath データベースを、アップグレード前に作成した古いバックアップに復元します。

サーバー ノードでインフラストラクチャを復元する

1. プライマリ サーバー (アップグレード時に選択したものと同じ) に接続します。
2. 次のコマンドを実行してインフラストラクチャを復元します。

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online

3. SSH を介して残りのサーバー ノードに 1 つずつ接続します。
4. 次のコマンドを実行して、これらのノードでインフラストラクチャを復元します。

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j server --accept-license-agreement --install-type online

   注: このコマンドをサーバー ノードで 1 つずつ実行します。これらの並列実行はサポートされていません。

エージェント ノードでインフラストラクチャを復元する

1. SSH を介して各エージェント VM に接続します。
2. 次のコマンドを実行して、これらのノードでインフラストラクチャを復元します。

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j agent --accept-license-agreement --install-type online

ボリューム データを復元する

1. SSH を介してプライマリ サーバーに接続します。
2. 新しいインストーラー フォルダーに移動します。
   注: 以前のインフラストラクチャ復元コマンドは、古いインストーラーを使用して実行されていました。次のコマンドは、新しいインストーラー バンドルを使用して実行されます。
3. 次のコマンドを実行して、クラスターでメンテナンス モードを無効化します。

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. 次のコマンドを実行して、メンテナンス モードが無効であることを確認します。

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. インフラストラクチャ復元段階で使用された restore.jsonfile を、新しいインストーラー バンドル フォルダーにコピーします。
6. 次のコマンドを実行して、新しいインストーラー バンドルからボリュームを復元します。

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type online

7. 復元が完了したら、すべてが復元され、適切に機能していることを確認します。
8. アップグレード時には、スケジュールされたバックアップがプライマリ ノードで無効化されていました。これらを再度有効化するには、次のコマンドを実行します。

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups