通知を受け取る

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

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

インストール

🚧

重要

このページの情報は、Insights v2021.10 の公開後に HW/SW の仕様に関して発生した変更です。Insights v2021.10 では Windows マシンが 1 台必要ですが、Insights v2022.10 では Windows マシンと RHEL 8.2-8.6 または 9.0 の Linux マシンが 1 台ずつ必要になります。

クリックしてこのセクションを展開

v2021.10 では、Insights の Windows マシンでは Looker の Linux コンテナーをホストする Docker が実行されていました。しかし、Windows 2022 以降は、Windows OS に Linux コンテナーをネストするために使用するドライバー (LCOW) が、エンタープライズ アプリケーションとして Microsoft によりサポートされなくなりました。その結果、デプロイ アーキテクチャを変更する必要が発生しました。現在は、2 台のマシン (UiPath Insights コンポーネントを実行する Windows マシン 1 台と Looker コンテナーを実行する Linux マシン 1 台) が必要です。この変更により、UiPath 製品の実行に必要なコンポーネントについて、OS ベンダーのエンタープライズ サポートが利用できるようになりました。Linux OS のサポート対象のバージョンは、Automation Suite がサポートするバージョンと同じです。

概要

📘

はじめる前に

詳しくは、Insights の「ハードウェアおよびソフトウェアの要件」をご覧ください。

スタンドアロンの Insights v2022.10 をインストールするには、以下に示した順番で手順を実行する必要があります。

  1. Insights の Windows マシンと Linux マシンを準備する
  2. Insights Linux マシンで Looker を初期化する
  3. Insights をインストールする

Insights の Windows マシンと Insights の Linux マシンを準備する

  1. 両方のマシンで SSL を有効化できるよう、証明書を準備します。詳しくは、こちらをクリックしてください。

📘

注

Looker および Insights の証明書は、Insights にアクセスするマシンにインポートするようにしてください。

LookerPreinstallationtool.exe は Insights Windows マシンから Insights Linux マシンに証明書をエクスポートするため、Insights Linux マシンの証明書は Insights Windows マシンにインストールする必要があります。

  1. ハードウェアおよびソフトウェアの要件を満たす 2 台のマシンを構成します。
Linux マシンを準備する手順の詳細
AWS EC2 Linux マシンを準備する

手順 1: AWS EC2 で Linux インスタンスを起動する

  1. インスタンスの起動を開始します。
  2. Red Hat Enterprise Linux 8 のイメージを選択します (バージョン 8.2-8.6 または 9.0 がサポートされています)。
  3. インスタンスの種類を選択し、インスタンスの詳細を設定します。
  4. インスタンスにストレージを追加し、サイズを 32 に変更します。
  5. インスタンスの設定を確認し、インスタンスを起動します。
    詳しくは、AWS でのインスタンスの起動開始方法について説明されているこちらのページをご覧ください。

手順 2: 受信ポートを開く

こちらに記載された手順に従って、以下の表に示された受信ポートを開きます。

TypePort rangeSourceDescription
Custom TCP9999Anywhere-IPv4This is the Looker port.
Custom TCP19999Anywhere-IPv4This is the Looker API port.
Custom TCP29999Anywhere-IPv4This is the LookML update port.
  1. [Save rules] をクリックします。
Microsoft Azure Linux 環境を準備する

手順 1: Linux を実行するマシンを作成する

  1. [サービス] > [仮想マシン] > [作成] に移動します。
  2. [すべてのイメージを表示] に移動し、[プラン] から [Red Hat Enterprise Linux 8.2 - 8.6 または 9.0] を選択します。オフラインの RHEL バンドルが必要な場合は、こちらをクリックして RHEL 8を、こちらをクリックして RHEL 9 を取得してください。
1464
  1. 管理者アカウントで、[SSH 公開キー] または [パスワード] のどちらかを選択します。SSH 公開キーを使用する場合は、キーを生成して、[Azure に格納されている既存のキーを使用] を選択します。

手順 2: 作成したマシンへの受信ポートを開く

こちらに記載された手順に従って、以下の表に示された受信ポートを開きます。

Destination port rangesNamePrioritySource
9999Looker_Port310Any
19999LookerAPI_Port320Any
29999LookMLUpdate_Port330Any

その他の設定方法については、「受信セキュリティ規則の作成」をご覧ください。

手順 3: Azure Linux マシンのストレージ割り当てを増やす

Azure Linux マシンの既定のストレージ割り当ては 8 GB です。このストレージ サイズでは、イメージのプル、バックアップの作成、または複数のダッシュボードの使用時に、領域不足のエラーが発生する可能性があります。

エアギャップ環境の場合は、/home および /var ボリュームに十分な空き領域があることを確認してください (例: /home に 4 GB 以上、/var ボリュームに 10 GB) (「Insights Linux マシンのハードウェア要件」をご覧ください)。ストレージの割り当てを増やして領域不足のエラーを回避するには、デプロイ スクリプトを実行する前に次の手順を実行します。

  1. 以下のコマンドを実行して、Linux マシンで SSH クライアントを開きます。
ssh azureuser@<your-hostname>

<your-hostname> は、マシンのホスト名を反映するように調整する必要があります。

  1. 以下のコマンドを実行してルート ユーザーに変更します。
sudo -i
  1. 以下のコマンドを実行してディスク サイズを確認します。
lsblk -f

/var マウント ポイントは、名前 sda2 > rootvg-varlv の下にあります。

1084
  1. 以下のコマンドを実行して /dev/sda2 のサイズを確認します。
lsblk /dev/sda2

/dev/sda2 は、手順 3 から取得します。/var のサイズ (8G) が表示されます。

829
  1. 次に、以下のコマンドを実行して利用可能な領域を確認します。
vgdisplay rootvg
940

[Free PE / Size] が 40 GiB 程度であることを確認できます。

  1. 以下のコマンドを実行して rootvg-varlv のサイズを増やします。
    このサイズは、たとえば +10G や、それ以外の値にも変更できます。この値は、利用可能な 40GB (手順 5 で確認する空きメモリのサイズ) よりも小さい値にします。
lvresize -r -L +10G /dev/mapper/rootvg-varlv

注: エアギャップ インストールの場合は、/home で同じコマンドを実行してください。

1339 
lsblk /dev/sda2

docker の空き容量 (場所は /var/lib/docker) が十分に確保されていることが確認できます。

746

📘

注

エアギャップ環境の場合は、手順 1 ～ 6 のコマンドを実行して「/home」のサイズを増やし、オフライン イメージとパッケージ バンドルのために十分な領域を確保してください。

Insights サービスをホストするための Windows マシンを準備する手順の詳細

  1. ハードウェアおよびソフトウェアの要件を満たす Windows マシンを構成します。

  2. 既定の受信ポート (443) を開きます。AWS で受信ポートを開く方法については、[Linux インスタンス用のインバウンドトラフィックの承認](https://docs.aws.amazon.com/ja_jp/AWSEC2/latest/UserGuide/authorizing-access-to-an-instance.html) をご覧ください。Azure で受信ポートを開く方法については、[Azure Portal を使用して仮想マシンへのポートを開く方法](https://learn.microsoft.com/ja-jp/azure/virtual-machines/windows/nsg-quickstart-portal) をご覧ください。

  3. Install-Prerequisites.ps1 スクリプトを実行して IIS 10 以降を有効化し、.NET 6.0.5 以降をインストールしてから IIS サービスを再起動します。または、以下の手順 3.1 ～ 3.4 で強調されている前提条件を手動でインストールすることもできます。

   3.1 作成したマシンで RDP セッションを開き、前提条件をインストールします。

   3.2 バージョン 10 以降の IIS を有効化します。

バージョン 10 以降の IIS の有効化について詳しくは、こちらをクリックしてください。

バージョン 10 以降の IIS を有効化するには、[コントロール パネル] > [プログラム] > [Windows 機能の有効化または無効化] に移動します。[役割と機能の追加ウィザード] が開きます。ウィザードの手順に従って Web サーバー (IIS) を有効化します。

1011

こちらをクリックすると [役割と機能の追加ウィザード] が開きます。ウィザードの手順に従って Web サーバー (IIS) を有効化します。

236

次の Web サーバー (IIS) モジュールを有効化します。

  • Web サーバー
    • HTTP 共通機能
      • 既定のドキュメント
      • ディレクトリの参照
      • HTTP エラー
      • 静的なコンテンツ
    • 健全性と診断
      • HTTP ログ
    • パフォーマンス
      • 静的なコンテンツ
    • セキュリティ
      • 要求フィルター
  • 管理ツール
    • IIS 管理コンソール

 

   3.3 .NET ホスティング バンドルのバージョン 6.0.5 以降をダウンロードしてインストールします。

   3.4 PowerShell で次のコマンドを実行します。

net stop was /y ; net start w3svc

  1. SSL 証明書を使用して、マシンで HTTPS を有効化します。Orchestrator と同様の手順に従って、証明書を準備します。詳しくは、「証明書を使用して HTTPS プロトコルを有効化する」をご覧ください。

  2. Insights のホスト名を指定する際は、DNS 内で解決できるホスト名であることを確認してください。

  3. TLS 1.1 または 1.2 を使用してください。

🚧

重要

• Insights SQL マシンの構成時にデータベース所有者のロールを追加するには db_owner ロールが必要であるため、必ずこのロールを選択してください。

• Orchestrator と Insights の両方のバージョンが一致している必要があります。たとえば、v2022.10.0 の Orchestrator を実行する場合は、同じバージョンの Insights を実行する必要があります。こうすることで、これらの 2 つの UiPath 製品間で適切な通信が確立されます。

• Insights データベースは、Orchestrator のインストール中に Insights を有効化した際に作成されたデータベースをポイントする必要があります。

• データベースが大きい場合は、SQL スクリプトを使用して手動でインデックスを追加することを検討してください。大きなデータ セットのインデックスを作成する必要がある場合、Insights データベースの移行中に Orchestrator のインストールが失敗することがあります (「インストール中にデータベースの移行が失敗する」をご覧ください)。

SQL Server 構成

Insights のインストール前に、使用する Insights SQL Server インスタンスを構成する必要があります。

📘

注:

Insights SQL データベースは大文字と小文字を区別しない (「InsightsDB」=「insightsdb」) 設定である必要があります。Insights のインストール プロセス中にデータベースが作成される場合は、大文字と小文字が区別されないよう自動的に設定されます。独自の Insights データベースを作成する場合は、照合順序を Latin1_General_CI_AS に設定し、大文字と小文字が区別されないよう手動で設定してください。

Insights インストーラーの実行に必要な以下の情報が容易に入手できることを確認してください。

  • SQL Server マシンの名前
  • 既定のインスタンスではない場合は、インスタンスの名前

また、以下の項目も確認してください。

  • SQL Server マシンのファイアウォールで SQL Server のポートがオープンされている。「SKIP_FIREWALL_RULE_CREATION=true」を使用して、ファイアウォール ルールの作成をスキップできます。
  • SQL Server Configuration Manager で TCP プロトコルが有効化されている
  • SQL Server サービスが、動的に割り当てられたポートではなく固定ポートをリッスンするよう設定されている

Insights が SQL Server データベースに接続するための認証方法を構成します。認証方法は次のいずれかです。

Windows 統合認証 (クリックして展開)

このオプションを使用するには、SQL Server にサービス アカウントとして新しくログインする必要があります。サービス アカウントは、パスワードが無期限のドメイン ユーザーである必要があります。Looker は、Insights が使用する基盤のエンジンであり、Linux コンテナーで実行されます。

🚧

重要

Windows 認証を有効化するには、SQL Server が Kerberos プロトコル経由の認証をサポートしている必要があります。

SQL Server で Kerberos 認証を有効化する方法について詳しくは、「[SPN の手動登録](https://learn.microsoft.com/ja-jp/sql/database-engine/configure-windows/register-a-service-principal-name-for-kerberos-connections?view=sql-server-ver15#Manual)」をご覧ください。

Windows 統合認証を構成する際の考慮事項

  • Kerberos 認証を構成する前に、Insights サーバーがお使いの Active Directory (AD) および SQL Server にアクセスできることを確認してください。IT 管理者とともに確認することをお勧めします。
  • SQL Server は AD ドメインに追加されている必要があります。
  • Insights マシンは、AD ドメインおよび SQL Server と同じネットワーク上にある必要があります。
  • Insights マシンが AD ドメインと SQL Server の両方のドメイン名を解決できるように DNS を構成する必要があります。
  • Active Directory ユーザーは、「権限」セクションで定義されているように、SQL サーバーと DB へのアクセス権を持つ必要があります。このユーザーのドメイン、ユーザー名、パスワードを、Insights のインストール プロセスで指定する必要があります。ユーザー名は大文字と小文字が区別され、ユーザーの sAMAccountName としても機能しますのでご注意ください。
    CMD を管理者として開き、set user を実行して USERDNSDOMAIN と USERNAME を取得します。
  • SQL Server は Active Directory に SPN エントリを登録する必要があります。詳しくは、「Kerberos 接続用にサービス プリンシパル名を登録する」をご覧ください。

🚧

重要

重要な条件として、Insights マシンは、Active Directory ドメインと SQL Server の両方のドメイン名を解決する必要があります。これは、ホスト マシン上で nslookup <your_AD_domain_name> と nslookup <your_SQL_server_domain_name> を実行することで確認できます。

SQL Server Management Studio で新しいログインを作成する

  1. [オブジェクト エクスプローラ] パネルで [セキュリティ] > [ログイン] に移動します。
  2. [ログイン] フォルダーを右クリックして [新しいログイン] を選択します。
  3. [Windows 認証] オプションを選択します。ウィンドウが適切に更新されます。
704
  1. [ログイン名] フィールドに、サービス アカウントとして使用するユーザー ドメインを入力します。
  2. [既定の言語] リストから [English] を選択します。

🚧

重要

[既定の言語] が [English] に設定されていることを確認します。英語でない場合 Web サイトは起動できず、Insights がインストールされているマシンのイベント ビューアーに、データ型が変換できなかったことを示す次のエラー メッセージが表示されます。The conversion of a varchar data type to a datetime data type resulted in an out-of range value

  1. [OK] をクリックして構成を保存します。
    サービス アカウントが既に作成され、SQL Server の [セキュリティ] > [ログイン] セクションに追加されている場合、SQL アカウントの [既定の言語] が英語に設定されていることを確認してください。英語に設定されていない場合は、適切に変更する必要があります。
SQL Server 認証 (クリックして展開)

この認証方法では、SQL Server ユーザーが必要です。
セキュリティ上の理由から、非 SA (非システム管理者) アカウントの使用を検討してください。

SQL Server Management Studio で新しい SQL ユーザーを作成する

  1. [オブジェクト エクスプローラ] パネルで [セキュリティ] > [ログイン] に移動します。
  2. [ログイン] フォルダーを右クリックして [新しいログイン] を選択します。[ログイン - 新規作成] ウィンドウが表示されます。
  3. [SQL Server 認証] オプションを選択します。ウィンドウが適切に更新されます。
700
  1. [ログイン名]、[パスワード]、[パスワードの確認入力] の各フィールドに適切な値を入力します。
  2. [パスワードの期限を適用する] と [ユーザーは次回ログイン時にパスワードを変更する] の 2 つのオプションがオフになっていることを確認します。

🚧

重要

[既定の言語] が [English] に設定されていることを確認してください。英語でない場合 Web サイトは起動できず、Insights がインストールされているマシンのイベント ビューアーに、データ型が変換できなかったことを示す次のエラー メッセージが表示されます。「The conversion of a varchar data type to a datetime data type resulted in an out of range value」

SQL Server アカウントが既に作成され、SQL Server の [Security] > [Logins] セクションに追加されている場合、Default Language が英語に設定されていることを確認してください。英語に設定されていない場合は、適切に変更します。

アクセス許可

Regardless of the type of user (domain or SQL) you want to connect to SQL Server, please note that you need to assign it the dbcreator Server Role BEFORE installing Insights, as the database is created during this installation process.

セキュリティの規制としてサービス アカウントで dbcreator サーバーの役割の使用を許可していない場合、SQL Server で空のデータベースを作成します。

Windows インストーラーが SQL Server に接続され、データベースの存在が確認されます。

データベースの作成後、以下のスクリーンショットに示すように、Orchestrator SQL データベースに接続するユーザーに db_owner ユーザー マッピング ロールを付与する必要があります。

704

セキュリティ規制により UiPath ログインで db_owner ユーザーマッピングの役割が使用できない場合、次の許可を設定します。

  • db_datareader
  • db_datawriter
  • db_ddladmin
  • dbo スキーマに対する EXECUTE 権限
705

EXECUTE 権限は、GRANT EXECUTE SQLコマンドを用いて次のように許可を設定する必要があります。

  • Windows 統合認証を使用している場合:
USE UiPath Insights
GO
GRANT EXECUTE ON SCHEMA::dbo TO [domain\user]
GO
  • SQL サーバー認証を使用している場合:
USE UiPath Insights
GO
GRANT EXECUTE ON SCHEMA::dbo TO [sql_user]
GO

📘

推奨

データベースの既定の MAXDOP を構成するには、「max degree of parallelism サーバー構成オプションの構成」をご覧ください。

 

Orchestrator をインストールし Insights の機能を有効化する

このセクションは、Insights データベースを準備するために必要です。Insights のインストールを続行する前に、実際のシナリオに応じて Orchestrator の Insights 機能を有効化する必要があります。

For versions above 2021.10 Orchestrator and Insights fresh installation or Add Insights to existing Orchestrator installation: See Step 3 in Orchestrator Single-Node Installation).

For versions before 2021.10, when you Upgrade Insights: Disable the Insights feature in Orchestrator, then re-enable it.

Orchestrator installed as app service in Azure: If you run Orchestrator as an app service in Azure, you can run a script to publish to Orchestrator and enable Insights through the -insightsFeatureEnabled parameter.

📘

Information

• Orchestrator と Insights の両方のバージョンが一致している必要があります。たとえば、v2022.10.0 の Orchestrator を実行する場合は、同じバージョンの Insights を実行する必要があります。こうすることで、これらの 2 つの UiPath 製品間で適切な通信が確立されます。

• Insights データベースは、Orchestrator のインストール中に Insights を有効化した際に作成されたデータベースをポイントする必要があります。

• データベースが大きい場合は、SQL スクリプトを使用して手動でインデックスを追加することを検討してください。大きなデータ セットのインデックスを作成する必要がある場合、Insights データベースの移行中に Orchestrator のインストールが失敗することがあります。

Insights Linux マシンで Looker を初期化する

Insights Linux マシンで Looker を初期化するには、以下の手順に従います。

または、デプロイ スクリプトを使用することもできます (クリックしてセクションを展開)。
  1. LookerPreinstallationTool.exe ツールを実行して、Looker の ZIP ファイルを生成します。Insights Windows マシンで Looker ファイルが生成されます。
  2. Insights Linux マシンに Looker ファイルをコピーして Looker をデプロイするか、Deploy-Looker.ps1 スクリプトを使用して展開済みのファイルを Insights Linux マシンにコピーしてから、Looker を初期化します。

🚧

重要

Deploy-Looker.ps1 スクリプトは LookerPreinstallationTool.exe バージョン 2022.10.0 に対応しています。

詳細については、「自動リモート デプロイのスクリプト」をご覧ください。

Insights Windows マシンで Looker ファイルを生成する

The SMTP settings are configured automatically starting with the 2022.10 version

  1. LookerPreinstallationTool.exe をダウンロードし、Insights Windows マシンで実行します。
  2. ZIP ファイルを生成するための最初の手順に従います。
  3. 言語を選択します。

🚧

中国語/韓国語/日本語を選択する場合

コンソールに中国語/韓国語/日本語が正しく表示されない場合は、コンソールのフォントを変更してください。PowerShell の場合は、タイトル バーを右クリックして [プロパティ] を選択し、TrueType フォント (例: MS ゴシック、MS 明朝、NSimSun) を選択します。

  1. 生成された証明書を検証し、エクスポートします。ホスト名が完全修飾されており、証明書でカバーされていることを確認します。

📘

注:

証明書は、 個人用 と 信頼されたルート証明機関 の両方のフォルダーに配置する必要があります。

823
  1. (任意) Windows 認証を使用する場合はその構成を行います。

📘

注

v21.10 からアップグレードする場合、v22.10 ではアーキテクチャが 2 つの仮想マシンに変更されたため、ダッシュボード、アラート、スケジュールは v21.10 から v22.10 に自動的に転送されません。ダッシュボード、アラート、スケジュールの消失を避けるには、手順 6 に従ってこのコンテンツを新しい Linux マシンに移行してください。これは、v22.4 からのアップグレードには適用されません。アップグレード時にこの手順を完了しなかった場合、InsightsInstaller.msi によるインストールが正常に完了すると、ダッシュボード、スケジュール、アラートはすべて削除され、新しい Looker マシンにエクスポートできなくなります。

  1. (任意) 以前のダッシュボード、アラート、スケジュールを新しいバージョンで引き続き使用できるよう、データをエクスポートします。このツールは、マシン上で looker_container が実行されているかどうかを検出できます。データを移行すると、$Env:ProgramData\UiPath Insights に格納されている現在の Looker パスワードがエクスポートされ、新しい Insights Linux マシンで使用されます。
  2. (任意) ZIP ファイルを暗号化して Looker シークレットを保護します。手順 4 を完了した場合は、パスワードを使用して ZIP ファイルを保護することを検討してください。
823
  1. ZIP ファイルを作成する場所のパスを入力します。パスを入力しない場合は、コンソールに表示される既定のパスにファイルが作成されます。

Looker ファイルを Insights Linux マシンにコピーする

ZIP ファイルを Insights Linux マシンにコピーする

  1. Insights Linux マシンに対して認証を行います。
  2. 以下のコマンドを実行して、SCP セッションを開き、ZIP ファイルのパスと、Insights Linux マシンの資格情報として使用するユーザー名/パスワードを含むコマンドを入力します。 
scp <path-to-Insights_Lookerfile>.zip <user@linuxhostname>:~/

📘

注

PowerShell 7 以上、または PuTTY の使用を検討してください。以前のバージョン (PowerShell 5.1) ではレンダリングの問題が発生したり、空白の画面が表示されたりする可能性があります。

Looker を初期化する

  1. PowerShell を開き、以下のコマンドを実行して認証を行います。
ssh <username@hostname>

📘

注

Insights の Linux マシンにログインしたら、システムのローカル時刻が正しいことを確認してください。時刻が正しくない場合、Looker が無限更新ループに入る可能性があります。

  1. 次のコマンドを使用して GPG キーを生成します。
gpg --generate-key

入力画面が表示されたら、ユーザー名とメール アドレスを入力し、パスワードを設定します。公開キーが生成されます。公開キーは、後で使用するので、必ず保存してください。

公開キーは、Looker の初期化中に生成された Looker のパスワードと証明書の保存に使用されます。この公開キーは、looker-initialization.sh の実行時に -k パラメーターを使用して渡すことができます。

1531
  1. 以下のコマンドを実行して Looker ファイルを解凍します。 
unzip <Insights_Lookerfiles_timestamp.zip>
  1. 以下のコマンドを実行して、Looker 初期化スクリプトを実行します。
bash insights/looker-initialization.sh -k <Public Key>

<Public Key> は、gpg --generate-key コマンドで生成されます。
:information-source: Looker のパスワードを保存するためにパスワードの入力を求められる場合があります。

📘

注

インストール中に、エラー Module yaml error: Unexpected key in data: static_context [line 9 col 3] が発生することがあります。このバグについて詳しくは、「Turn off strict validation of modulemd documents (RhBug:2004853) (ModuleMD ドキュメントの厳密な検証を無効化する)」をご覧ください。

このエラーは、Insights のインストールには影響しません。

  1. PowerShell を終了し、以下のコマンドを実行して looker.json をダウンロードします。
scp <username@hostname>:~/insights/looker.json <path-to-save-json>

<username@hostname> をユーザー名と Linux ホスト名に置き換えます。

cat /home/user/insights/looker.json を使用して内容をコピーし、Insights Windows マシンの $HOME/_insights の下に looker.json ファイルを作成して、コピーした内容を貼り付けることができます。

After initialization, a file called 'looker.key' will be created in the $HOME/_insights folder. Please do not delete this file, it will be needed for future upgrades.

Insights のインストール

📘

注:

  • v2021.10 よりも前のバージョンからアップグレードする場合、Insights の権限を持つユーザーは、新しいインストールに自動的に移行されません。必要に応じて、ユーザー移行ツールを使用して移行できます。v2021.10 へのアップグレード時にこのツールを既に使用した場合は、ユーザー移行ツールを再び実行する必要はありません。
  • Windows の表示言語が次のいずれかである場合、インストーラーではその言語が使用されます: en-US、fr-FR、de-DE、es-ES、es-MX、ja-JP、ko-KR、pt-BR、pt-PT、ru-RU、tr-TR、zh-CN。Windows の表示言語がこれら以外の言語である場合、インストーラーでは英語が使用されます。

  1. コマンド プロンプトまたは PowerShell コンソールを使用して、InsightsInstaller.msi インストーラーを管理者として実行します。

  2. .msi インストーラーが格納されているディレクトリに移動します。

  3. 次のコマンドを使用して Insights インストーラーを実行します。

msiexec /i InsightsInstaller.msi

または、次のコマンドを実行します。

.\InsightsInstaller.msi
  1. Insights インストーラーによって前提条件が確認されます。前提条件がすべて満たされている場合は、UiPath Insights セットアップ ウィザードが表示され、Insights のインストールと構成についての説明が表示されます。
612

📘

注:

インストールに失敗した場合、またはインストール ログを確認する場合は、%temp% フォルダーまたは %temp%/<sessionID> フォルダーに移動して、最新の MSI{random chars}.LOG を確認します。このディレクトリ内のファイルは永続的ではなく、セッション間で失われる可能性があります。事前定義されたログの場所でインストールを実行するには、以下のコマンドを入力します。

msiexec -I "InsightsInstaller.msi" -L*V  c:\logs\interactive.log
  1. ライセンス契約に同意し、[次へ] をクリックします。
494
  1. Linux ホスト上で Looker 初期化スクリプトを実行すると、インスタンスの構成を含む JSON ファイルが出力されます。Windows ホストでそのファイルを保存した場所のフル パスを入力してください。
495
  1. Insights Windows マシンの設定を、次のように入力します。
  • Insights サーバー URL - Insights Windows マシンのホスト名または URL です。
  • ポート - Insights Windows マシンとの通信を有効化するために使用するポートです。既定のポート番号は 443 に設定されています。
  • 証明書 - Insights との接続のセキュリティ保護に使用する SSL 証明書のサブジェクトまたは拇印です。
495
  1. Orchestrator の設定を次のように構成します。
  • Orchestrator URL - Orchestrator の URL です。
  • Installation Token - enter the Installation Access Token you generated on Identity Server's Installation Access Token page by logging in as the host tenant. For more details, see Host administration portals.
  • 個別の Identity Server - 個別の Identity Server がある場合は、このチェックボックスをオンにします。

📘

注:

インストールするたびに、新しいインストール アクセス トークンが必要です。トークンの有効期間は 2 時間です。インストールに失敗した場合は、新たなトークンを生成します。

495
  1. Insights データベースの設定を次のように構成します。
  • サーバー名 - Insights データベースがある SQL Server マシンの名前です。これには、SQL Server の既定のリッスン ポート (1433) が含まれます。例: SQLServer,1433
  • データベース名 - Insights データベースの名前です。
  • 認証の種類 - 次のいずれかの認証方法を選択します。
    You must use the fully qualified domain name for the database (e.g., mysever.my.domain instead of myserver). Preferably the SQL Server must join the AD domain directly.
    • Windows Authentication - if selected, Insights connects to the database, creates tables, and runs the IIS Application Pool using the specified credentials. The installer validates the connection using the Windows credentials you are currently logged in with. If you select this option, you must specify the domain, username, and password.
    • SQL Authentication - if selected, the connection is made using SQL authentication. If using this option, the Username and Password fields become editable, and you must provide the SQL username and password used to connect to the database.
495

🚧

重要

セキュリティのため、SMTP の認証はサポートされていません。手順 10 で認証の詳細情報を入力する必要があります。

  1. メールの設定を次のように構成します。
  • メール サービス (SMTP) を設定 - オンにすると、メール サービスを設定できます。
    • サーバー - SMTP のホスト名です。
    • 送信元 - メール メッセージの送信元となるメール アドレスです。
    • ユーザー名 - 認証が必要な場合の SMTP サーバーのユーザー名です。たとえば Gmail を使用している場合は、メッセージの送信に使用するメール アドレスをこのフィールドに入力します。
      認証なしの SMTP は今後サポートされなくなる可能性があるため、認証付きの SMTP の使用を検討してください。
    • パスワード - メール アカウントのパスワードです。
    • ポート - SMTP ポートです。
    • TLS/SSL - オンにすると、TLS/SSL が有効化されます。
      * TLS/SSL バージョン - [TLS/SSL] をオンにした場合にのみ表示されます。TLSv1_1 と TLSv1_2 から選択します。
495

📘

注:

この手順が完了すると、SMTP サーバーの詳細設定を使用してメールが送信されます。これは、SMTP の詳細設定が正しいことを確認するために行われます。この手順でエラーが発生した場合は、ログ ファイルを確認し、「トラブルシューティング」ページをご確認ください。

  1. [次へ] をクリックしてインストールを開始します。インストール プロセスが完了したら、[閉じる] をクリックしてインストーラーを終了します。
495

 

インストール後の手順

テーブルを移行する

Jobs テーブルを移行するには、以下の手順を実行します。

📘

注:

2022.10 にアップグレードする際には、この手順が必要です。詳細については、「長期実行のワークフローのサポート」をご覧ください。

  1. JobOrganizationUnitId を入力します。
with CTE as (
select qie.[JobOrgUnitFullyQualifiedName] as qOrgName, qie.[JobOrganizationUnitId] as qOrgId, j.[OrganizationUnitId] as jOrgId, j.[OrgUnitFullyQualifiedName] as jOrgName
from [dbo].[QueueItemEvents] qie 
inner join [dbo].[QueueItems] qi on qie.[QueueItemId] = qi.[Id]
inner join [dbo].[Jobs] j on qi.[ExecutorJobId] = j.[Id]
where j.[OrganizationUnitId] != qie.[JobOrganizationUnitId] or (qie.[JobOrganizationUnitId] is null and j.[OrganizationUnitId] is not null))
update CTE
set qOrgName = jOrgName, qOrgId = jOrgId;
  1. 長期実行ワークフローのインデックスが存在しない場合は、インデックスを作成します。
    注: このスクリプトを以前に使用した場合、もう一度実行する必要はありません。
IF NOT EXISTS(SELECT * FROM sys.indexes WHERE Name = 'IX_JobEvents_JobId_TenantId' and OBJECT_NAME(object_id) = 'JobEvents')
CREATE NONCLUSTERED INDEX [IX_JobEvents_JobId_TenantId] ON [dbo].[JobEvents]
(
    [JobId] ASC,
    [TenantId] ASC
)
  1. read テーブルを切り捨てて、新しいフィールドをバックフィルします。
truncate table [read].[QueueItemEvents];
truncate table [read].[QueueItems];
truncate table [read].[Jobs];
truncate table [read].[JobEvents];
delete [dbo].[IngestionMarkers] where [IngestionEventType] in (9002, 9001);

適切なライセンスを確認する

You need to have at least one license code, which will include Orchestrator, Insights, and one Robot, all of them at the Host level, attached in Orchestrator (see Manage Host Licensing).

テナントの有効化

After installing Insights, you must then enable Insights for your desired tenant(s) from the Orchestrator host portal. For more details, see Enabling or disabling features.

Insights のサービスを検証する

  1. サポート対象の Web ブラウザーを開きます。
  2. https://hostname:443/Insights に移動して、Insights が正常にインストールされたことを確認します。

Insights を変更する

インストールを変更またはアンインストールできるよう、元のインストール ファイルは保存しておきます。

For more information, see Modifying Insights configurations.

関連ドキュメント

約 1 か月前に更新

インストール

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

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