- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- 移行後にログインできない
- 管理ポータルのタイムアウト期間を設定する
- 基になるディレクトリ接続を更新する
- Kinit: Cannot Find KDC for Realm <AD Domain> While Getting Initial Credentials
- kinit: Keytab contains no suitable keys for *** while getting initial credentials
- GSSAPI operation failed with error: An invalid status code was supplied (Client's credentials have been revoked).
- Login Failed for User <ADDOMAIN><aduser>. Reason: The Account Is Disabled.
- Alarm received for failed kerberos-tgt-update job
- SSPI Provider: Server not found in Kerberos database
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドルを使用する
- ログを確認する
準備
-
ノードに十分なディスク領域があることを確認します。
-
選択したサーバーで、オフライン バンドルをすべて (
sf.tar.gz) ダウンロードします。 -
プライマリ サーバーで、新しいインストーラー (
installer.zip) をダウンロードして解凍します。注:sudo chmod 755 -R <installer-folder>を実行し、フォルダーに適切な権限を付与します。 -
元の
cluster_config.jsonファイルをサーバーで使用できるようにします。 -
次のように、新しい
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.jsoncd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json -
古い構成ファイルがない場合は、次のコマンドを実行します。
cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.jsoncd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json注:See Advanced installation experience to fill up the remaining parameters.
-
実行
メンテナンスとバックアップ
-
Make sure you have enabled the backup on the cluster. For details, see Backing up and restoring the cluster.
-
SSH を介してサーバー ノードに接続します。
-
次のコマンドを実行して、すべてのボリュームがクラスターにバックアップされていることを確認します。
/path/to/new-installer/configureUiPathAS.sh verify-volumes-backup/path/to/new-installer/configureUiPathAS.sh verify-volumes-backup注:バックアップには時間がかかることがあるため、その場合は 15 分から 20 分ほど待ってから再度ボリュームのバックアップを確認してください。
-
Automation Suite が正常かどうかを確認するには、以下を実行します。
kubectl get applications -n argocdkubectl get applications -n argocd -
次の手順に従って、クラスターをメンテナンス モードにします。
-
次のコマンドを実行します。
/path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode/path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode -
次のコマンドを実行して、クラスターがメンテナンス モードであることを確認します。
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled
-
-
SQL データベースのバックアップを作成します。
サーバー上のインフラストラクチャとサービスをアップグレードする
-
SSH を介してサーバーに接続します。
-
sudo su -を実行してルートになります。 -
次のコマンドを実行します。
/path/to/new-installer/install-uipath.sh --upgrade -k -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/path/to/new-installer/install-uipath.sh --upgrade -k -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/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/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注:アップグレード中にはすべてのサービスが起動されている必要があるため、このコマンドは有効化したメンテナンス モードをアップグレード前に無効化します。また、このコマンドは、クラスター ステートのバックアップを作成し、スケジュールされているその他すべてのバックアップを一時停止します。
-
アップグレードと検証が正常に終了したら、次のコマンドを実行することにより、ノード上でバックアップ スケジュールを再開します。
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups
Rollback on Error
準備
-
古いバンドルを保存するための個別フォルダーを作成し、そのフォルダー内で次の操作を実行します。
-
すべてのノードで、古いバージョンに対応する、インフラストラクチャのみのオフライン バンドル (
sf-infra-bundle.tar.gz) をダウンロードします。 -
旧バージョンのインストーラー (
installer.zip) をすべてのノードにダウンロードして解凍します。注:sudo chmod 755 -R <installer-folder>を実行し、フォルダーに適切な権限を付与します。 -
Create a
restore.jsonfile and copy it to the node. For details, see Backing up and restoring the cluster. -
プライマリ サーバーの次の場所に etcd バックアップ データが存在することを確認します。
/mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshotsetcdBackupPath- これは、バックアップのnode-nameを有効化している場合にbackup.jsonで指定されたものと同じです。node-name- プライマリ サーバーの仮想マシンのホスト名。
クラスター クリーンアップ
- Copy and run the dedicated script to uninstall everything from that node. For details, see Troubleshooting.
- すべての UiPath データベースを、アップグレード前に作成した古いバックアップに復元します。
サーバー ノードでインフラストラクチャを復元する
-
サーバー ノードに接続します。
-
次のコマンドを実行してインフラストラクチャを復元します。
/path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --offline-bundle "/path/to/older-version/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline/path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --offline-bundle "/path/to/older-version/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline
Restore Volumes Data
-
SSH を介してサーバーに接続します。
-
新しいインストーラー フォルダーに移動します。
注:以前のインフラストラクチャ復元コマンドは、古いインストーラーを使用して実行されていました。次のコマンドは、新しいインストーラー バンドルを使用して実行されます。
-
次のコマンドを実行して、クラスターでメンテナンス モードを無効化します。
/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode/path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode -
次のコマンドを実行して、メンテナンス モードが無効であることを確認します。
/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled/path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled -
インフラストラクチャ復元段階で使用された
restore.jsonファイルを、新しいインストーラー バンドル フォルダーにコピーします。 -
次のコマンドを実行して、新しいインストーラー バンドルからボリュームを復元します。
/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 offline/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 offline -
復元が完了したら、すべてが復元され、適切に機能していることを確認します。
-
アップグレード時には、スケジュールされたバックアップがこのノードで無効化されていました。これらを再度有効化するには、次のコマンドを実行します。
/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups/path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups