手順 13: cluster_config.json を生成する

最初のマシンで cluster_config.json を生成する

cluster_config.json ファイルは、Automation Suite を介してデプロイされる UiPath® 製品に適用されるパラメーターや設定を定義します。手動で cluster_config.json を作成するか、対話型インストーラーを使用します。このインストーラーは、ユーザーにいくつかの必須の質問をしてユーザー向けのファイルを生成します。生成されたファイルはいつでも編集して構成を更新できます。

対話型インストーラーを実行して cluster_config.json を生成する

cluster_config.json ファイルを生成するには、インストーラー フォルダーに移動し、次のコマンドを実行します。

cd /opt/UiPathAutomationSuite/<version>/installer

./installUiPathAS.sh

前述のコマンドを実行すると対話型フローが開始され、Automation Suite の構成に必要な一連の質問が表示されます。

構成ファイルを生成するには、次の手順を実行します。

1. ライセンス契約に同意して Automation Suite の構成を開始します。

2. [Main Menu] でデプロイ モードを選択します。以下のオプションがあります。

   • シングルノード デプロイ - デモと評価の目的に推奨されます。
   • Multi-node deployment - 運用環境での使用におすすめです。

   

3. [Deployment configuration] で、環境の種類を選択します。以下のオプションがあります。

   • オンライン - インターネットアクセスが必要です。
   • エアギャップ - オフラインとも呼ばれます。インターネットアクセスは必要ありません。

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

   • Complete (All products)
   • Select products

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

5. 前の手順で [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 の一部の製品には、その他にも相互の依存関係があります。インストールする製品を選択するときは、以下の点を考慮してください。依存関係のない製品をインストールしようとすると、エラーが発生します。
   さらには、一部の Automation Suite 製品では、専用のエージェント ノードが必要です。続行する前に、ハードウェア要件を満たしていることを確認してください。
   アクティブ/パッシブまたはアクティブ/アクティブ設定を選択する場合は、有効化する製品がサポートされていることを確認してください。詳細については、「Disaster Recovery - アクティブ/パッシブおよびアクティブ/アクティブ」をご覧ください。

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

   1. AI Center に外部 Orchestrator が必要かどうかを指定します。
      • AI Center に外部 Orchestrator が必要ない場合は、手順 7 に進みます。
      • AI Center に外部 Orchestrator が必要な場合は、手順 6.b に進みます。
   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。
   7. オンライン インストールの場合、メータリング API キーを指定します。
      注:

      metering_api_key は、AI Center のクラウド アカウントで確認できる Document Understanding API キーです。

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

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

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

   • Azure Storage アカウント - Azure Storage アカウントでマネージド ID ベースを使用するかどうかを指定し、選択内容に対応する以下の詳細情報を入力し、選択したすべての製品に対してコンテナーを自動的にプロビジョニングするかどうかを指定します。
     • [Yes] の場合は、Azure Storage アカウントの名前とエンドポイント サフィックス、およびクライアント ID を入力します。
     • [No] の場合は、Azure Storage アカウントの名前とエンドポイント サフィックス、および Azure アカウント キーを入力します。
   • AWS S3 - バケット名のプレフィックスとサフィックス、バケットをホストする AWS リージョン、S3 アカウントのアクセス キーとシークレット キーを指定し、選択したすべての製品に対してバケットを自動的にプロビジョニングするかどうかを指定します。
   • その他の S3 互換ストレージ - バケット名のプレフィックスとサフィックス、S3 サーバーの FQDN、S3 ポート、S3 アカウントのアクセス キーとシークレット キーを指定し、選択したすべての製品に対してバケットを自動的にプロビジョニングするかどうかを指定します。
   注:

   多くの S3 ObjectStore では、Automation Suite クラスターからのトラフィックすべてに CORS を設定する必要があります。CORS ポリシーを ObjectStore レベルで設定して、クラスターの FQDN を許可する必要があります。

10. OCI に対応する独自の外部 Docker レジストリを使用するかどうかを指定します。

    • [No] を選択した場合は、既定の内部 Docker レジストリが選択されます。
    • [Yes] を選択した場合は、使用するレジストリの詳細 (ポート、ユーザー名、パスワード、プル シークレットを含むレジストリ URL) を指定する必要があります。

11. 独自の外部 High Availability Add-on (HAA) を使用するかどうかを指定します。

    • [いいえ] を選択した場合は、既定のクラスター内の HAA が選択されます。
    • [はい] (既定の設定) を選択すると、外部マシンにインストールされた HAA を選択することになります。外部 HAA の詳細 (FQDN、パスワード、ポート、TLS 構成) を指定する必要があります。

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

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

    注:

    Process Mining には 2 つ目の SQL Server が必要です。Process Mining をインストールする場合は、ウェアハウス SQL Server の URL、データベース名、接続プロンプト、ユーザー名、パスワードを必ず指定してください。
    2 つ目の SQL Server が満たす必要があるハードウェア要件の詳細については、「 Process Mining の SQL 要件」をご覧ください。SQL データベースを Process Mining 用に構成する方法の詳細については、「 Process Mining 固有の構成」をご覧ください。

    重要:

    Automation Suite 2023.10.9 以降の Process Mining では、Airflow データベースに PostgreSQL を使用することをお勧めします。PostgreSQL データベースを使用する場合は、AutomationSuite_Airflow データベースのairflow.metadata_db_connection_str接続文字列を cluster_config.jsonに手動で追加する必要があります。
    詳しくは、「Process Mining の SQL 要件」および「Process Mining 固有の構成」をご覧ください。

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

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

    注:

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

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

    注:

    UiPathAutomationSuite フォルダーで高度な構成設定の cluster_config.json を直接編集できます。Disaster Recovery - アクティブ/パッシブ デプロイの場合は、以下の手順を実行する必要があります。

    1. プライマリ クラスターをインストールして構成します。詳細については、「高度なインストール」をご覧ください。
    2. セカンダリ クラスターをインストールして構成します。詳しくは、「Disaster Recovery - セカンダリ クラスターをインストールする」をご覧ください。
    3. このページの手順に従ってインストールを再開します。

注:

構成プロセスの最後に、/opt/UiPathAutomationSuite/cluster_config.json場所に cluster_config.json ファイルが生成されます。すべてのインストール手順では、 cluster_config.json そのフォルダーに保存することを前提としています。

cluster_config.json を他のすべてのマシンにコピーする

Automation Suite をインストールするには、すべてのマシンで cluster_config.json ファイルが利用可能である必要があります。構成ファイルを最初のマシンで生成したら、再生成するのではなく、他のマシンにコピーする必要があります。構成ファイルを再生成すると、不一致が発生してインストールが失敗する可能性があります。

構成ファイルを最初のマシンから他のマシンにコピーするには、次のコマンドを実行します。必ず、username と node_dns をターゲット マシンに関連する値に置き換えてください。

scp /opt/UiPathAutomationSuite/cluster_config.json <username>@<node_dns>:/opt/UiPathAutomationSuite

ファイルを /opt/UiPathAutomationSuite フォルダーにコピーするための直接アクセス権がない場合は、ファイルをホームディレクトリに転送してから、目的の場所に移動できます。