通知を受け取る

UiPath 製品のインストールとアップグレード

UiPath 製品のインストールとアップグレード ガイド

Windows インストーラー

★削除★ UiPathOrchestrator.msi installer enables you to install Orchestrator on one or multiple nodes, depending on your needs. The following sections provide you with the details on how to perform a successful installation in both single- and multi-node environments.

🚧

重要

このインストールを実行する前に、「前提条件」の章を読み、必要な準備をすべて完了してください。

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

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

  1. Run the Windows Installer (UiPathOrchestrator.msi). The UiPath Orchestrator Setup wizard is displayed.
  2. [ライセンス契約の条項に同意する] チェック ボックスを選択して契約条項に同意し、[インストール] をクリックします。[製品機能] 選択ウィンドウが表示されます。
507507

🚧

重要

When enabling the Test Automation feature a database with the default name UiPathTestAutomation is created. You may choose a different name by passing via the command line TA_DATABASE_NAME=<MyCustomDB> です。

  1. Orchestrator とともに Insights および/または Test Automation 機能をインストールする場合に選択します。[次へ] をクリックします。[Orchestrator IIS 設定] のステップが表示されます。
753753
  1. IIS 設定に必要な変更を行います:
    • Website name - the name of the website. This is set to UiPath Orchestrator by default and cannot be edited.
    • ホスト名 - Orchestrator のインストール先であるデバイスの特定に使用します。既定では、フル コンピューター名に設定されています。
    • Website Port - the port you want to use to enable the communication between the computer and Orchestrator. By default, this is set to 443, to enable you to use HTTPS.
    • [このポートに対するファイアウォール ルールを追加 ] - 選択した場合は、このポートのファイアウォール ルールが自動的に追加され、お使いの端末のセキュリティが確保されます。
    • SSL 証明書 - Orchestrator との接続のセキュリティ保護に使用する SSL 証明書のサブジェクトまたは拇印です。既定では、フル コンピューター名が入力されています。
    • ポートの使用可否を検証 - このチェックボックスをオンにすると、指定された Web サイト ポートが使用可能かどうかを確認します。
  2. [次へ] をクリックします。[アプリケーション プール設定] の手順が表示されます。
752752
  1. 必要に応じて編集可能なオプションを設定します。
    • Name - the application pool name. This is set to UiPath Orchestrator by default and cannot be edited.
    • ID - UiPath Orchestrator の Web サイトを実行する ID を選択することができます。次のオプションを使用できます。
      • アプリケーション プールの ID - アプリケーション プールの既定の ID で Orchestrator Web サイトを実行します。
      • カスタム アカウント - 指定された Windows ID または Domain ID で Orchestrator を実行します。このオプションを選択すると、[ユーザー名] フィールドと [パスワード] フィールドが表示されます。これらのフィールドで、実行する ID を指定できます。

アプリケーション プール ID の詳細については、 Microsoft の公式ドキュメントをご覧ください。

  1. [次へ ] をクリックします。[Orchestrator データベース設定] の手順が表示されます。
754754
  1. 次のように、お使いの SQL Server に関する情報をフィールドに入力します。
    • SQL Server Host - the name of the SQL Server machine. By default, this is set to localhost (.). If it is not the default instance, please also mention it in the MyMachine\MyInstance format. You can also specify a custom port number here using a comma, such as MyMachine\MyInstance,800 です。
    • Database Name - the name of the database. By default, it is set to UiPath. Please note that the following special characters are not supported: an empty space,\ / * : ; ? " < > |, and the maximum length is 123 characters.
    • 認証モード -UiPath Orchestrator の Web サイトの認証モードを選択できます。次のオプションを使用できます。
      • Windows 統合認証 - これが既定のオプションです。このオプションを選択すると、Orchestrator は検出された IIS アプリケーション プールの Windows アカウントを用いてデータベースに接続し、ユーザーが現在のログインに使用した Windows の資格情報を使用してデータベースを作成します。詳細については、「前提条件」をご覧ください。
      • SQL Server Authentication - If you select this option, the SQL Username and Password fields are displayed, which have to be filled in with the SQL Server username and password. For more information, see the Prerequisites chapter. Note: The password does not support the use of semicolons (; など)。
  2. [次へ] をクリックします。インストーラーにより SQL 接続が検証されます。SQL 接続が有効でない場合、ダイアログ ボックスが表示されます。SQL 接続が有効な場合は、[Identity Server の設定] のステップが表示されます。

📘

注:

Identity Server は Orchestrator とともに提供される、UiPath 製品の認証とアクセス制御を集中管理するためのサービスです。

507507

🚧

重要

大規模なデプロイの場合は、Identity Server 用に別のデータベースを使用することをお勧めします。

:warning: Make sure to enter the same URL for Host name in the Orchestrator IIS Settings step of the wizard, and for Orchestrator public URL in the Identity Server Settings step of the wizard. Failure to do so results in a Too many redirects error when accessing Orchestrator.

  1. 次のように、Identity Server に関する情報をフィールドに入力します。
  • Database Name - the name of the database. By default, this is the name of the Orchestrator database, but can be changed. Please note that the following special characters are not supported: an empty space,\ / * : ; ? " < > |, and the maximum length is 123 characters.
  • Orchestrator パブリック URL - Identity Server が接続する Orchestrator の URL です。マルチノードのシナリオでは、これはユーザーが Orchestrator のインストールを呼び出すときに使用する、ロード バランサーの URL です (例: https://orchestrator.mydomain.local)。
    By default, the Orchestrator Public URL is set to https://<host name>. Note that this only applies if you use the default website port: 443. If you opt for a custom port, the Orchestrator Public URL is https://<host name>:<custom port>. For instance, if the website port is set to 444, the Orchestrator Public URL is https://<host name>:444 です。
  • 署名証明書 - Orchestrator と Identity Server 間の認証に使用するアクセス トークンの署名に使用する、証明書のサブジェクトまたは拇印です。
  1. [次へ] をクリックします。[Elasticsearch ログ設定] のステップが表示されます。
550550
  1. (任意) Elasticsearch インスタンスに関する情報をフィールドに次のように入力します。
  • [URL] - 情報ログを記録する Elasticsearch URL。
  • 認証要求 - Elasticsearch インスタンスに認証が必要かどうかを指定できます。選択された場合は、[ユーザー名] と [パスワード] の入力が必要です。
    • ユーザー名 - Elasticsearch ユーザー名。
    • パスワード - ElasticSearch のパスワードです。

📘

注:

Elasticsearch を使用してログを記録しない場合は、[URL] フィールドを空のままとしてください。

  1. [次へ] をクリックします。[Orchestrator 認証設定] の手順が表示されます。
754754
  1. 次のようにフィールドに入力します。
    • ホストのパスワード - ホスト管理者のカスタム パスワードを設定します。パスワードは、8 文字以上にする必要があり、1 文字以上の英文字の小文字と 1 文字以上の数字を含める必要があります。
    • パスワードを確認 - ホスト管理者のパスワードを確認します。
    • 初回ログイン時にリセット - ホスト管理者の初回ログイン時にパスワードを強制的にリセットさせます。これは、ワンタイム パスワードとも呼ばれます。
    • 既定のテナント パスワード - 既定のテナント管理者のカスタム パスワードを設定します。パスワードは、8 文字以上にする必要があり、1 文字以上の英文字の小文字と 1 文字以上の数字を含める必要があります。
    • パスワードを確認 - 既定のテナント管理者のパスワードを確認します。
    • 初回ログイン時にリセット - 既定のテナント管理者が初回ログイン時にパスワードを強制的にリセットさせます。これは、ワンタイム パスワードとも呼ばれます。
    • Windows 認証を有効化する - 選択されている場合は、Windows 認証が Orchestrator 内で有効化され、[Active Directory ドメイン] フィールドが表示されます。
      • Active Directory ドメイン - Orchestrator で使用する Active Directory ドメイン。ユーザーはここから追加されます。
  2. [次へ] をクリックします。Insights 機能を選択した場合は Insights の手順が表示されます。
507507
  1. 次のように、Insights インスタンスに関する情報をフィールドに入力します。
  • SQL Server host - the name of the Insights SQL Server machine. By default, this is set to localhost (.). If it is not the default instance, please also mention it in the MyMachine\MyInstance format. You can also specify a custom port number here using a comma, such as MyMachine\MyInstance,800 です。
  • Database Name - the name of the database. By default, it is set to UiPath. Please note that the following special characters are not supported: an empty space,\ / * : ; ? " < > |, and the maximum length is 123 characters.
  • 認証モード -UiPath Orchestrator の Web サイトの認証モードを選択できます。次のオプションを使用できます。
    • Windows 統合認証 - これが既定のオプションです。このオプションを選択すると、Orchestrator は検出された IIS アプリケーション プールの Windows アカウントを用いてデータベースに接続し、ユーザーが現在のログインに使用した Windows の資格情報を使用してデータベースを作成します。
    • SQL Server Authentication - If you select this option, the SQL Username and Password fields are displayed, which have to be filled in with the SQL Server username and password. Note: The password does not support the user of semicolons (; など)。
  1. [次へ] をクリックします。Test Automation 機能を選択した場合は Test Automation の手順が表示されます。
507507
  1. Test Automation インスタンスに関する情報を、次のようにフィールドに入力します。
  • SQL Server host - the name of the TA SQL Server machine. By default, this is set to localhost (.). If it is not the default instance, please also mention it in the MyMachine\MyInstance format. You can also specify a custom port number here using a comma, such as MyMachine\MyInstance,800 です。
  • Database Name - the name of the database. Please note that the following special characters are not supported: an empty space,\ / * : ; ? " < > |, and the maximum length is 123 characters.
  • 認証モード -UiPath Orchestrator の Web サイトの認証モードを選択できます。次のオプションを使用できます。
    • Windows 統合認証 - これが既定のオプションです。このオプションを選択すると、Orchestrator は検出された IIS アプリケーション プールの Windows アカウントを用いてデータベースに接続し、ユーザーが現在のログインに使用した Windows の資格情報を使用してデータベースを作成します。
    • SQL Server Authentication - If you select this option, the SQL Username and Password fields are displayed, which have to be filled in with the SQL Server username and password. Note: The password does not support the use of semicolons (; など)。
  1. [次へ] をクリックします。[UiPath をインストールする準備ができました] の手順が表示されます。
  2. Click Install. The installation process starts. Note that Orchestrator is installed at the following location: C:\Program Files (x86)\UiPath\Orchestrator です。
  3. IIS マネージャーに移動します。
  4. Orchestrator サーバーを選択します。これにより、機能ビューが更新されます。
  5. [機能の委任] をダブルクリックします。[機能の委任] ビューが表示されます。
  6. 認証 - Windows を右クリックし、読み取り/書き込みをクリックします。
  7. Web サイトを起動します。Orchestrator を使用できます。

📘

注:

To log in as the host administrator, use the credentials provided by our teams when purchasing a license and write host in the Tenant Name field. Details here.

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

🚧

重要

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

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

🚧

重要

:warning: For multi-node installations the CERTIFICATE_SUBJECT and IS_CERTIFICATE_SUBJECT parameters are mandatory. Orchestrator-Identity Server integration does not work if different certifications are used for Identity. Its value in the parameters file used must be a common one across all nodes. This can be accomplished by using:

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

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

MSI インストール

  1. On the primary node:, install Orchestrator from an elevated command prompt using the following command line: UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=install.json REDIS_HOST=redis.corp.local REDIS_PASSWORD=secretPass STORAGE_TYPE=FileSystem STORAGE_LOCATION="RootPath=\\fileserver\Share" QUARTZ_CLUSTERED=1 PUBLIC_URL=<Orchestrator_LoadBalancer_URL> CERTIFICATE_SUBJECT=*.domain.local IS_CERTIFICATE_SUBJECT=*.domain.local です。

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

📘

注:

You can also specify a port for the installed RESP (REdis Serialization Protocol) solution using the REDIS_PORT parameter if you do not want to use the default port (10000 など)。

🚧

重要

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

  1. On all the secondary nodes, install Orchestrator using UiPathOrchestrator.msi with command line arguments, making sure you provide the SECONDARY_NODE parameter set to 1 and the parameters file generated during the primary node installation. Also, specify /Q for silent install, as the necessary parameters are already configured.

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

アプリケーション プールが起動され、Orchestrator インスタンスを使用できるようになります。
プライマリ コードをインストールすると、データベースが初期化されます。セカンダリ ノードでスクリプトを実行するとき、データベースの初期化手順は必要なくなります。

UiPathPlatformInstaller.exe インストール

A multi-node Orchestrator instance can also be installed using the UiPathPlatformInstaller.exe installer as follows:

  1. [マルチノード インスタンスをインストール] 、次に [プライマリ ノードをインストール] を選択し、プロンプトに従って Orchestrator のインストールを完了します。
  2. インストールが完了すると、生成されたパラメーター ファイルへのローカル パスが提供されます。このパスを保存するか、必要に応じて構成ファイルをコピーして、セカンダリ ノードのインストールで使用します。

🚧

重要

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

  1. セカンダリ ノードでインストーラーを起動し、[マルチノード インスタンスをインストール]、次に [セカンダリ ノードをインストール] オプションを選択します。
  2. プライマリ ノードのインストールから生成された構成ファイルへのパスを入力します。
  3. インストールが完了すると、アプリケーション プールが起動され、Orchestrator インスタンスを使用できるようになります。

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

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

This is done using the Generate-ParametersFile.ps1 script, found in the installation directory of your Orchestrator:

  1. Open the Orchestrator installation directory and execute Generate-ParametersFile.ps1 です。
    Note: The appPool custom user password must be passed unless appPoolIdentity is used for authentication.
  2. JSON ファイルは、既存の Orchestrator の構成ファイルと環境に基づいて生成されます。
  3. このファイルを使用して、セカンダリ ノードのインストールを完了します (上記の MSI および UiPathPlatformInstaller.exe インストールの手順 2)。

パッケージの格納に関する考慮事項

アクティビティ、ワークフロー、ライブラリなどの、すべてのパッケージのメタデータ (定義) は、検索とフィルターを高速化するために SQL データベースに保存されます。

これに加え、FileSystem または選択した Blob ストレージ (Azure、Amazon S3、または Minio) に実際のファイルと実行メディアを保存することもできます。この機能では、特に複雑なマルチノードの Orchestrator 環境では、より高性能なファイル同期を行えます。

To enable this feature you are required to configure the NuGet.Repository.Type parameter in the web.config file, as explained here.

パッケージの格納にどのストレージを使用するかを問わず、1 回のアップロード当たりの最大ファイル サイズは 28.6MB (IIS で定められた制限値) であることに留意してください。Amazon、Minio、FileSystem でこれを変更する方法については、このページをご覧ください。Azure でこれを行う方法については、このページをご覧ください。

📘

注:

By default, in new installations, the repository type is set to Composite and the storage type to FileSystem. In update scenarios, your storage type settings are kept. For updates from v2018.4 or previous versions, it is set to Legacy. For more information, see this page.

1 年前に更新


Windows インストーラー


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。