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

概要

重要:

インストールを続行する前に、ハードウェアとソフトウェアの前提条件を満たす必要があります。「ハードウェアおよびソフトウェアの要件」をご覧ください。

専用のスクリプトを使用して、インストールの前提条件とインフラストラクチャの準備状況を検証できます。「前提条件を検証する」をご覧ください。

インストールを円滑に進めるには、UiPath のベスト プラクティスに従ってください。をご覧ください。

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

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

重要: Automation Suite インストーラーを起動する前に、必要な RPM パッケージをインストールする必要があります。 詳しくは、「RPM パッケージの要件」をご覧ください。

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

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

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

   ssh <user>@<dns_of_vm>

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

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

3. 以下のパッケージをダウンロードします。
   • installUiPathAS.sh – 必須です。ダウンロード手順については「installUiPathAS.sh」をご覧ください。
   • sf-installer.zip – 必須です。ダウンロード手順については「sf-installer.zip」をご覧ください。
   • sf.tar.gz – 必須です。ダウンロード手順については「sf.tar.gz」をご覧ください。
   • sf-infra.tar.gz - 任意です。Task Mining と GPU を含む追加のノードを参加させる場合にのみ必要です。ダウンロード手順については「sf-infra.tar.gz」をご覧ください。
   • du-ondemand.tar.gz – 任意Document Understanding にのみ必要です。ダウンロード手順については「du-ondemand.tar.gz」をご覧ください。
     注: この任意の手順を実行しないと、Document Understanding サービスの機能が制限されます。
   • cv-ondemand.tar.gz – 任意Computer Vision にのみ必要です。ダウンロード手順については「du-ondemand.tar.gz」をご覧ください。
     注:

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

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

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

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

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

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

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

注: configureUiPathDisks.sh スクリプトを使用する場合は、mkdir -p /opt/UiPathAutomationSuite/ を実行する必要はありません。

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

ノードの 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/

   警告: この任意の手順を実行しないと、Document Understanding サービスにアクセスできません。
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. [Main Menu] でデプロイ モードを選択します。[Single-node deployment (recommended for demo/evaluation purposes)] を選択し、選択内容を確認します。
   
4. [Deployment configuration] で、環境の種類を選択します。[Air-gapped] を選択します。
5. 製品選択を選びます。以下のオプションがあります。
   • Complete (All products)
   • Select products

   注:

   製品選択オプションについて詳しくは、「ハードウェアおよびソフトウェアの要件」をご覧ください。

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

   重要:

   Automation Suite の一部の製品には、その他にも相互の依存関係があります。インストールする製品を選択する際は、製品間の依存関係を考慮してください。依存関係なしに製品をインストールしようとすると、エラーが発生します。

   Task Mining や Document Understanding などの一部の Automation Suite 製品では、専用のエージェント ノードが必要です。続行する前に、ハードウェア要件を満たしていることを確認してください。

7. AI Center をインストールするには、以下の追加の手順を実行する必要があります。
   1. AI Center に外部 Orchestrator が必要かどうかを指定します。
      • AI Center に外部 Orchestrator が必要ない場合は、手順 8 に進みます。
      • AI Center に外部 Orchestrator が必要な場合は、手順 7.2 に進みます。
   2. Orchestrator の証明書を仮想マシンにコピーします。詳細については、「Orchestrator の証明書をコピーする」をご覧ください。
   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。
      重要: オフライン インストールの場合、メータリング API キーを指定する必要はありません。AI Center のインストールを完了するには、「AI Center のインストールを完了する」の手順に従います。
8. 製品選択を確認して、ハードウェアおよびソフトウェアの最小要件を判断します。
9. Automation Suite の FQDN を入力します。
10. 選択した製品に独自のオブジェクト ストアを使用するかどうかを指定します。[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 を許可する必要があります。
11. SQL 接続に Kerberos 認証を使用するかどうかを指定します。
12. SQL Server の URL を入力します。プロンプトに従い、接続ポート、ユーザー名、パスワードを入力します。
    重要: Process Mining をインストールする場合は、2 つ目の SQL Server を推奨します。ウェアハウス SQL Server の URL、接続プロンプト、ユーザー名、パスワードを必ず指定してください。

    2 つ目の SQL Server が満たす必要があるハードウェア要件の詳細については、「Process Mining のための SQL の要件」をご覧ください。
13. インストーラーで必要なデータベースを自動作成するかどうかを指定します。
14. セキュリティで保護された TLS 通信を必要とする外部ソフトウェアに CA 証明書を提供します。証明書を提供しないと、インストールは失敗します。TLS 通信を有効化しなかった場合は、インストール後に証明書を設定できます。
    重要: インストーラーは Base64 でエンコードされた `PEM` 形式の DER 証明書のみを受け入れます。外部サーバーに異なる CA がある場合、すべての公開証明書を 1 つのファイルに連結できます。
15. 構成パラメーターを定義すると、インストーラーが構成ファイルを自動生成します。構成パラメーターはターミナルから直接編集できます。
    重要: 構成ファイルとフォルダーの生成が完了したら、インストーラーを終了し、以下に示す残りの手順に進んでインストールを完了できます。

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

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

この手順は任意です。

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

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

高度な設定の場合は「高度なインストール」をご覧ください。

注:

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

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

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

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

インストールを実行する前に、ライセンス契約をお読みください。

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

• オプション 1 (環境変数): 次のコマンドを実行して、環境変数 LICENSE_AGREEMENT を accept に設定します。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"

このドキュメントでは、コマンド引数の -a について重点的に説明します。これは、必要なコンポーネントをすべてインストールするために必要になります。

Task Mining をインストールする

Task Mining をシングルノードの評価モードでインストールする場合、必要な実行手順が増えます。 Task Mining のインストール ガイドに従って Task Mining の手順を完了します。

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

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

証明書を更新する

注意:

インストール プロセスによって、ユーザーに代わって自己署名証明書が生成されます。ただし、Azure のデプロイ テンプレートには、自動生成された自己署名証明書を使用する代わりに、CA によって発行されたサーバー証明書をインストール時に指定するオプションもあります。

自己署名証明書は 90 日で有効期限が切れるので、インストールが完了したら速やかに、信頼された CA によって署名された証明書に置き換える必要があります。証明書を更新しないと、90 日後にインストールが停止します。

手順については、「証明書を管理する」をご覧ください。

Automation Suite にアクセスする

新たに作成されたクラスターとスイートにアクセスするには、「Automation Suite にアクセスする」をご覧ください。

AI Center のインストールを完了する

AI Center に外部 Orchestrator が必要な場合は、次のコマンドを実行してインストールを完了します。

./configureUiPathAS.sh aicenter configure --installation-token <identity token>

AI Center 用に Orchestrator を構成する方法について詳しくは、AI Center ガイドの「Orchestrator を構成する」をご覧ください。

PVC のサイズを変更する

PVC のサイズを変更するには、「PVC のサイズを変更する」をご覧ください。