- 基本情報
- ネットワーク要件
- シングルノードの要件とインストール
- マルチノードの要件とインストール
- インストール後
- GPU をプロビジョニングする
- 構成ファイルを使用する
- ノードのスケジュール設定
- 移行とアップグレード
- 基本的なトラブルシューティング ガイド
手順 1: 最初のマシンにインストール スクリプトをダウンロードする
1.1 インストール パッケージをダウンロードします。
This step needs to be run on a machine with internet access and access to the machines in the air-gapped environment where UiPath AI Center will be installed.
このマシンは、Linux でも Windows でも構いません。ここで説明する手順は、このマシンで実行するための手順です。このドキュメントでは、RHEL ベースの OS 用の例を示しています。Windows や他の OS バージョンでは、それらの環境に固有の同等の手順に置き換えてください。
Follow the steps below on the separate machine with internet access to get the required files to start the installation process:
-
インターネットにアクセスできるマシンに接続し、以下のコマンドを実行して対話型ウィザードのファイルを取得します。
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> -
以下のパッケージをダウンロードします。
-
installUiPathAS.sh- Mandatory. See installUiPath.as for download instructions. -
sf-installer.zip- Mandatory. See sf-installer.zip for download instructions. -
sf.tar.gz- Mandatory. See sf.tar.gz for download instructions. -
sf-infra.tar.gz- Optional. Only needd if you want to join additional nodes, including Task Mining and GPU. See sf-infra.tar.gz for download instructions. -
du-ondemand.tar.gz- Optional. Needed only for Document Understanding. See du-ondemand.tar.gz for download instructions.注:注この任意の手順を実行しないと、Document Understanding サービスの機能が制限されます。
-
cv-ondemand.tar.gz– Optional. Needed only for Computer Vision. See cv-ondemand.tar.gz for download instructions.注:この任意の手順を実行しないと、Computer Vision サービスにアクセスできません。
-
お使いの AI Center のバージョンとオペレーティング システムに適したパッケージをダウンロードしてください。
1.2 ダウンロードしたすべてのファイルを最初のマシンに揃えます。
次の手順に従ってください。
- インターネットにアクセスできるマシンに、すべてのファイルがダウンロードされていることを確認します。
- マシンにターゲット フォルダーを作成します。
- オンラインのマシンからターゲット マシンにファイルをコピーします。
Create the installation folder on the main machine of the cluster by running the following command:
sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 777 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp
On the separate machine with internet access, copy the files to the first node:
-
インターネットにアクセスできるマシンから、インストール先マシンのインストール フォルダーにファイルをコピーし、
/uipath/tmpフォルダーにオフライン バンドルをコピーします。scp ./installUiPathAS.sh ./sf-installer.zip ./sf-infra.tar.gz <username>@<node dns>:/uipath/tmp/ scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/ scp ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp/scp ./installUiPathAS.sh ./sf-installer.zip ./sf-infra.tar.gz <username>@<node dns>:/uipath/tmp/ scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/ scp ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp/ -
(任意) Document Understanding を使用する場合は、次のバンドルを
/uipath/tmpフォルダーにコピーします。scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/注:Not following this optional step prevents access to the Document Understanding services.
-
(任意) Computer Vision を使用する場合は、次のバンドルを
/uipath/tmpフォルダーにコピーします。scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/注:この任意の手順を実行しないと、Computer Vision サービスにアクセスできません。
手順 2: Orchestrator の証明書を仮想マシンにコピーする
In case of chain certificates, check the Chain certificates section on how to correctly provide certificates.
Orchestrator の証明書をローカル マシンにダウンロードして保存します。ブラウザーでこの操作を行うことも、IT 部門に依頼して証明書を提供してもらうこともできます。証明書は Base64 および .cer 形式である必要があります。以下のコマンドを使用して、証明書を仮想マシンにコピーします。
/opt/UiPathAutomationSuite に、scp 経由でコピーするファイルに対する適切な権限があることを確認してください。または、ファイルをホーム ディレクトリにコピーしてから /opt/UiPathAutomationSuite に移動します。
scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite
scp /path/to/orch.cer <username>@<node dns>:/opt/UiPathAutomationSuite
Identity Server が Orchestrator と異なる場合は、identityserver.cer についても手順を繰り返します。
チェーン証明書
ドメインが発行した証明書を使用するときは、以下の手順でルート証明書をエクスポートしてください。
-
証明書を開き、[証明のパス] タブに移動して、最初の証明書を選択します。[証明書の表示] をクリックします。
-
ルート証明書が表示されたら、[詳細] タブに移動して [ファイルにコピー] をクリックします。
-
必ず Base64
cerファイル形式を選択してください。 -
選択した名前で証明書を保存して、AI Center マシンに送信します。
生成されるファイルは、以下の例のようになります。
-----BEGIN CERTIFICATE-----
certificate
base64
encoded
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
certificate
base64
encoded
-----END CERTIFICATE-----
手順 3: インストールを構成する
基本構成
The following prerequisites are applicable for the main machine of the cluster.
-
現在の PATH に次の前提条件を追加します。
対話型インストーラーには
jqが必要ですが、UiPath のオフライン バンドルにあらかじめ付属しています。次のコマンドを実行して、これを PATH に追加します (ルートであることを確認してください)。mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /opt/UiPathAutomationSuite cd /opt/UiPathAutomationSuite unzip ./sf-installer.zip -d . chmod +x ./bin/jq export PATH=${PATH}:/opt/UiPathAutomationSuite/binmv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /opt/UiPathAutomationSuite cd /opt/UiPathAutomationSuite unzip ./sf-installer.zip -d . chmod +x ./bin/jq export PATH=${PATH}:/opt/UiPathAutomationSuite/bin -
インストーラー フォルダーに権限を付与します。
インストール スクリプトが配置され、実行される
/opt/UiPathAutomationSuiteフォルダーに適切な権限を付与する必要があります。インストーラーは、各段階の実行後にいくつかのファイル (output.json) も作成します。権限を付与するには、次のコマンドを実行します。
chmod -R 755 /opt/UiPathAutomationSuitechmod -R 755 /opt/UiPathAutomationSuite -
対話型のインストール ウィザードを実行し、インストール オプションを設定します。
対話型ウィザードは構成の手順を案内し、残りのインストール手順で使用される、カスタマイズ可能な構成ファイルを生成します。
-
次のコマンドを実行して、対話型ウィザードを開始するスクリプトを実行します。
chmod +x ./installUiPathAS.sh ./installUiPathAS.shchmod +x ./installUiPathAS.sh ./installUiPathAS.sh -
次のウィザードの手順を実行します。
3.1. 対話型ウィザードを使用して、基本構成ファイルを作成します。
Make sure to not start the install from the script and exit it when config file is generated, it will try to install full Automation suite otherwise. This script is primarily used for Automation Suite and the displayed information (products, requirements) is relative to Automation Suite. The config file will be adapted to our needs in the next steps of the procedure.
インストール ウィザードの開始時には、メイン メニューが表示されます。このメニューから、デプロイ モードとして、シングルノードまたはマルチノードを選択する必要があります。選択すると、各モードの詳細を含むプロンプトが表示されます。その後、現在の選択で続行するか、メイン メニューに戻るかのオプションを選択できます。
次のデプロイの構成手順を実行します。
-
Accept the license agreement.
-
デプロイ モードの選択: [Multi-node deployment] オプションを選択します。
-
続行するよう選択します。
-
エアギャップ インストールを選択します。
-
[Complete] インストールを選択します。
-
DNS ホスト名を入力します。
-
SQL 接続に Kerberos 認証を使用するかどうかを指定します。
-
SQL Server の URL を入力します。プロンプトに従い、接続ポート、ユーザー名、パスワードを入力します。
-
インストーラーで必要なデータベースを自動作成するかどうかを指定します。
次の画像のように、フォルダーとともにクラスター構成ファイルが生成されます。
構成ファイルとフォルダーの生成が完了次第、ウィザードを終了し、以下に示す残りの手順に進んでインストールを完了できます。 製品のリストは次の手順で更新するため、無視してかまいません。
cluster_config.json ファイルの最初のバージョンが生成されます。このファイルを、AI Center のインストールのために更新します。
3.2. AI Center 固有の構成を追加します。
ファイルをエディター (例: vi) で開きます。
vi /opt/UiPathAutomationSuite/cluster_config.json
vi /opt/UiPathAutomationSuite/cluster_config.json
次のブロックを置き換えます。
"aicenter": {
"enabled": "false"
},
"aicenter": {
"enabled": "false"
},
Document Understanding is enabled by default if AI Center is enabled.
これを次の情報に置き換えます (<> 間の情報を自分の値に置き換えます)。
"aicenter": {
"enabled": "true",
"orchestrator_url":"<https://orchestrator-url.com>",
"identity_server_url": "<https://orchestrator-url.com/identity>",
"orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
"identity_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
"identity_access_token": "<placeholder will be replaced later>"
},
"aicenter": {
"enabled": "true",
"orchestrator_url":"<https://orchestrator-url.com>",
"identity_server_url": "<https://orchestrator-url.com/identity>",
"orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
"identity_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
"identity_access_token": "<placeholder will be replaced later>"
},
3.3. (任意) 高度な構成
cluster_config.json ファイルは UiPathAutomationSuite フォルダーにあります。このファイルを使用すると、SQL DB とそれぞれの接続文字列、および証明書の構成を行うことができます。インターネット接続にプロキシを使用する場合は、プロキシ設定を有効化することもできます。
For advanced configuration, see Using the configuration file.
手順 4: クラスターの他のすべてのマシンにインストール ファイルをコピーする
From the first machine in the cluster, where the configuration was performed, copy the entire install folder to all other machines:
-
次のコマンドを実行して、他のすべてのノードに
~/UiPathAutomationSuiteフォルダーをコピーします。scp -r ~/UiPathAutomationSuite <username>@<node dns>:/optscp -r ~/UiPathAutomationSuite <username>@<node dns>:/opt注:Since we are in an air-gapped environment, you might need to use the private IP of the target node.
-
ログインに証明書を使用する場合、
-i <cert.pem>を追加します。.pemの内容をローカル ファイルにコピーする場合、新しいファイルに適切な権限がある必要があります。権限はchmod 400 <cert.pem>によって付与できます。
上記の手順に従えば、インストール バンドルのダウンロードしたすべてのパッケージとともに、すべてのマシン上で確実に同じ構成を複製できます。
手順 5: インストールを実行する
-
すべてのノードでインフラストラクチャ インストーラーを実行します。
-
プライマリ サーバーで次のコマンドを実行してプライマリ マシンの設定を行います。
cd /opt/UiPathAutomationSuite ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicentercd /opt/UiPathAutomationSuite ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter -
残りのサーバー ノードで次のコマンドを実行し、残りのサーバーをクラスターに参加させます。
cd /opt/UiPathAutomationSuite sudo chmod -R 755 /opt/UiPathAutomationSuite sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicentercd /opt/UiPathAutomationSuite sudo chmod -R 755 /opt/UiPathAutomationSuite sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j server --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter -
残りのエージェント ノードで次のコマンドを実行し、残りのエージェントをクラスターに参加させます。
cd /opt/UiPathAutomationSuite sudo chmod -R 755 /opt/UiPathAutomationSuite sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicentercd /opt/UiPathAutomationSuite sudo chmod -R 755 /opt/UiPathAutomationSuite sudo ./install-uipath.sh -i ./cluster_config.json -o ./output.json -k -j agent --offline-bundle ./sf-infra.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement --install-standalone-aicenter
-
-
プライマリ ノードでファブリック インストーラーを実行します。
cd /opt/UiPathAutomationSuite export TMPDIR="/uipath/lib/containers/tmp" mkdir -p "/uipath/lib/containers/tmp" ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-standalone-aicentercd /opt/UiPathAutomationSuite export TMPDIR="/uipath/lib/containers/tmp" mkdir -p "/uipath/lib/containers/tmp" ./install-uipath.sh -i ./cluster_config.json -o ./output.json -f --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --accept-license-agreement --install-standalone-aicenter -
Run the software installer on primary node First you need to connect to identity server and retrieve an installation token. Then copy this token and paste it in placeholder we had in step 3.2. (in the cluster_config.json file). Once the token is there, you can run the AI Center install.
./install-uipath.sh -i cluster_config.json -o output.json --install-type offline --accept-license-agreement --install-standalone-aicenter -s./install-uipath.sh -i cluster_config.json -o output.json --install-type offline --accept-license-agreement --install-standalone-aicenter -s -
任意の Document Understanding バンドル コマンドを読み込みます。任意のバンドルを読み込むには、次のコマンドを実行します。読み込む必要のあるバンドル名を使用してください。
./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp" -
任意の Computer Vision バンドル コマンドを読み込みます。任意の Computer Vision バンドルを読み込むには、次のコマンドを実行します。
./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"
- 手順 1: 最初のマシンにインストール スクリプトをダウンロードする
- 1.1 インストール パッケージをダウンロードします。
- 1.2 ダウンロードしたすべてのファイルを最初のマシンに揃えます。
- 手順 2: Orchestrator の証明書を仮想マシンにコピーする
- チェーン証明書
- 手順 3: インストールを構成する
- 基本構成
- 3.1. 対話型ウィザードを使用して、基本構成ファイルを作成します。
- 3.2. AI Center 固有の構成を追加します。
- 3.3. (任意) 高度な構成
- 手順 4: クラスターの他のすべてのマシンにインストール ファイルをコピーする
- 手順 5: インストールを実行する