インストール

重要:

このページの情報は、Insights v2021.10 の公開後に HW/SW の仕様に関して発生した変更です。Insights v2021.10 では Windows マシンが 1 台必要ですが、Insights v2024.10 では Windows マシンと RHEL の 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 がサポートするバージョンと同じです。サポート対象外のバージョンの RHEL へのインストールはブロックされるため、サポート対象のバージョンに更新する必要があります。サポート対象のバージョンを確認するには、「 オペレーティング システム 」をご覧ください。

重要:

Insights を /tmp フォルダーにインストールしないでください。再起動後に問題が発生する可能性があります。インストールは、永続ディレクトリで実行する必要があります。

注:

Orchestrator と Insights の両方のメジャー バージョンが一致している必要があります。たとえば、v2024.10.X の Orchestrator にアップグレードした場合は、v2024.10.X の Insights を実行する必要があります。こうすることで、これらの 2 つの UiPath 製品間で適切な通信が確立されます。また、Insights は常に最新バージョンにアップグレードする必要があります。たとえば、Orchestrator のバージョンが 2024.10.0 の場合でも、Insights を利用可能な最新バージョン 2024.10 に更新することをお勧めします。

注:

マルチノードのインストールはサポートされていませんが、インストール後に、マルチノードの Orchestrator の既存のインストールで Insights を有効化できます。

概要

スタンドアロンの Insights v2024.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 マシンにインストールする必要があります。 Windows マシンと Linux マシンの両方が HTTPS 要求を処理します。そのため、どちらも HTTPS 接続に証明書を利用します。前提条件として、Linux サーバーに対して有効な証明書と Windows マシンに対して有効な証明書が必要です。

ステップ 2

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

重要:

• Insights SQL マシンの構成時にデータベース所有者のロールを追加するには db_owner ロールが必要であるため、必ずこのロールを選択してください。
• Orchestrator と Insights の両方のメジャー バージョンが一致している必要があります。たとえば、v2025.10.X の Orchestrator にアップグレードした場合は、v2025.10.X の Insights を実行する必要があります。こうすることで、これらの 2 つの UiPath 製品間で適切な通信が確立されます。また、Insights は常に最新バージョンにアップグレードする必要があります。たとえば、Orchestrator のバージョンが 2025.10.0 の場合でも、Insights を利用可能な最新バージョン 2025.10 に更新することをお勧めします。
• Insights データベースは、Orchestrator のインストール中に Insights を有効化した際に作成されたデータベースをポイントする必要があります。
• データベースが大きい場合は、SQL スクリプトを使用して手動でインデックスを追加することを検討してください。大量のデータのインデックスを作成する必要がある場合、Insights データベースの移行中に Orchestrator のインストールが失敗することがあります (「 インストール中にデータベースの移行が失敗する」をご覧ください)。

Linux マシンを準備する

AWS EC2 Linux マシンを準備する

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

1. インスタンスの起動を開始します。
2. Red Hat Enterprise Linux 8 イメージの選択
   注:

   バージョン 8.2、8.4、8.6 がサポートされています。8.8、9.1、および 9.2 のサポートは 8 月のパッチから利用可能であり、(23.4.2+、22.10.5+、など。

3. インスタンスの種類を選択し、インスタンスの詳細を設定します。
4. インスタンスにストレージを追加し、サイズを 32 に変更します。
5. インスタンスを確認して起動する 詳しくは、「 AWS でインスタンスの起動を開始する」をご覧ください。

注:

スクリプトは Sudo を使用して初期化を行いますが、Linux ホストが Sudo の代わりに dzdo を使用する場合はスクリプトも dzdo を使用します。

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

Amazon Elastic Compute Cloud のドキュメントの指示に従って、以下の表に示された受信ポートを開きます。

入力	ポート範囲	ソース	説明
カスタム TCP	9999	Anywhere-IPv4	これは Looker のポートです。
カスタム TCP	19999	Anywhere-IPv4	これは Looker API のポートです。
カスタム TCP	29999	Anywhere-IPv4	これは、LookML の更新のポートです。

Microsoft Azure Linux 環境を準備する

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

1. [サービス] > [仮想マシン] > [作成]に移動します。

2. [See all images] に移動し、[Plan] から [Red Hat Enterprise Linux 8.2 - 8.6、または 9.0] を選択します。オフラインの RHEL バンドルが必要な場合は、 こちらのダウンロード リンクを選択してください。

   

3. 管理者アカウントで、[SSH 公開キー] または [パスワード] のどちらかを選択します。SSH 公開キーを使用する場合は、キーを生成して、[Azure に格納されている既存のキーを使用] を選択します。

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

以下の表に示された受信ポートを開くには、 Azure のドキュメントの手順に従ってください。

宛先ポート範囲	名前	優先度	ソース
9999	Looker_Port	310	すべて
19999	LookerAPI_Port	320	すべて
29999	LookMLUpdate_Port	330	すべて

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

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

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

重要:

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

1. 以下のコマンドを実行して、Linux マシンで SSH クライアントを開きます。

   ssh azureuser@<your-hostname>
   

マシンのホスト名を反映するように <your-hostname> を調整する必要がある場合。2. 以下のコマンドを実行してrootユーザーに変更します。

sudo -i

3. 以下のコマンドを実行してディスク サイズを確認します。

   lsblk -f
   

/varマウントポイントは sda2 > rootvg-varlv. という名前で表示されます。4. 次のコマンドを実行して、/dev/sda2のサイズを確認します。

lsblk /dev/sda2

ここで、 /dev/sda2 は手順 3 から取得されます。これで、 /var のサイズがわかりますが、これは8Gです。

5. 次に、次のコマンドを実行して、利用可能なスペースを確認します。

vgdisplay rootvg

無料の PE / サイズは約 40 GiB になります。6. 次のコマンドを実行して、rootvg-varlvのサイズを大きくします。

このサイズは、たとえば +10G や、それ以外の値にも変更できます。この値は、利用可能な 40GB (手順 5 で確認する空きメモリのサイズ) よりも小さい値にします。

lvresize -r -L +10G /dev/mapper/rootvg-varlv

注:

エアギャップ インストールの場合は、 /homeで同じコマンドを実行します。

7. 次のコマンドを実行して、サイズ変更が成功したかどうかを確認します。

lsblk /dev/sda2

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

注:

エアギャップ環境の場合は、手順 1 から 6 のコマンドを実行して /home のサイズを大きくし、オフライン イメージとパッケージ バンドルのための十分な領域を確保します。

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

1. ハードウェアおよびソフトウェアの要件を満たす Windows マシンを構成します。
2. 既定の受信ポート 443を開きます。AWS で受信ポートを開く方法については、「 Linux インスタンス用のインバウンドトラフィックの承認」をご覧ください。Azure で受信ポートを開く方法については、「 チュートリアル: Azure portal を使用してネットワーク セキュリティ グループでネットワーク トラフィックをフィルター処理する」をご覧ください。
3. Run the Install-Prerequisites.ps1 script to Enable IIS 10+, install .NET 6.0.5+, and then restart the IIS service. Alternatively, you can manually install the prerequisites highlighted in the sub-steps below: a. Open an RDP session in the created machine to install the prerequisites. b. Enable IIS 10+.

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

役割と機能の追加ウィザードが開きます。ウィザードに従って、Web サーバー (IIS) を有効にします。次の Web サーバー (IIS) モジュールを有効にします: * Web サーバー + 一般的な HTTP 機能 - 既定のドキュメント - ディレクトリの参照 - HTTP エラー - 静的コンテンツ + 正常性と診断 - HTPP ログ + パフォーマンス - 静的コンテンツ + セキュリティ - 要求のフィルター処理 * 管理ツール + IIS 管理コンソール 3. .NET ホスティング バンドルのバージョン 6.0.7+ をダウンロードしてインストールします。4. PowerShell で次のコマンドを実行します。 net stop was /y ; net start w3svc 4.SSL 証明書を使用して、マシンで HTTPS を有効化します。Orchestrator と同様の手順に従って、証明書を準備します。詳しくは 、「証明書を使用して HTTPS プロトコルを有効化 する」をご覧ください。5.Insights のホスト名を指定する場合は、目的のホスト名が DNS 内で解決できることを確認してください。6. TLS 1.1 または 1.2 を使用してください。

SQL Server 構成

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

注:

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

注:

AAD 認証は、Microsoft SQL データベースではサポートされていません。

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 認証

Windows 統合認証

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

重要:

Windows 認証を有効化するには、SQL Server で Kerberos プロトコルを使用した認証がサポートされている必要があります。SQL Server で Kerberos 認証を有効化する方法について詳しくは、「 SPN の手動登録」をご覧ください。

次のコマンドを実行して、Windows マシン上の SPN を確認します。

setspn -Q MSSQLsvc/<server name>:port

次のコマンドを実行して SPN を設定します。

setspn -S MSSQLsvc/<FQDN server name>:port [domain\<SQL service account>

注:

任意で、 サービス アカウントを SPN として使用できます。これは、SQL Server サービスの実行に使用されているアカウントである必要があります。

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 認証] オプションを選択します。ウィンドウが適切に更新されます。

   

4. [ログイン名] フィールドに、サービス アカウントとして使用するユーザー ドメインを入力します。

5. [既定の言語] リストから [English] を選択します。

   重要:

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

6. [ OK ] を選択して設定を保存します。サービス アカウントが既に作成済みで、SQL Server の [Security > Logins ] セクションに追加されている場合は、その SQL アカウントの [既定の言語] が英語に設定されているかどうかを確認します。そうでない場合は、必要な調整を行う必要があります。

SQL Server 認証

この認証方法では、SQL Server ユーザーが必要です。

重要:

セキュリティ上の理由から、非 SA (非システム管理者) アカウントの使用を検討してください。

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

1. [オブジェクト エクスプローラ] パネルで [セキュリティ] > [ログイン] に移動します。

2. [ログイン] フォルダーを右クリックして [新しいログイン] を選択します。[ログイン - 新規作成] ウィンドウが表示されます。

3. [SQL Server 認証] オプションを選択します。ウィンドウが適切に更新されます。

   

4. [ログイン名]、[パスワード]、[パスワードの確認入力] の各フィールドに適切な値を入力します。

5. [パスワードの期限を適用する] と [ユーザーは次回ログイン時にパスワードを変更する] の 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 の [ セキュリティ >ログイン ] セクションに追加されている場合は、[ 既定の言語 ] が英語に設定されているかどうかを確認します。そうでない場合は、必要な調整を行ってください。

権限

SQL Server に接続するユーザーの種類 (ドメインまたは SQL) に関係なく、Insights をインストールする前にユーザーにdbcreatorサーバー ロールを割り当てる必要があります。データベースがこのインストール処理中に作成されるためです。

セキュリティ上の制約によりサービス アカウントで dbcreator Server ロールの使用が許可されない場合は、SQL Server に空のデータベースを作成します。

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

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

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 機能を有効化する必要があります。

v2021.10 より後のバージョンで Orchestrator と Insights を新規にインストールする か 、Insights を既存の Orchestrator インストールに追加する場合は 、「Orchestrator のシングル ノードのインストールの手順 3」をご覧ください。

注:

マルチノードのインストールはサポートされていませんが、インストール後に、マルチノードの Orchestrator の既存のインストールで Insights を有効化できます。

Azure に App Service としてインストールされた Orchestrator: Orchestrator を Azure で App Service として実行する場合は、 Orchestrator にパブリッシュするスクリプトを実行して 、 -insightsFeatureEnabled パラメーターで Insights を有効化できます。

注:

• Orchestrator と Insights の両方のメジャー バージョンが一致している必要があります。たとえば、v2025.10.X の Orchestrator にアップグレードした場合は、v2025.10.X の Insights を実行する必要があります。こうすることで、これらの 2 つの UiPath 製品間で適切な通信が確立されます。また、Insights は常に最新バージョンにアップグレードする必要があります。たとえば、Orchestrator のバージョンが 2025.10.0 の場合でも、Insights を利用可能な最新バージョン 2025.10 に更新することをお勧めします。
• 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 スクリプトは、バージョン 2023.4.0 に対応していますLookerPreinstallationTool.exe。詳しくは、「 自動デプロイ スクリプト」をご覧ください。

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

注:

v2023.4 以降は、SMTP の設定は自動的に行われますバージョン

1. LookerPreinstallationTool.exeをダウンロードし、Insights Windows マシンでツールを実行します。

   注:

   ツールのバージョンは、Orchestrator と Insights で完全に一致している必要があります。LookerPreinstallationTool の必要なバージョンをダウンロードするには、Customer Portal >製品のダウンロード ページを確認するか、サポート チームにお問い合わせください。

2. ZIP ファイルを生成するための最初の手順に従います。

3. 言語を選択します。

   重要:

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

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

   注:

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

   

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

   注:

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

6. (任意) 以前のダッシュボード、アラート、スケジュールを新しいバージョンで引き続き使用できるよう、データをエクスポートします。このツールは、マシン上で looker_container が実行されているかどうかを検出できます。データを移行すると、$Env:ProgramData\UiPath Insights に格納されている現在の Looker パスワードがエクスポートされ、新しい Insights Linux マシンで使用されます。

7. (オプション)ZIP ファイルを暗号化して Looker シークレットを保護します。手順 4 を完了した場合は、パスワードを使用して ZIP ファイルを保護することを検討してください。

   

8. 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 が無限更新ループに入る可能性があります。

2. 以下のコマンドを実行して Looker ファイルを解凍します。

   unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directory
   

Insights のインストール ディレクトリは、スクリプトが実行されるディレクトリです。したがって、ホーム ディレクトリでファイルを解凍することは避けてください。Linux の標準ディレクトリは /opt ですが、選択した場所にインストールできます。3. 以下のコマンドを実行して、Looker 初期化スクリプトを実行します。

cd <installation directory>
bash insights/looker-initialization.sh

注:

Looker のパスワードを保存するためにパスワードの入力を求められる場合があります。

注:

スクリプトは Sudo を使用して初期化を行いますが、Linux ホストが Sudo の代わりに dzdo を使用する場合はスクリプトも dzdo を使用します。

注:

インストール中に、次のエラー Module yaml error: Unexpected key in data: static_context [line 9 col 3] が表示されることがあります。このバグについて詳しくは、「 Turn off strict validation of modulemd documents (RhBug:2004853)」をご覧ください。この変更は、Insights のインストールには影響しません。

4. PowerShell を終了し、以下のコマンドを実行して looker.json をダウンロードします。

   scp <username@hostname>:~/insights/looker.json <path-to-save-json>
   

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

cat /home/user/insights/looker.json を使用して内容をコピーし、Insights Windows マシンのデプロイ ディレクトリ下に looker.json という名前のファイルを作成して、コピーした内容を貼り付けることができます。

重要:

初期化後、 $HOME/_insights フォルダに「looker.key」というファイルが作成されます。このファイルは削除しないでください。今後のアップグレードで必要になります。

注:

Looker ユーザーを作成し、デプロイ フォルダーの所有権を新しい Looker ユーザーに変更し、デプロイ フォルダーの権限を 755 に設定できます。フォルダー内のすべてのファイルには 644 の属性が設定されます。

注:

Looker では、クエリが完了していない場合に、ダッシュボードを閉じた後で SQL クエリを強制終了できます。これにより、一部のシナリオでパフォーマンスの問題を軽減できます。この機能を有効化するには、以下の SQL 権限を追加します。これは任意です。割り当て

use master
go
GRANT ALTER ANY CONNECTION TO sqladmin

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. Customer Portal からバージョンを選択してInsightsInstaller.msiをダウンロードします。
2. コマンド プロンプトまたは PowerShell コンソールを使用して、管理者としてインストーラーを実行します。
3. .msi インストーラーが格納されているディレクトリに移動します。
4. 次のコマンドを使用して Insights インストーラーを実行します。

   msiexec /i InsightsInstaller.msi
   

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

.\InsightsInstaller.msi

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

   

   注:

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

   msiexec -I "InsightsInstaller.msi" -L*V  c:\logs\interactive.log
   

6. ライセンス契約に同意し、[ 次へ] を選択します。

   

7. Linux ホスト上で Looker 初期化スクリプトを実行すると、インスタンスの構成を含む JSON ファイルが出力されます。Windows ホストでそのファイルを保存した場所のフル パスを入力してください。

   

8. Insights Windows マシンの設定を、次のように入力します。

   • Insights サーバー URL - Insights Windows マシンのホスト名または URL です。

   • ポート - Insights Windows マシンとの通信を有効化するために使用するポートです。既定のポート番号は 443 に設定されています。

   • 証明書 - Insights との接続のセキュリティ保護に使用する SSL 証明書のサブジェクトまたは拇印です。

     

9. Orchestrator の設定を次のように構成します。

   • Orchestrator URL - Orchestrator の URL です。

   • インストール トークン - ホスト テナントとしてログインし、Identity Server の [ インストール アクセス トークン ] ページで生成したインストール アクセス トークンを入力します。詳しくは、 ホスト管理ポータルについてのこちらのページをご覧ください。

   • 個別の Identity Server - 個別の Identity Server がある場合は、このチェックボックスをオンにします。

     注:

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

     

10. Insights データベースの設定を次のように構成します。

    • サーバー名 - Insights データベースがある SQL Server マシンの名前です。これには、SQL Server の既定のリッスン ポート (1433) が含まれます。例: SQLServer,1433
    • データベース名 - Insights データベースの名前です。
    • 認証の種類 - 次のいずれかの認証方法を選択します。 データベースには完全修飾ドメイン名を使用する必要があります (例: myserverドメイン名ではなく mysever.my.domain ドメイン名)。できれば、SQL Server が Active Directory ドメインに直接参加する必要があります。

      • Windows 認証 - 選択すると、Insights は指定した資格情報を使用してデータベースに接続し、テーブルを作成し、IIS アプリケーション プールを実行します。インストーラーは、ユーザーが現在のログインに使用している Windows 資格情報を使用して接続を検証します。このオプションを選択する場合はドメイン、ユーザー名、パスワードを指定する必要があります。

      • SQL 認証 - 選択すると、SQL 認証を使用して接続が行われます。このオプションを使用する場合、[ユーザー名] フィールドと [パスワード] フィールドが編集可能になるので、データベースへの接続に使用する SQL ユーザー名とパスワードを入力する必要があります。

        

        重要:

        v2022.4 の Insights では SMTP の認証はサポートされていません。2022.10、および 2023.4。

11. メールの設定を次のように構成します。

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

TLS/SSL バージョン - [TLS/SSL] をオンにした場合にのみ表示されます。TLSv1_1 と TLSv1_2 から選択します。

    :::note
    Once this step is completed, an email is sent using the SMTP server details. This is to ensure the SMTP details are correct. If there's an error during this step, please check the log file and navigate to the [troubleshooting page](https://docs.uipath.com/insights/standalone/2024.10/user-guide/insights-troubleshooting-installation#troubleshooting)
    :::

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

![Screenshot of the UiPath Insights Setup interface.](https://dev-assets.cms.uipath.com/assets/images/insights/insights-screenshot-of-the-uipath-insights-setup-interface-159931-9d44a1ad-101fc699.webp)

インストール後の手順

テーブルを移行する

注:

この手順が必要になるのは、テーブルが大きく、アップグレード中にタイムアウトが発生した場合のみです。

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

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;
   

2. 長期実行ワークフローのインデックスが存在しない場合は、インデックスを作成します。
   注:

   このスクリプトを以前に使用したことがある場合は、2 回目に実行する必要はありません。

   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
   )
   

3. 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);
   

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

少なくとも 1 つのライセンス コード (Orchestrator、Insights、および 1 台のロボットをすべてホスト レベルで含む) が Orchestrator に添付されている必要があります (「 ホスト ライセンスを管理」をご覧ください)。

テナントの有効化

Insights のインストール後は、 Orchestrator のホスト ポータルから目的のテナントに対して Insights を有効化する必要があります。詳しくは、「 機能を有効化または無効化する」をご覧ください。

Insights のサービスを検証する

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

Insights を変更する

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

詳しくは、「 Insights の構成の変更」をご覧ください。

既存のマルチノード Orchestrator でシングルノードの Insights を有効化する

既存のマルチノード UiPath Orchestrator でシングルノードの UiPath Insights を有効化するには、以下の手順に従います。

1. プライマリ ノードで UiPath Orchestrator を有効化し、パラメーター ファイルを生成します。詳しくは、「 マルチノードの Orchestrator にノードを追加する 」をご覧ください。
2. 次のコマンドを使用して、セカンダリ ノードで Orchestrator インストーラー (UiPathOrchestrator.msi) を実行します。

   UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json
         /Q
   

3. UiPath.Orchestrator.dll を交換することで、すべてのノードで整合性を確保します。 プライマリ ノードのバージョンを持つセカンダリ ノードの構成ファイル。 このファイルは C:\Program Files (x86)\UiPath\Orchestratorにあります。 置換する前にバックアップを作成することをお勧めします。
4. UiPath.Orchestrator.dllことを確認します。 構成ファイルは、置換後のすべてのノードで同一です。

関連ドキュメント

• エアギャップ環境でのインストール
• Insights をアップグレードする
• トラブルシューティング