Windows インストーラー

UiPathOrchestrator.msi インストーラーを使用すると、必要に応じて Orchestrator をシングルノードまたはマルチノードでインストールできます。以下のセクションでは、シングルノードとマルチノードの両方の環境でインストールを正常に実行する方法について説明します。

含まれるサービス

Orchestrator のインストールに含まれるサービスは以下のとおりです。

Orchestrator
Identity Server
Webhook
リソースカタログサービス

シングルノードでのインストール

シングルノードのインストールでは、共有する必要がないためセッションはメモリに保持されます。

Windows インストーラー (UiPathOrchestrator.msi) を実行します。UiPath Orchestrator セットアップ ウィザードが表示されます。
[ライセンス契約の条項に同意する] チェックボックスを選択して契約条項に同意し、[インストール] をクリックします。[製品機能] 選択ウィンドウが表示されます。
重要:
- Test Automation 機能を有効化すると、既定の名前 (UiPathTestAutomation) でデータベースが作成されます。別の名前を選択する場合は、コマンドライン TA_DATABASE_NAME=<MyCustomDB> で名前を渡します。
- Test Automation データベースは、Orchestrator データベースから分離することも、Orchestrator データベースの一部にすることもできます。
Orchestrator とともに UiPath Insights および/または Test Automation 機能をインストールする場合に選択します。[次へ] をクリックします。[Orchestrator IIS 設定] のステップが表示されます。
IIS 設定に必要な変更を行います:
- Web サイト名 - Web サイトの名前です。既定では、UiPath Orchestrator に設定されており、編集することはできません。
- Web サイトポート - コンピューターと Orchestrator との間の通信を有効化するために使用するポートです。これは既定で 443 に設定され、HTTPS を使用できます。別のポートを使用する場合は、以下で詳しく説明するように、Identity Server のパラメーター PUBLIC_URL にポートを追加してください。
- [このポートに対するファイアウォールルールを追加 ] - 選択した場合は、このポートのファイアウォールルールが自動的に追加され、お使いの端末のセキュリティが確保されます。
- SSL 証明書 - Orchestrator との接続のセキュリティ保護に使用する SSL 証明書のサブジェクトまたは拇印です。既定では、フルコンピューター名が入力されています。
- ポートの使用可否を検証 - このチェックボックスをオンにすると、指定された Web サイトポートが使用可能かどうかを確認します。
[次へ] をクリックします。[アプリケーションプール設定] の手順が表示されます。
必要に応じて編集可能なオプションを設定します。
- 名前 - アプリケーションプールの名前です。これは既定で UiPath Orchestrator に設定され、編集することはできません。
- ID - UiPath Orchestrator の Web サイトを実行する ID を選択することができます。次のオプションを使用できます。
  - アプリケーションプールの ID - アプリケーションプールの既定の ID で Orchestrator Web サイトを実行します。
  - カスタムアカウント - 指定された Windows ID または Domain ID で Orchestrator を実行します。このオプションを選択すると、[ユーザー名] フィールドと [パスワード] フィールドが表示されます。これらのフィールドで、実行する ID を指定できます。
    
    アプリケーションプール ID の詳細については、 Microsoft の公式ドキュメントをご覧ください。
- [次へ ] をクリックします。[Orchestrator データベース設定] の手順が表示されます。
次のように、お使いの SQL Server に関する情報をフィールドに入力します。
- SQL Server ホスト - SQL Server マシンの名前です。既定では、localhost (.) に設定されています。これが既定のインスタンスではない場合は、MyMachine\MyInstance の形式で既定のインスタンスを記述してください。また、MyMachine\MyInstance,800 のようにコンマを使用することで、ここでカスタムポート番号を指定できます。
- データベース名 - データベースの名前です。既定では UiPath に設定されています。これらの特殊文字 (空白スペース、\、/、*、:、;、?、"、<、>、|) はサポートされていません。長さは最大 123 文字です。
- 認証モード -UiPath Orchestrator の Web サイトの認証モードを選択できます。次のオプションを使用できます。
  - Windows 統合認証 - これが既定のオプションです。このオプションを選択すると、Orchestrator は検出された IIS アプリケーションプールの Windows アカウントを用いてデータベースに接続し、ユーザーが現在のログインに使用した Windows の資格情報を使用してデータベースを作成します。
  - SQL Server 認証 - このオプションを選択すると、[SQL ユーザー名] フィールドと [パスワード] フィールドが表示されます。これらのフィールドには SQL サーバーのユーザー名とパスワードを入力する必要があります。詳細については前提条件のセクションをご覧ください。
    
    注: パスワードはセミコロン (;) の使用をサポートしていません。
- [次へ] をクリックします。インストーラーにより SQL 接続が検証されます。SQL 接続が有効でない場合、ダイアログボックスが表示されます。SQL 接続が有効な場合は、[Identity Server の設定] のステップが表示されます。
  
  注: Identity Server は Orchestrator とともに提供される、UiPath 製品の認証とアクセス制御を集中管理するためのサービスです。
  
  重要: 大規模なデプロイの場合は、Identity Server 用に別のデータベースを使用することをお勧めします。
次のように、Identity Server に関する情報をフィールドに入力します。
- データベース名 - データベースの名前です。既定では Orchestrator データベースの名前ですが、変更できます。特殊文字 (空白スペース、\、/、*、:、?、"、<、>、|) はサポートされていません。長さは最大 123 文字です。
- Orchestrator パブリック URL - Identity Server が接続する Orchestrator の URL です。マルチノードのシナリオでは、これはユーザーが Orchestrator のインストールを呼び出すときに使用する、ロードバランサーの URL です (例: https://orchestrator.mydomain.local)。
  
  既定では、Orchestrator のパブリック URL は https://<host name> に設定されています。これは、既定の Web サイトポート (443) を使用する場合にのみ適用されることに注意してください。カスタムポートを使用する場合、Orchestrator のパブリック URL は https://<host name>:<custom port> です。たとえば、Web サイトポートが 444 に設定されている場合、Orchestrator のパブリック URL は https://<host name>:444 です。
- 署名証明書 - Orchestrator と Identity Server 間の認証に使用するアクセストークンの署名に使用する、証明書のサブジェクトまたは拇印です。
[次へ] をクリックします。[更新サーバーのデータベース設定] の手順が表示されます。
次のように、更新サーバーデータベースに関する情報をフィールドに入力します。
- SQL Server ホスト - SQL Server マシンの名前です。既定では、localhost (.) に設定されています。localhost が既定のインスタンスではない場合は、必ず MyMachine\MyInstance の形式で既定のインスタンスを記述してください。また、MyMachine\MyInstance,800 のようにコンマを使用することで、ここでカスタムポート番号を指定できます。
- データベース名 - 更新サーバーが使用するデータベースの名前です。既定ではこれは Orchestrator データベースの名前ですが、変更できます。次の特殊文字はサポートされていません: 空白スペース、\、/、*、:、?、"、<、>、|)。また、長さは最大 123 文字です。
- 認証モード - 更新サーバーの認証モードを選択できます。次のオプションを使用できます。
  - Windows 統合認証 - これが既定のオプションです。このオプションを選択すると、Orchestrator は検出された IIS アプリケーションプールの Windows アカウントを用いてデータベースに接続し、ユーザーが現在のログインに使用した Windows の資格情報を使用してデータベースを作成します。
  - SQL Server 認証 - このオプションを選択すると、[SQL ユーザー名] フィールドと [パスワード] フィールドが表示されます。これらのフィールドには SQL サーバーのユーザー名とパスワードを入力する必要があります。詳細については前提条件のセクションをご覧ください。
    注: パスワードはセミコロン (;) の使用をサポートしていません。
- [次へ] をクリックします。[Elasticsearch ログ設定] のステップが表示されます。
(任意) Elasticsearch インスタンスに関する情報をフィールドに次のように入力します。
- [URL] - 情報ログを記録する Elasticsearch URL。
- 認証要求 - Elasticsearch インスタンスに認証が必要かどうかを指定できます。選択された場合は、[ユーザー名] と [パスワード] の入力が必要です。
  - ユーザー名 - Elasticsearch ユーザー名。
  - パスワード - ElasticSearch のパスワードです。
    
    注: Elasticsearch を使用してログを記録しない場合は、[URL] フィールドを空のままとしてください。
- [次へ] をクリックします。[Orchestrator 認証設定] の手順が表示されます。
次のようにフィールドに入力します。
- ホストのパスワード - ホスト管理者のカスタムパスワードを設定します。パスワードは、8 ～ 33 文字にする必要があり、1 文字以上の英文字の小文字と 1 文字以上の数字を含める必要があります。
- パスワードを確認 - ホスト管理者のパスワードを確認します。
- 初回ログイン時にリセット - ホスト管理者の初回ログイン時にパスワードを強制的にリセットさせます。これは、ワンタイムパスワードとも呼ばれます。
- 既定のテナントパスワード - 既定のテナント管理者のカスタムパスワードを設定します。パスワードは、8～ 33 文字にする必要があり、1 文字以上の英文字の小文字と 1 文字以上の数字を含める必要があります。
- パスワードを確認 - 既定のテナント管理者のパスワードを確認します。
- 初回ログイン時にリセット - 既定のテナント管理者が初回ログイン時にパスワードを強制的にリセットさせます。これは、ワンタイムパスワードとも呼ばれます。
[次へ] をクリックします。Insights 機能を選択した場合は Insights の手順が表示されます。

注: Insights SQL Server の構成時には、db_owner ロールを必ず選択してください。このロールは、データベース所有者のロールを追加するときに必要です。
次のように、Insights インスタンスに関する情報をフィールドに入力します。
- [QL Server ホスト - Insights の SQL Server マシンの名前です。既定では、localhost (.) に設定されています。これが既定のインスタンスではない場合は、MyMachine\MyInstance の形式で既定のインスタンスを記述してください。また、MyMachine\MyInstance,800 のようにコンマを使用することで、ここでカスタムポート番号を指定できます。
- データベース名 - データベースの名前です。既定では UiPath に設定されています。これらの特殊文字 (空白スペース、\、/、*、:、;、?、"、<、>、|) はサポートされていません。長さは最大 123 文字です。
- 認証モード -UiPath Orchestrator の Web サイトの認証モードを選択できます。次のオプションを使用できます。
  - Windows 統合認証 - これが既定のオプションです。このオプションを選択すると、Orchestrator は検出された IIS アプリケーションプールの Windows アカウントを用いてデータベースに接続し、ユーザーが現在のログインに使用した Windows の資格情報を使用してデータベースを作成します。
  - SQL Server 認証 - このオプションを選択すると、[SQL ユーザー名] フィールドと [パスワード] フィールドが表示されます。これらのフィールドには SQL サーバーのユーザー名とパスワードを入力する必要があります。
- [次へ] をクリックします。Test Automation 機能を選択した場合は Test Automation の手順が表示されます。
Test Automation インスタンスに関する情報を、次のようにフィールドに入力します。
- SQL Server ホスト - TA SQL Server マシンの名前です。既定では、localhost (.) に設定されています。これが既定のインスタンスではない場合は、MyMachine\MyInstance の形式で既定のインスタンスを記述してください。また、MyMachine\MyInstance,800 のようにコンマを使用することで、ここでカスタムポート番号を指定できます。
- データベース名 - データベースの名前です。特殊文字 (空白スペース、\、/、*、:、;、?、"、<、>、|) はサポートされていません。長さは最大 123 文字です。
- 認証モード -UiPath Orchestrator の Web サイトの認証モードを選択できます。次のオプションを使用できます。
  - Windows 統合認証 - これが既定のオプションです。このオプションを選択すると、Orchestrator は検出された IIS アプリケーションプールの Windows アカウントを用いてデータベースに接続し、ユーザーが現在のログインに使用した Windows の資格情報を使用してデータベースを作成します。
  - SQL Server 認証 - このオプションを選択すると、[SQL ユーザー名] フィールドと [パスワード] フィールドが表示されます。これらのフィールドには SQL サーバーのユーザー名とパスワードを入力する必要があります。
    
    注: パスワードはセミコロン (;) の使用をサポートしていません。
- [次へ] をクリックします。[Orchestrator ストレージ設定] の手順が表示されます。
目的の [ストレージの種類] と [ストレージの場所] を入力します。詳細についてはこちらをご覧ください。
[次へ] をクリックします。[UiPath をインストールする準備ができました] の手順が表示されます。
[インストール] をクリックします。インストールプロセスが開始されます。Orchestrator は、C:\Program Files (x86)\UiPath\Orchestrator にインストールされます。

重要: 選択したインストールパスをダブルチェックします。ある場所にインストールしたものを後から別の場所に移動することはできません。
IIS マネージャーに移動します。
Orchestrator サーバーを選択します。これにより、機能ビューが更新されます。
[機能の委任] をダブルクリックします。[機能の委任] ビューが表示されます。
認証 - Windows を右クリックし、読み取り/書き込みをクリックします。
Web サイトを起動します。Orchestrator を使用できます。

注: ホスト管理者としてログインするには、ライセンス購入時に UiPath から提供される認証情報 (不明な場合はお問い合わせください) を使用して、host を [テナント名] フィールドに書き込みます。詳しくは、こちらをご覧ください。

マルチノードでのインストール

重要:

Orchestrator のマルチノードデプロイは、通信に REdis Serialization Protocol (RESP) を使用するため、このプロトコルを実装するあらゆるソリューションによる設定が可能です。

UiPath では、マルチノード Orchestrator での高可用性デプロイは、UiPath High Availability Add-on が使用されている場合にのみサポートされます。

重要: マルチノードインストールの場合、CERTIFICATE_SUBJECT および IS_CERTIFICATE_SUBJECT パラメーターは必須です。Identity Server に異なる証明書が使用されている場合、Orchestrator と Identity Server の連携は機能しません。使用するパラメーターファイルの値は、すべてのノードで共通の値である必要があります。共通の値にするためには次のような方法があります。

ワイルドカードの証明書の使用 (subject=*.domain.local) または
パブリックロードバランサーと、すべてのノード (任意) の DNS 名が含まれるサブジェクトの別名 (SAN) 証明書の使用。これはセカンダリノードのインストールを行う前に、証明書を作成するタイミング、またはパラメーターファイルの値を編集するタイミングのいずれかで使用します。

証明書はサブジェクトまたは拇印で入力できます。

プライマリノードで管理者権限でコマンドプロンプトを開き、次のコマンドラインにより Orchestrator をインストールします。

UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=install.json REDIS_HOST=redis.corp.local REDIS_PASSWORD=secretPass STORAGE_TYPE=FileSystem STORAGE_LOCATION="RootPath=\\fileserver\Share" PUBLIC_URL=<Orchestrator_LoadBalancer_URL> CERTIFICATE_SUBJECT=*.domain.local IS_CERTIFICATE_SUBJECT=*.domain.local

使用できるパラメーターの詳細については、こちらをご覧ください。

注: 既定のポート (6379) を使用しない場合は、REDIS_PORT パラメーターを使用して、インストール済みの REdis Serialization Protocol (RESP) ソリューションのポートを指定することもできます。

High Availability Add-on では、ポート 10000 が使用されます。

重要: デプロイに Insights を含む場合は、Orchestrator のセカンダリノードをインストールする前に Insights のインストールを完了してください。

すべてのセカンダリノードで、UiPathOrchestrator.msi を使用し、コマンドライン引数を指定して、Orchestrator をインストールします。この時、SECONDARY_NODE パラメーターを true に設定し、プライマリノードのインストール時に生成されたパラメーターファイルを指定してください。また、パッシブインストールでは進行状況バーとエラーポップアップが表示されるため、/passive パラメーターを使用することをお勧めします。Unattended インストールの場合のみ、/Q パラメーターを指定して、サイレントモードを選択します。

例: UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json /Q。

アプリケーションプールが起動され、Orchestrator インスタンスを使用できるようになります。

プライマリコードをインストールすると、データベースが初期化されます。セカンダリノードでスクリプトを実行するとき、データベースの初期化手順は必要なくなります。

マルチノードの Orchestrator にノードを追加する

上記の方法では、最初のデプロイ時にプライマリノードとセカンダリノードをインストールし構成することを想定していますが、既存のノードからパラメーターファイルを生成して、追加ノードのインストールに使用することもできます。

これには、Orchestrator インストールディレクトリの Tools サブフォルダーにある Generate-ParametersFile.ps1 スクリプトを使用します。

Orchestrator インストールディレクトリの Tools サブフォルダーを開き、Generate-ParametersFile.ps1 を実行します。

注: 認証に appPoolIdentity を使用しない限り、appPool カスタムユーザーのパスワードを渡す必要があります。
JSON ファイルは、既存の Orchestrator の構成ファイルと環境に基づいて生成されます。
このファイルを使用して、セカンダリノードのインストールを完了します (上記の「マルチノードでのインストール」の手順 2)。