オフラインでのシングルノードの評価のインストール

概要

重要:

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 のベスト プラクティスに従ってください。をご覧ください。

インストール プロセスには、次のような一般的手順があります。

手順	説明
手順 1: インストール パッケージをダウンロードする	この手順は、インターネットと、Automation Suite をデプロイする予定のオフライン マシンの両方にアクセスできる Linux または Windows マシンから実行します。インストール パッケージのダウンロードが完了するまでに、後続の手順のいくつかを進めておくことができます。 手順 1.1: インストール パッケージをダウンロードする 手順 1.2: ダウンロードしたすべてのファイルをマシンに揃える
手順 2: インストールを構成する	対話型インストーラーは、最も一般的なインストール オプションの入力を収集し、インストール中に使用できる構成を生成します。 手順 2.1: インストールを構成する: 既定の構成 対話型インストーラーで提供されるのは既定のインストール エクスペリエンスであるため、構成オプションの数は限られています。インストールされた製品をカスタマイズしたり、特定の製品で個別の SQL Server を設定したりするには、構成ファイルを編集します。 手順 2.2: (任意) インストールを構成する: 高度な構成 (任意)
Step 3: Run the installation	インストールを実行します。インストールが完了したら、クラスターの使用を開始できます。 手順 3: インストールを実行する
Step 4: Complete the installation	インストールが正常に完了しました。インストール後の手順に進むことができます。 新たに作成されたクラスターとスイートにアクセスしたり、証明書を更新したり、PVC のサイズを変更したりできるようになりました。 手順 4: インストールを完了する

重要:

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

手順 1: インストール パッケージをダウンロードして、ファイルをマシンに揃える

手順 1.1: インストール パッケージをダウンロードする

この手順は、インターネットと、Automation Suite をインストールする予定のオフライン環境内のマシンの両方にアクセスできる Linux または Windows マシンで実行する必要があります。

このページで使用するコマンドは、RHEL ベースの OS 用です。Windows や他の OS では、それらの環境に固有の同等コマンドに置き換えてください。

重要:

You must install the required RPM packages before launching the Automation Suite installer. For details, see RPM package requirements.

インターネットにアクセスできる別のマシンで実行する手順

このセクションでは、インストール プロセスを開始するために必要なファイルの取得方法について説明します。

1. インターネットにアクセスできるマシンに接続し、以下のコマンドを実行して対話型インストーラーのファイルを取得します。

   ssh <user>@<dns_of_vm>
   

2. ssh キーを使用した場合、次のコマンドを実行します。

   ssh -i <path/to/Key.pem> <user>@<dns_of_vm>
   

3. 以下のパッケージをダウンロードします。

   • installUiPathAS.sh – Mandatory. See installUiPathAS.sh 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 needed 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 du-ondemand.tar.gz for download instructions.

     注:

     この任意の手順を実行しないと、Computer Vision サービスにアクセスできません。

手順 1.2: ダウンロードしたすべてのファイルをマシンに揃える

次の手順に従ってください。

• インターネットにアクセスできるマシンに、すべてのファイルがダウンロードされていることを確認します。
• マシンにターゲット フォルダーを作成します。
• オンラインのマシンからターゲット マシンにファイルをコピーします。

クラスターのメイン マシンで実行する手順

次のコマンドを実行して、インストール フォルダーを作成します。

sudo su -
mkdir -p /opt/UiPathAutomationSuite/
chmod -R 755 /opt/UiPathAutomationSuite
mkdir -p /uipath/tmp
chmod -R 777 /uipath/tmp

注:

Running mkdir -p /opt/UiPathAutomationSuite/ is not required if you use the configureUiPathDisks.sh script.

インターネットにアクセスできる別のマシンで実行する手順

ノードの 1 つにファイルをコピーします。

1. インターネットにアクセスできるマシンから、インストール先マシンのインストール フォルダーにファイルをコピーし、/uipath/tmp フォルダーにオフライン バンドルをコピーします。

   scp ~/installUiPathAS.sh ~/sf-installer.zip <username>@<node dns>:/uipath/tmp
   scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/
   

   Task Mining や GPU などの追加ノードを参加させる場合は、代わりに次のコマンドを実行します。

   scp ~/installUiPathAS.sh ~/sf-installer.zip ~/sf-infra.tar.gz <username>@<node dns>:/uipath/tmp
   scp ~/sf.tar.gz <username>@<node dns>:/uipath/tmp/
   

2. (任意) Document Understanding を使用する場合は、次のバンドルを /uipath/tmp フォルダーにコピーします。

   scp ~/du-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
   

   警告:

   Not following this optional step prevents access to the Document Understanding services.

3. (任意) Computer Vision を使用する場合は、次のバンドルを /uipath/tmp フォルダーにコピーします。

   scp ~/cv-ondemand.tar.gz <username>@<node dns>:/uipath/tmp/
   

   警告:

   この任意の手順を実行しないと、Computer Vision サービスにアクセスできません。

手順 2: インストールを構成する

手順 2.1: 既定の構成

クラスターのメイン マシンで実行する手順

1. 現在の PATH に前提条件のフォルダーを追加します。

   対話型インストーラーには jq が必要ですが、Automation Suite のオフライン バンドルにあらかじめ付属しています。次のコマンドを実行してこれを 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/bin
   

   Task Mining や GPU などの追加ノードを参加させる場合は、代わりに次のコマンドを実行します。

   mv /uipath/tmp/installUiPathAS.sh /uipath/tmp/sf-installer.zip /uipath/tmp/sf-infra.tar.gz  /opt/UiPathAutomationSuite
   cd /opt/UiPathAutomationSuite
   unzip ./sf-installer.zip -d .
   chmod +x ./bin/jq
   export PATH=${PATH}:/opt/UiPathAutomationSuite/bin
   

2. インストーラー フォルダーに権限を付与します。

   インストール スクリプトが配置され、実行される /opt/UiPathAutomationSuite フォルダーに適切な権限を付与する必要があります。インストーラーは、各段階の実行後にいくつかのファイル (output.json) も作成します。必要な権限を付与するには、次のコマンドを実行します。

   chmod -R 755 /opt/UiPathAutomationSuite
   

3. 対話型インストーラーを実行し、インストール オプションを構成します。

   重要:

   対話型インストーラーは sf-installer.zip をダウンロードしようとするため、オフライン環境では失敗します。ダウンロードのステップをスキップしてインストールの問題を回避するには、次のコマンドを実行します。

   export BUNDLE_FILE="/opt/UiPathAutomationSuite/sf-installer.zip"
   

   対話型インストーラーを起動するには、次のコマンドを実行します。

   chmod +x ./installUiPathAS.sh
   ./installUiPathAS.sh
   

   対話型インストーラーは構成の手順を案内し、構成を生成します。構成は残りのインストール手順でカスタマイズできます。

オフラインのシングルノード モードで対話型ウィザードを実行する

対話型インストーラーを実行し、インストール オプションを構成します。このツールは、最も一般的なインストール オプションの入力を収集し、構成ファイルを生成します。HAA はシングルノードの評価モードではサポートされません。

Automation Suite をインストールするには、次の手順に従います。

1. 対話型インストーラーを起動します。

2. ライセンス契約に同意してインストールを続行します。

3. In Main Menu select your deployment mode. Choose Single-node deployment (recommended for demo/evaluation purposes) and confirm your selection.

   

4. In Deployment configuration select your environment type. Choose Air-gapped.

5. 製品選択を選びます。以下のオプションがあります。

   • Complete (All products)
   • Select products
   注:

   For details on the product selection options, see Hardware and software requirements.

6. 前の手順で [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.

   Some Automation Suite products, such as Task Mining and Document Understanding, require a dedicated agent node. Before continuing, make sure you meet the hardware requirements.

7. AI Center をインストールするには、以下の追加の手順を実行する必要があります。

   1. AI Center に外部 Orchestrator が必要かどうかを指定します。

      • AI Center に外部 Orchestrator が必要ない場合は、手順 8 に進みます。
      • AI Center に外部 Orchestrator が必要な場合は、手順 7.2 に進みます。

   2. Copy the Orchestrator certificate to the virtual machine. For more information on this, check the Copy the Orchestrator certificate page.

   3. AI Center の Orchestrator URL を指定します。例: https://orchestrator.example.com。

   4. AI Center の Identity URL を指定します。例: https://orchestrator.example.com/identity。

   5. Orchestrator の証明書ファイルへのパスを指定します。例: /opt/UiPathAutomationSuite/UiPath_Installer/orch.cer。

   6. Identity の証明書ファイルへのパスを指定します。例: /opt/UiPathAutomationSuite/UiPath_Installer/identity.cer。

      重要:

      In offline installations, you do not need to specify the metering API key. To complete the AI Center installation, follow the step from the Completing the installation section.

8. 製品選択を確認して、ハードウェアおよびソフトウェアの最小要件を判断します。

9. Automation Suite の FQDN を入力します。

10. 選択した製品に独自のオブジェクト ストアを使用するかどうかを指定します。[No] を選択した場合は、既定のオブジェクト ストアが選択されます。[Yes] を選択した場合は、以下のいずれかのオプションを選択します。

    • Azure Storage Account – Azure Storage アカウントに基づくマネージド ID を使用するかどうかを指定します。選択内容に対応する以下の詳細情報を入力し、選択したすべての製品に対してコンテナーを自動的にプロビジョニングするかどうかを指定します。

      • If Yes, provide the Azure storage account name and endpoint suffix, and your client 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 を許可する必要があります。

11. SQL 接続に Kerberos 認証を使用するかどうかを指定します。

12. SQL Server の URL を入力します。プロンプトに従い、接続ポート、ユーザー名、パスワードを入力します。

    重要:

    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.

13. インストーラーで必要なデータベースを自動作成するかどうかを指定します。

14. セキュリティで保護された TLS 通信を必要とする外部ソフトウェアに CA 証明書を提供します。証明書を提供しないと、インストールは失敗します。TLS 通信を有効化しなかった場合は、インストール後に証明書を設定できます。

    重要:

    インストーラーは Base64 でエンコードされた PEM 形式の DER 証明書のみを受け入れます。外部サーバーに異なる CA がある場合、すべての公開証明書を 1 つのファイルに連結できます。

15. 構成パラメーターを定義すると、インストーラーが構成ファイルを自動生成します。構成パラメーターはターミナルから直接編集できます。

    重要:

    構成ファイルとフォルダーの生成が完了したら、インストーラーを終了し、以下に示す残りの手順に進んでインストールを完了できます。

インストール プロセスの最後に、デプロイの概要を示すメッセージが表示されます。この概要ページから、Cluster Administration ポータル、ホスト ポータル、組織管理インターフェイス、Rancher、ArgoCD などにアクセスできます。

手順 2.2: (任意) 高度な構成

この手順は任意です。

cluster_config.json ファイルは UiPathAutomationSuite フォルダーにあります。このファイルを使用すると、追加製品の有効化、既定の製品の無効化、SQL DB とそれぞれの接続文字列、および証明書の構成を行うことができます。インターネット接続にプロキシを使用する場合は、プロキシ設定を有効化することもできます。

シングルノードの評価インストールでは、高可用性を有効化することはできません。

For advanced configuration, see Advanced installation experience.

注:

インストールが完了したら、ウィザードを再実行できます。

手順 3: インストールを実行する

ダウンロードしたファイルを、構成を実行したメインのオフライン マシンのインストール フォルダー (インストール ウィザードによって作成済み) に確実にコピーしてください。

ライセンス契約に同意する

Before running the installation, make sure to read the License Agreement.

ライセンス契約に同意するには、以下のいずれかの方法を選択します。

• Option 1 (Environment Variable): Set the LICENSE_AGREEMENT environment variable to accept by executing the following command: export LICENSE_AGREEMENT=accept
• オプション 2 (インライン パラメーター): または install-uipath.sh の各実行に --accept-license-agreement を付加します。

インストールを実行する

インストール コマンドによりオフライン バンドルを実行します (推定所要時間: 2 時間 30 分 - 3 時間 30 分)。

./install-uipath.sh -i ./cluster_config.json -o ./output.json -a --offline-bundle /uipath/tmp/sf.tar.gz --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement

./install-uipath.sh -h --accept-license-agreement を実行するとヘルプが表示されます。

任意のバンドルを読み込む

任意の Document Understanding バンドルを読み込むには、次のコマンドを実行します。

./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

任意の Computer Vision バンドルを読み込むには、次のコマンドを実行します。

./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/cv-ondemand.tar.gz" --offline-tmp-folder "/uipath/tmp"

This document focuses on -a command argument as this caters to need of installing all the required components.

Task Mining をインストールする

If you install Task Mining in single-node evaluation mode, you need to run an additional set of steps. Follow the Task Mining installation guide to complete the steps for Task Mining.

手順 4: インストールを完了する

注:

インストールが正常に完了しました。インストール後の手順に進むことができます。

証明書を更新する

重要:

インストール プロセスによって、ユーザーに代わって自己署名証明書が生成されます。ただし、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>

For more information on how to configure Orchestrator for AI Center, check the Configuring Orchestrator page from the AI Center guide.

PVC のサイズを変更する

To resize the PVC, see Resizing PVC.