- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- 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 サポート バンドルを使用する
- ログを確認する
オンラインでのシングルノード評価のインストール
概要
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 のベスト プラクティスに従ってください。をご覧ください。
インストール プロセスには、次のような一般的手順があります。
| 手順 | 説明 |
|---|---|
| Step 1: Download the installation script and run the interactive installer | 手順 1.1: 対話型インストーラーを対象マシンにコピーする 手順 1.2: 対話型インストーラーを実行し、インストール オプションを設定する 手順 1: インストール スクリプトをダウンロードし、対話型インストーラーを実行する |
| 手順 2: インストールを構成する | 手順 2.1: 対話型インストーラーを実行し、インストール オプションを設定するこのツールは、最も一般的なオプションの入力を収集し、構成ファイルを生成します。 手順 2.1: 既定の構成 手順 2.2: (任意) 高度なインストール オプションを設定する 対話型インストーラーで提供されるのは既定のインストール エクスペリエンスであるため、構成オプションの数は限られています。インストールされた製品をカスタマイズしたり、特定の製品で個別の 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 やその他のインストール オプションなどの外部リソースを構成するのに役立つ対話型エクスペリエンスを提供します。
手順 1.1: 対話型インストーラーを対象マシンにコピーする
-
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 1.2: Running the interactive installer to configure the installation options
スクリプトを実行して対話型インストーラーを開始します。この手順では、インストール プロセスで使用できる構成ファイルが生成されます。
chmod +x ~/installUiPathAS.sh
./installUiPathAS.sh
chmod +x ~/installUiPathAS.sh
./installUiPathAS.sh
手順 2: インストールを構成する
手順 2.1: 既定の構成
対話型インストーラーを実行し、インストール オプションを構成します。このツールは、最も一般的なインストール オプションの入力を収集し、構成ファイルを生成します。HAA はシングルノードの評価モードではサポートされません。
Automation Suite をインストールするには、次の手順に従います。
-
対話型インストーラーを起動します。
-
ライセンス契約に同意してインストールを続行します。
-
[Main Menu] でデプロイ モードを選択します。[Single-node deployment (recommended for demo/evaluation purposes)] を選択し、選択内容を確認します。
-
[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.
-
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 Orhcestrator 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.
-
-
製品選択を確認して、ハードウェアおよびソフトウェアの最小要件を判断します。
注:Some Automation Suite products require a dedicated agent node. Before continuing, make sure you meet the hardware requirements.
専用のエージェント ノードの追加方法の詳細については、以下をご覧ください。
-
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を直接編集できます。構成ファイルの編集後、対話型インストーラーを再実行してインストールを完了するか、手動でインストールを完了する必要があります。 -
この時点で、インストールを進めることができます。プロセスが完了すると、指定したマシン上に Automation Suite がインストールされます。
注:インストール プロセスの最後に、デプロイの概要を示すメッセージが表示されます。この概要ページから、Cluster Administration ポータル、ホスト ポータル、組織管理インターフェイス、Rancher、ArgoCD などにアクセスできます。
手順 2.2: (任意) 高度な構成
この手順は任意です。
cluster_config.json ファイルは UiPathAutomationSuite フォルダーにあります。このファイルを使用すると、追加製品の有効化、既定の製品の無効化、SQL DB とそれぞれの接続文字列、および証明書の構成を行うことができます。インターネット接続にプロキシを使用する場合は、プロキシ設定を有効化することもできます。
シングルノードの評価インストールでは、高可用性を有効化することはできません。
For advanced configuration, see Advanced installation experience.
対話型インストーラーを再実行してインストールを完了する必要があります。
手順 3: インストールを完了する
インストールが正常に完了しました。インストール後の手順に進むことができます。
証明書を更新する
インストール プロセスによって、ユーザーに代わって自己署名証明書が生成されます。ただし、Azure のデプロイ テンプレートには、自動生成された自己署名証明書を使用する代わりに、CA によって発行されたサーバー証明書をインストール時に指定するオプションもあります。
自己署名証明書は 90 日で有効期限が切れるので、インストールが完了したら速やかに、信頼された CA によって署名された証明書に置き換える必要があります。証明書を更新しないと、90 日後にインストールが停止します。
For instructions, see Managing certificates.
Automation Suite にアクセスする
To access the newly created cluster and suite, see Accessing Automation Suite.
AI Center のインストールを完了する
AI Center に外部 Orchestrator が必要な場合は、次のコマンドを実行してインストールを完了します。
./configureUiPathAS.sh aicenter configure --installation-token <identity token>
./configureUiPathAS.sh aicenter configure --installation-token <identity token>
PVC のサイズを変更する
To resize the PVC, see Resizing PVC.