- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- Longhorn のスナップショットを自動的にクリーンアップする方法
- TX チェックサム オフロードを無効化する方法
- TLS 1.2 で弱い暗号に対処する方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- Longhorn のセットアップ中に最初のインストールが失敗する
- SQL 接続文字列の検証エラー
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- プロキシ設定がある場合に Automation Hub と Apps を起動できない
- 管理ポータルのタイムアウト期間を設定する
- 基になるディレクトリ接続を更新する
- 移行後に認証が機能しない
- Kinit: Cannot find KDC for realm <AD Domain> while getting initial credentials
- kinit: Keytab contains no suitable keys for *** while getting initial credentials
- 無効なステータス コードが原因で GSSAPI 操作が失敗した
- Alarm received for failed kerberos-tgt-update job
- SSPI Provider: Server not found in Kerberos database
- アカウントが無効なため AD ユーザーのログインに失敗した
- ArgoCD へのログインに失敗した
- サンドボックス イメージを取得できない
- ポッドが ArgoCD UI に表示されない
- Redis プローブの障害
- RKE2 サーバーの起動に失敗する
- UiPath 名前空間でシークレットが見つからない
- 初回インストール後に ArgoCD が進行中ステートになる
- Unexpected inconsistency; run fsck manually
- MongoDB ポッドが CrashLoopBackOff になるか、削除後に PVC プロビジョニングの保留中になる
- MongoDB ポッドを 4.4.4-ent から 5.0.7-ent にアップグレードできない
- クラスターの復元またはロールバック後にサービスが異常になる
- Init:0/X でポッドがスタックする
- Prometheus が CrashloopBackoff ステートにあり、メモリ不足 (OOM) エラーを伴う
- Ceph-rook のメトリックが監視ダッシュボードに表示されない
- プロキシ環境でポッドが FQDN と通信できない
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドルを使用する
- ログを確認する
自動: オンライン アップグレード
Ansible を使用すると、複数の操作をクラスター内の 1 つのマシンで実行することで、Automation Suite クラスター全体のアップグレードを自動化できます。
次の図では、Server 1 ノード (または Ansible ホスト ノード) が Ansible を使用して Automation Suite クラスター全体のアップグレードをオーケストレーションしています。
準備
Before upgrading, make sure you have prepared your environment for using the uipathctl.sh script. For details, see Using uipathctl.sh.
すべてのノードの /opt/UiPathAutomationSuite フォルダーに 10 GiB の空き領域があることを確認します。十分な領域がない場合は、このフォルダーの容量を増やすか、以前のインストーラー ファイル (cluster_config.json を除く) をすべて削除できます。以前のインストーラーは、いつでも再度ダウンロードできます。
利用可能な領域を確認するには、コマンド df -h /opt/UiPathAutomationSuite を実行します。
アップグレードの準備をするには、次の手順に従います。
-
Log into the server node that you previously identified as the Ansible host node via SSH.
-
ルート ユーザーになります。
sudo su -sudo su - -
/opt/UiPathAutomationSuiteディレクトリの下にインストール フォルダーを作成します。# Please replace {version} with installer version mkdir -p /opt/UiPathAutomationSuite/{version}/installer# Please replace {version} with installer version mkdir -p /opt/UiPathAutomationSuite/{version}/installer -
Download
sf-installer.zipand copy it to/opt/UiPathAutomationSuite/{version}/installer. For download instructions, see sf-installer.zip.cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installercp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer -
sf-installer.zipを解凍します。cd /opt/UiPathAutomationSuite/{version}/installer unzip sf-installer.zip -d .cd /opt/UiPathAutomationSuite/{version}/installer unzip sf-installer.zip -d . -
インストーラーに必要な権限を付与します。
chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer .chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer . -
Ansible ホスト ノードで最新の
cluster_config.jsonファイルを生成します。注:For details on how to configure the
cluster_config.jsonparameters, see Advanced installation experience.-
古い
cluster_config.jsonがある場合は、クラスターから構成ファイルを生成します。cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.jsoncd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json -
古い
cluster_config.jsonファイルがない場合は、既定値の上書きを生成します。これは、以前のバージョンのインストール時に生成済みである可能性があります。cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh config get -o ./cluster_config.jsoncd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh config get -o ./cluster_config.json -
Automation Suite を以前のバージョンからアップグレードし、続いて Process Mining を有効化する場合は、
sql_connection_string_template_sqlalchemy_pyodbcを更新する必要があります。以下に例を示します。"sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server""sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
-
See also Manual: Advanced installation experience.
If you previously deployed your single-node installation using any Azure template version prior to 2022.10.3, and you now want to upgrade to a newer Automation Suite version, you must set the zone_resilience flag to false in the cluster_config.json file in /opt/UiPathAutomationSuite/Installer.
実行
アップグレード中またはアップグレード後にエラーや問題が発生した場合、以前にバックアップを構成していれば、以前のバージョンにロールバックできます。
For instructions, see Rollback on error.
バックアップを構成する
バックアップを構成するには、次の手順に従います。
-
Make sure you have enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the Automation Suite version from which you plan to upgrade. For instance, if you plan to upgrade from Automation Suite 2021.10, follow the instructions in the 2021.10 guide.
-
Log into the server node that you previously identified as the Ansible host node via SSH.
-
必要なすべてのボリュームがクラスターにバックアップされていることを確認します。
/path/to/old-installer/configureUiPathAS.sh verify-volumes-backup/path/to/old-installer/configureUiPathAS.sh verify-volumes-backup注:バックアップには時間がかかることがあるため、その場合は 15 分から 20 分ほど待ってから再度ボリュームのバックアップを確認してください。
バックアップが作成されたら、続いて次の手順を実行します。
クラスターをメンテナンス モードにする
クラスターをメンテナンス モードにすると、イングレス コントローラーとすべての UiPath サービスがシャットダウンし、Automation Suite クラスターへのすべての受信トラフィックがブロックされます。
この操作によりダウンタイムが発生し、ビジネス オートメーションはアップグレード プロセス全体で中断されます。
-
クラスターをメンテナンス モードにするには、以下を実行します。
cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh enable-maintenance-modecd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh enable-maintenance-mode -
クラスターがメンテナンス モードであることを確認するには、以下を実行します。
./configureUiPathAS.sh is-maintenance-enabled./configureUiPathAS.sh is-maintenance-enabled重要:メンテナンス モードを有効化した後に、SQL Server のバックアップを作成し、トランザクションがこれ以上 SQL データベースに記録されないようにします。
クラスターをアップグレードする
Automation Suite クラスターをアップグレードするには、次の手順に従います。
-
SSH を介して Ansible ホスト ノードに接続し、ルート ユーザーになります。
-
すべてのノードでアップグレード手順を実行するには、基本パラメーターを使用して次のコマンドを実行します。より細かい制御が必要な場合は、「パラメーター」セクションをご覧ください。
注:準備手順の説明に従って生成した
cluster_config.jsonを更新したことを確認してください。./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type online --steps all --accept-license-agreement./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type online --steps all --accept-license-agreement重要:アップグレード プロセスでは、Canal CNI から Cilium CNI に移行する必要があります。自動アップグレードによってこの手順が自動的に実行された後、クラスター内のすべてのノードが再起動されて移行が完了します。
ノードが再起動したら、数分待ってから、すべてのサービスが再びオンラインになっていることを確認します。ArgoCD にログインして、すべてのアプリケーションのステータスを監視できます。
重要:If you get the following error, follow the instructions in Downgrading Ceph from 16.2.6 to 15.2.9.
Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph
基本パラメーター
| パラメーター | 値 (Value) |
|---|---|
|
|
設定可能な値: このページではオンライン環境での手順について説明しているので、 |
|
|
設定可能な値は、
アップグレード中にエラーが発生した場合は、これらのチェックポイントを使用すると、アップグレード操作を最初からリトライするのではなく、再開できます。 |
|
|
|
詳細パラメーター
| パラメーター | 値 (Value) |
|---|---|
--ansible-username | すべてのノードへの SSH 接続に使用するユーザー名を指定します。既定では、現在のユーザーが設定されます。すべてのノードで異なるユーザー名を使用する場合は、このパラメーターを使用するのではなく、inventory.ini ですべてのノードのユーザー名を設定して、スクリプトに渡します。例: スクリプトの実行中は、ユーザー名 myadminuser でログインします。一方で、SSH を介して接続するときにユーザー名 testadmin を使用する場合は、このパラメーターを設定するときに testadmin を使用する必要があります。 |
--inventory | 既存の Ansible のインベントリ ファイルを指定します。指定しない場合は、既存のクラスターから基本の構成を持って自動的に生成されます。 より細かく制御したい特定のシナリオでは、独自のインベントリ ファイルを指定できます。たとえば、クラスター内のすべてのノードに対して異なる SSH ユーザー名や SSH キーを使用する場合が考えられます。 For details, see Generating the Ansible inventory.ini file. |
アップグレードが完了すると、メンテナンス モードは自動的に無効化されます。
アップグレードの実行後、次の追加手順を実行できます。
-
Automation Suite が正常かどうかを確認するには、以下を実行します。
kubectl get applications -n argocdkubectl get applications -n argocd -
If you experience issues with image vulnerabilities or storage consumption after performing an upgrade, delete the images from the old installer. For details, see the Troubleshooting section.
アップグレード後にバックアップを有効化する
次の手順に進む前に、Automation Suite が稼働中でありオートメーションが期待どおり続行されていることを確認します。
クラスターのアップグレードを開始する前に、アップグレード スクリプトによってクラスターのバックアップが自動的に作成され、その後一時的に無効化されます。アップグレードが完了したら、手動でバックアップを有効化できます。
To enable the backup, follow the instructions in described in the Backing up and restoring the cluster documentation.
デプロイ テンプレートを使用したアップグレードを完了する
After performing an Automation Suite cluster upgrade, Azure and AWS template deployments require some changes to ensure a new node joins the cluster correctly through scale-out operations. To automate the changes, we recommend using the dedicated scripts. For instructions, see the Azure deployment template docs and the AWS deployment template docs.
特別な考慮事項
Azure テンプレートを使用してデプロイされたクラスターに対してアップグレードを実行すると、次の画像のようなエラーが発生する場合があります。
これは 、Azure ロード バランサーの動作の仕組みが原因です。この問題を修正するには、cluster_config.json ファイルの [fixed_rke_address] フィールドを変更します。アップグレード コマンドを実行する前に、このフィールドの値を最初のサーバー インスタンスの IP アドレスに変更する必要があります。Key Vault にアップロードされる cluster_config.json は、ノードが正常ではなく、トラフィックのバランスが取れないため、ILB の IP アドレスが引き続き設定されている必要があります。