- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- Longhorn のスナップショットを自動的にクリーンアップする方法
- TX チェックサム オフロードを無効化する方法
- ArgoCD のログ レベルを手動で Info に設定する方法
- 外部レジストリーのエンコードされたpull_secret_valueを生成する方法
- TLS 1.2 で弱い暗号に対処する方法
- 証明書の操作方法
- クラスター内の ObjectStore (Ceph) を使用して DU の使用状況データを収集する方法
- エアギャップ環境に RKE2 SELinux をインストールする方法
- NFS サーバー上の古い差分バックアップをクリーンアップする方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- Longhorn のセットアップ中に最初のインストールが失敗する
- SQL 接続文字列の検証エラー
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- リソースが利用できないことの影響を受ける GPU ノード
- ワークロードの準備ができていないためボリュームをマウントできない
- サポート バンドルのログ収集の失敗
- 管理ポータルのタイムアウト期間を設定する
- 基になるディレクトリ接続を更新する
- 移行後に認証が機能しない
- 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 が進行中ステートになる
- ArgoCD の読み取り専用アカウントにアクセスする際の問題
- MongoDB ポッドが CrashLoopBackOff になるか、削除後に PVC プロビジョニングの保留中になる
- クラスターの復元またはロールバック後にサービスが異常になる
- Init:0/X でポッドがスタックする
- Prometheus が CrashloopBackoff ステートにあり、メモリ不足 (OOM) エラーを伴う
- Ceph-rook のメトリックが監視ダッシュボードに表示されない
- プロキシ環境でポッドが FQDN と通信できない
- アップグレード後にメール アラートを設定できない
- アップストリームに正常な問題はありません
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドルを使用する
- ログを確認する
オンラインのマルチノード高可用性対応運用環境のインストール
このページでは、マルチノードの高可用性対応の運用設定でオンラインの Automation Suite インストールを実行する方法について説明します。
概要
You must meet the hardware and software prerequisites before proceeding with the installation. See Hardware and software requirements.
You can use a dedicated script to validate the installation prerequisites and infrastructure readiness. See Validating the prerequisites.
インストールを円滑に進めるには、UiPath のベスト プラクティスに従ってください。をご覧ください。
これらの手順を実行することで、複数のマシンに Automation Suite をインストールできます。このインストール モードではインターネットへのアクセスが必要です。
インストール プロセスには、次のような一般的手順があります。
| 手順 | 説明 |
|---|---|
| 手順 1: インストール パッケージをダウンロードする | この手順は、Automation Suite をデプロイする予定の、インターネットにアクセスできるマシンから実行する必要があります。インストール パッケージのダウンロードが完了するまでに、後続の手順のいくつかを進めておくことができます。 手順 1: インストール スクリプトをダウンロードし、対話型インストーラーを実行する |
| 手順 2: インストールを構成する | 手順 2.1: 対話型インストーラーを実行し、インストール オプションを設定する このツールは、最も一般的なオプションの入力を収集し、構成ファイルを生成します。 手順 2.1: 既定の構成 手順 2.2: (任意) 高度なインストール オプションを設定する 既定のインストール構成には、すべての製品で使用される共有 SQL Server が含まれます。インストールされた製品をカスタマイズしたり、特定の製品で個別の SQL Server を使用するようにするには、構成ファイルを編集します。 手順 2.2: (任意) 高度な構成 |
| Step 3: Complete the installation | Step 3: You have completed the installation successfully and can move to post-installation steps. 新たに作成されたクラスターとスイートにアクセスしたり、証明書を更新したり、PVC のサイズを変更したりできるようになりました。 手順 3: インストールを完了する |
RHEL kernel version kernel-4.18.0-477.10.1.el8_8 は、Automation Suite クラスターのインストールまたは管理を中断させる問題の影響を受けます。どの Automation Suite ノードも、インストール前またはインストール後にこのバージョンのカーネルを使用していないことを確認してください。以下のコマンドを実行するとカーネルのバージョンを更新できます。
dnf install -y kernel kernel-tools kernel-tools-libs
dnf install -y kernel kernel-tools kernel-tools-libs
手順 1: インストール スクリプトをダウンロードし、対話型インストーラーを実行する
この手順は、Automation Suite のデプロイ先となる、インターネットにアクセスできるマシンで実行する必要があります。ダウンロードが完了するまでに、後続の手順を進めておくことができます。
Automation Suite インストーラーは複数のパッケージのラッパーであり、Red Hat Package Manager (RPM) を使用して依存関係もいくつかインストールします。SQL やその他のインストール オプションなどの外部リソースを構成するのに役立つ対話型エクスペリエンスを提供します。
対話型インストーラーを対象マシンにコピーするには、次の手順を実行します。
-
SSH を使用して最初のマシンに接続します。
-
パスワードを設定する場合のコマンドは次のとおりです。
ssh <user>@<dns_of_vm>ssh <user>@<dns_of_vm> -
SSH キーを使用する場合のコマンドは次のとおりです。
ssh -i <path/to/Key.pem> <user>@<dns_of_vm>ssh -i <path/to/Key.pem> <user>@<dns_of_vm>
-
-
ルートになります。
sudo su -sudo su - -
ホーム ディレクトリに移動します。
cd ~cd ~ -
Download the
installUiPathAS.shinstaller. For instructions, see installUiPathAS.sh. Make sure to download the package suitable for your Automation Suite version. -
unzipとjqをインストールします。yum install unzip jq -yyum install unzip jq -y
Step 2: Configuring the installation
インストーラーは最初のサーバーのみで実行してください。
chmod +x ~/installUiPathAS.sh
./installUiPathAS.sh
chmod +x ~/installUiPathAS.sh
./installUiPathAS.sh
手順 2.1: 既定の構成
対話型インストーラーを実行し、インストール オプションを構成します。このツールは、最も一般的なインストール オプションの入力を収集し、構成ファイルを生成します。既定で高可用性が有効化されますが、高度な構成により無効化できます。
Automation Suite をインストールするには、次の手順に従います。
-
対話型インストーラーを起動します。
-
ライセンス契約に同意してインストールを続行します。
-
In Main Menu, select your deployment mode. Choose Multi-node deployment (recommended for production use) and confirm your selection.
-
[Deployment configuration] で、環境の種類を選択します。[Online] を選択します。
-
製品選択を選びます。以下のオプションがあります。
- Complete (All products)
- Select products
For details on the product selection options, see Hardware and software requirements.
-
前の手順で [Select products] を選択した場合は、インストールする製品を指定します。以下のオプションがあります。
- Action Center
- AI Center
- Apps (アプリ)
- Automation Hub
- Automation Ops
- Automation Suite ロボット
- Data Service
- Document Understanding
- Insights
- Orchestrator
- Process Mining
- Task Mining
- Test Manager
注:Some Automation Suite products have additional dependencies on each other. When selecting the products you want to install, make sure you consider Cross-products dependencies. Trying to install a product without its dependencies would result in an error.
そのほかに、マルチノード設定では Task Mining と Automation Suite ロボットに追加のエージェント ノードが必要です。Document Understanding 用には、GPU がサポートされた追加エージェント ノードもお勧めします。詳しくは、以下のページをご覧ください。
-
AI Center をインストールするには、以下の追加の手順を実行する必要があります。
-
AI Center に外部 Orchestrator が必要かどうかを指定します。
- AI Center に外部 Orchestrator が必要ない場合は、手順 8 に進みます。
- AI Center に外部 Orchestrator が必要な場合は、手順 7.b に進みます。
-
Copy the Orchestrator certificate to the virtual machine. For more information on this, check the Copy the Orchestrator certificate page.
-
AI Center の Orchestrator URL を指定します。例:
https://orchestrator.example.com。 -
AI Center の Identity URL を指定します。例:
https://orchestrator.example.com/identity。 -
Orchestrator の証明書ファイルへのパスを指定します。例:
/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer。 -
Identity の証明書ファイルへのパスを指定します。例:
/opt/UiPathAutomationSuite/UiPath_Installer/identity.cer。 -
メータリング API キーを指定します。
注:metering_api_keyは、AI Center のクラウド アカウントで確認できる Document Understanding API キーです。- To complete the AI Center installation, follow the step from the Completing the installation section.
-
-
製品選択を確認して、ハードウェアおよびソフトウェアの最小要件を判断します。
-
Automation Suite の FQDN を入力します。
-
選択した製品に独自のオブジェクト ストアを使用するかどうかを指定します。[No] を選択した場合は、既定のオブジェクト ストアが選択されます。[Yes] を選択した場合は、以下のいずれかのオプションを選択します。
- Azure Storage Account – Azure Storage アカウントに基づくマネージド ID を使用するかどうかを指定します。選択内容に対応する以下の詳細情報を入力し、選択したすべての製品に対してコンテナーを自動的にプロビジョニングするかどうかを指定します。
- [Yes] の場合は、Azure Storage アカウントの名前とエンドポイント サフィックス、およびクライアント ID を入力します。
- [No] の場合は、Azure Storage アカウントの名前とエンドポイント サフィックス、および Azure アカウント キーを入力します。
- AWS S3 – バケット名のプレフィックスとサフィックス、バケットをホストする AWS リージョン、S3 アカウントのアクセス キーとシークレット キーを指定し、選択したすべての製品に対してバケットを自動的にプロビジョニングするかどうかを指定します。
- Other S3 Compatible storage – バケット名のプレフィックスとサフィックス、S3 サーバーの FQDN、S3 のポート、S3 アカウントのアクセス キーとシークレット キーを指定し、選択したすべての製品に対してバケットを自動的にプロビジョニングするかどうかを指定します。
注:多くの S3 ObjectStore では、Automation Suite クラスターからのトラフィックすべてに CORS を設定する必要があります。CORS ポリシーを ObjectStore レベルで設定して、クラスターの FQDN を許可する必要があります。
- Azure Storage Account – Azure Storage アカウントに基づくマネージド ID を使用するかどうかを指定します。選択内容に対応する以下の詳細情報を入力し、選択したすべての製品に対してコンテナーを自動的にプロビジョニングするかどうかを指定します。
-
SQL 接続に Kerberos 認証を使用するかどうかを指定します。
-
SQL Server の FQDN を入力します。プロンプトに従い、接続ポート、ユーザー名、パスワードを入力します。
注:Process Mining をインストールする場合は、2 つ目の SQL Server を推奨します。ウェアハウス SQL Server の URL、接続プロンプト、ユーザー名、パスワードを必ず指定してください。
For details on the hardware requirements the second SQL Server must meet, see SQL requirements for Process Mining.
-
インストーラーで必要なデータベースを自動作成するかどうかを指定します。
-
セキュリティで保護された TLS 通信を必要とする外部サーバー ソフトウェアに CA 証明書を提供します。証明書を提供しないと、インストールは失敗します。TLS 通信を有効化しなかった場合は、インストール後に証明書を設定できます。
注:インストーラーは Base64 でエンコードされた
PEM形式の DER 証明書のみを受け入れます。外部サーバーに異なる CA がある場合、すべての公開証明書を 1 つのファイルに連結できます。 -
構成パラメーターを定義すると、インストーラーが構成ファイルを自動生成します。構成パラメーターはターミナルから直接編集できます。
注:UiPathAutomationSuiteフォルダーで高度な構成設定のcluster_config.jsonを直接編集できます。構成ファイルの編集後、対話型インストーラーを再実行してインストールを完了するか、手動でインストールを完了する必要があります。Disaster Recovery - アクティブ/パッシブ デプロイの場合は、以下の手順を実行する必要があります。
- Install and configure the primary cluster. For details, see Advanced installation experience.
- Install and configure the secondary cluster. For details, see Disaster recovery - Installing the secondary cluster.
- このページの手順に従ってインストールを再開します。
-
プロセスが完了するまで待ちます。この時点で、最初のノードが設定されます。
-
マルチノード高可用性対応運用環境のインストールを続行するには、ターミナルで、対話型インストーラーから提供されるコマンドを、すべてのノードについて順番に実行し、参加させるノードごとにエージェントまたはサーバーを指定します。
You can also add additional nodes post-installation. For details, see Adding a new node to the cluster.
重要:Automation Suite 2023.4.0 の対話型インストールを実行する際、次のコマンドをセカンダリ ノードで実行するように求めるメッセージには、空のトークンが含まれています。インストールを続行するには、
kubectl create token defaultを実行して新しいトークンを生成し、セカンダリ ノードでのみコマンドを実行する必要があります。 -
すべてのマシンを参加させたら、最初のサーバーで次のコマンドを実行して、サービスをインストールします。
注:インストール プロセスの最後に、デプロイの概要を示すメッセージが表示されます。この概要ページから、Cluster Administration ポータル、ホスト ポータル、組織管理インターフェイス、Rancher、ArgoCD などにアクセスできます。
手順 2.2: (任意) 高度な構成
この手順は任意です。
高度な構成用のファイルを設定することができます。このファイルを使用すると、追加製品の有効化、既定の製品の無効化、SQL DB とそれぞれの接続文字列、および証明書の構成を行うことができます。マルチノードの高可用性対応の運用環境モードでは、高可用性が既定で有効化されますが、これは必要に応じて無効化できます。
For advanced configuration, you can follow the following instructions: Advanced installation experience.
If you exit the interactive installer and perform advanced configuration, you need to re-run the interactive installer to complete the process.
手順 3: インストールを完了する
インストールが正常に完了しました。インストール後の手順に進むことができます。
証明書を更新する
インストール プロセスによって、ユーザーに代わって自己署名証明書が生成されます。これらの証明書は、FIPS 140-2 に対応しています。Azure のデプロイ テンプレートには、自動生成された自己署名証明書を使用する代わりに、CA によって発行されたサーバー証明書をインストール時に指定するオプションもあります。
自己署名証明書は 90 日で有効期限が切れるので、インストールが完了したら速やかに、信頼された CA によって署名された証明書に置き換える必要があります。証明書を更新しないと、90 日後にインストールが停止します。
Automation Suite を FIPS 140-2 が有効化されたホストにインストールした後で証明書を更新する場合は、その証明書が FIPS 140-2 に対応していることを確認してください。
For instructions, see Managing certificates.
Automation Suite にアクセスする
To access the newly created cluster and suite, see Accessing Automation Suite.