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

このページでは、シングルノードの評価設定でオフラインの Automation Suite インストールを実行する方法について説明します。

概要

重要:

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

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

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

UiPath Automation Suite をインターネットに接続しないエアギャップ環境にデプロイする場合は、このドキュメントのオフライン インストール手順を使用します。マシンがインターネットにアクセスできる環境にデプロイする場合は、そのようなケース向けに最適化されたオンライン インストール手順を使用することを推奨します。

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

手順	説明
手順 1: インストール パッケージをダウンロードする	この手順は、インターネットと、Automation Suite がデプロイされるエアギャップ マシンの両方にアクセスできるマシンから実行する必要があります。ダウンロードが完了するまでに、後続の手順のいくつかを進めておくことができます。 この手順は Linux または Windows マシンから実行できます。 手順 1.1: インストール パッケージをダウンロードする 手順 1.2: ダウンロードしたすべてのファイルをマシンに揃える
手順 2: インストールを構成する	対話型インストール ウィザードは、最も一般的なインストール オプションの入力を収集し、インストール中に使用される構成ファイルを生成します。 手順 2.1: インストールを構成する: 基本構成 既定のインストール構成には、コアの自動化で使用される製品、およびすべての製品で使用される共有 SQL Server が含まれます。インストールされた製品をカスタマイズしたり、特定の製品で個別の 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 インストーラーは複数のパッケージのラッパーであり、Red Hat Package Manager (RPM) を使用して依存関係もいくつかインストールします。SQL やその他のインストール オプションなどの外部リソースを構成するのに役立つ対話型エクスペリエンスを提供します。

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

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

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 が /opt/UiPathAutomationSuite/ に存在しない場合、インストーラーはダウンロードを試みますが、オフライン インストールであるため失敗します。

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

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

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

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

対話型のインストール ウィザードを実行し、インストール オプションを設定します。ツールによって、最も一般的なインストール オプションの入力が収集され、インストール時に使用される構成ファイルが生成されます。

既定の設定を使用してインストールを実行すると、既定の手順を実行することになります。UiPath のコア プラットフォームである Orchestrator、Insights、Test Manager、Action Center、Automation Ops、および Automation Hub がインストールされます。

対話型ウィザードを使用して Automation Suite をインストールするには、次の手順を実行します。

1. [Install the UiPath Automation Suite] を選択します。
   
2. デプロイ モードの選択: [single-node] オプションを選択します。
3. [続行] を選択します。
4. エアギャップ インストールを選択します。
5. DNS ホスト名を入力します。
6. SQL 接続に Kerberos 認証を使用するかどうかを指定します。
7. SQL Server の URL を入力します。プロンプトに従い、接続ポート、ユーザー名、パスワードを入力します。
8. インストーラーで必要な DB を自動作成するかどうかを指定します (詳細については、次の手順をご覧ください)。
   
   

   

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

   

   
   

   この手順では、UiPathAutomationSuite フォルダーで高度な構成設定の cluster_config.json を直接編集できます。構成ファイルを編集したら、ウィザードを再実行してインストールを完了するか、手動で完了することができます。

   詳細については、「Advanced configuration step」のセクションをご覧ください。編集が終了したら、ウィザードを再実行してインストールを続行できます。

   Task Mining をインストールしている場合は、cluster_config.json で AI Center と Task Mining の両方を有効化してください。
10. この時点で、インストールを進めることができます。
    
    

    

    
    
11. プロセスが完了し、指定したマシン上にスイートがインストールされます。

手順 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 分)。

cd /opt/UiPathAutomationSuite
./install-uipath.sh -i ./cluster_config.json -o ./output.json -a --offline-bundle /opt/UiPathAutomationSuite/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 にアクセスする」をご覧ください。

PVC のサイズを変更する

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

AI Center をインストールした場合、ダウンタイムが発生しないように、インストール後ただちに PVC のサイズを 200 に変更することをお勧めします。詳細については、AI Center 向けの「PVC のサイズを変更する」ページをご覧ください。

Rancher/pause:3.5 を追加する

AI CenterTM をインストールした場合は、Rancher イメージをインポートおよびエクスポートする必要があります。詳細については、「オフライン レジストリに rancher/pause:3.5 を追加する」をご覧ください。