Insights

デリバリー:

最終更新日時 2025年10月29日

アップグレード

Insights の新しいバージョンにアップグレードするには、アップグレードのシナリオに応じて以下の手順に従う必要があります。

重要:

Please note that this is a change from our HW/SW specs from Insights 2021.10. Insights 2021.10 requires a single Windows machine, while Insights 2025.10 requires a Windows machine and a Linux machine with RHEL.

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 がサポートするバージョンと同じです。

注:「ハードウェアおよびソフトウェアの要件」を確認してください。

データベースが大きい場合は、スクリプトを使用して手動でロボットログのインデックスを作成することを検討してください。同じ作業を ProcessingExceptionDetails と HostMachineName の列に行うことを検討してください。大きなデータセットのインデックスを作成する必要がある場合、Insights データベースの移行中にインストールが失敗することがあります。

アップグレードのシナリオ

Upgrade From 2021.4 or Earlier Version to 2025.10

タスク	説明
1. ユーザーを移行する	v2021.10 よりも前のバージョンからアップグレードする場合、Insights の権限を持つユーザーは、新しいインストールに自動的に移行されません。必要に応じて、ユーザー移行ツールを使用して移行できます。
2. 既存のインストールとは別のマシンに新しいバージョンの Insights をインストールする	Insights のインストール手順に従って、別のマシンに Insights をインストールします。新しいマシンに最新バージョンの Insights をインストールすると、古いデータの取り込みが停止します。
3. 古いバージョンの Insights をアンインストールする	新しくインストールするバージョンの Insights で新しいカスタムダッシュボードと式の作成が完了したら、古いバージョンを安全にアンインストールできます。

注:

ダッシュボードの移行中は、Insights の新旧両方インストールが同じデータベースを使用します。
Insights にログインするには、古い URL https://<old Insights url>/app/account/login と、インストール時に設定したものと同じ管理者アカウントを使用できます。

古いビルドを無効化するには、以下の手順に従います。

古い URL (https://<old Insights url>/app/account/login) にログインします。
https://<old Insights url>/app/data に移動します。
各キューブの 3 点リーダーメニューのアイコンをクリックし、作成スケジュールに移動して作成を無効化します。

Upgrade From 2021.10 to 2025.10

注: v2021.10.0 からアップグレードする場合は、LookerPreInstallationTool を使用して Looker のボリュームをエクスポートし、Looker の初期化中にそれをインポートすることによって、古い Insights マシンから新しいマシンにダッシュボードを移行します。2021.10 からアップグレードする場合は、データベーステーブルの Raw Message 列も切り捨てる必要があります。

既定の nlog ルールが変更されました。詳しくは、「バージョン 2022.4 以降の既定のログルール」をご覧ください。

タスク	説明
1. 機能比較を確認する	アップグレードする前に、アップグレードのチートシートで以前の製品バージョンとの機能比較をご確認ください。
2. ユーザーを移行する	v2021.10 よりも前のバージョンからアップグレードする場合、Insights の権限を持つユーザーは、新しいインストールに自動的に移行されません。必要に応じて、ユーザー移行ツールを使用して移行できます。 v2021.10 へのアップグレード時にこのツールを既に使用した場合は、ユーザー移行ツールを再び実行する必要はありません。
3. (ダッシュボードの移行) LookerPreInstallationTool を実行して Looker のボリュームをエクスポートする	Insights Linux マシンで Looker をアップグレードする場合は、Insights Windows マシンからプレインストールツールを実行して ZIP ファイルを生成します。Looker-initialization.sh script スクリプトを実行するのと同じ手順を使用します。 Looker プレインストールツールに関する、こちらのセクションの手順 6 に従って Looker のデータ (ダッシュボード、ビュー、アプリの設定) をエクスポートし、ダッシュボードを Insights Linux マシンに移行できるようにします。
4. 既存のインストールとは別のマシンに新しいバージョンの Insights をインストールする	Insights のインストール手順に従って、別のマシンに Insights をインストールします。新しいマシンに最新バージョンの Insights をインストールすると、古いデータの取り込みが停止します。
5. 古いバージョンの Insights をアンインストールする	新しくインストールするバージョンの Insights で新しいカスタムダッシュボードと式の作成が完了したら、古いバージョンを安全にアンインストールできます。

Upgrade From 2022.4, 2022.10, 2023.4, 2023.10, or 2024.10 to 2025.10

アップグレードの手順

Insights を新しいバージョンにアップグレードする前に、以下の点を確認してください。

Check and upgrade Orchestrator version if needed. It's recommended for Orchestrator and Insights to be on the same version (Ex. Orchestrator version 2025.10 and Insights version 2025.10). Not having the same version impacts the application performance. To find out how to install Orchestrator check About Installation and About Updating if you wish to update your current version.
Have the MSI package and preinstallationtool.exe downloaded and make sure it matches between versions.(Ex. Orchestrator version 2025.10, preinstallationtool for Insights version 2025.10). Check the Customer Portal > Product download page to download the required files or ask the support team.

アップグレードプロセスを開始するには、次の手順に従います。

UiPath Orchestrator のメジャーバージョンを Insights のメジャーバージョンと一致するようにアップグレードします。
MSI パッケージと preinstallationtool.exe をダウンロードします。Customer Portal > 製品のダウンロードページを確認して必要なファイルをダウンロードするか、サポートチームにお問い合わせください。
preinstallationtool を実行し、要求される情報 (Linux ホスト名、証明書の拇印など) を入力します。
preinstallationtool によって生成されたファイルを Linux 仮想マシンにコピーします。
プレインストールツールからインストールディレクトリに zip ファイルを解凍します。
1. 親ディレクトリを見つけます: dirname $(sudo docker inspect looker-container | jq -r '.[0].HostConfig.Binds' | grep 'deploy' | awk -F':/app/.deploy:Z' '{print $1}' | awk -F'"' '{print $2}')
2. そのディレクトリに解凍します: unzip <looker zip file> -d <parent dir>
looker-initialization.sh スクリプトを実行します。 bash insights/looker-initialization.sh です。
生成されたファイルを Windows 仮想マシンにコピーします。
Insights の MSI を実行します。