アップグレード

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 2022.10 requires a Windows machine and a Linux machine with RHEL.
• お客様が 4 月のリリースより前のバージョン (23.10.3、23.4.6 など) で GPG キーを使用している場合は、初期インストールを実行したのと同じアカウント/ユーザーを使用してアップグレードするか、新規インストールを実行する必要があります。

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

注:

Review hardware and software requirements.

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

If you have a large database, consider manually indexing the Robot Logs using a script. Consider doing the same for the ProcessingExceptionDetails and HostMachineName columns. The installation might fail during the Insights Database migration if it has to index a large set of data.

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

v2021.4 以前のバージョンから v2022.10 にアップグレードする

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

注:

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

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

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

v2021.10 から v2022.10 にアップグレードする

注:

If you upgrade from 2021.10.0, export the Looker volumes using the LookerPreInstallationTool and import them during the Looker initialization, to migrate your dashboards from the old Insights Machine to the new one. When upgrading from 2021.10, you also need to truncate the Raw Message column in your database table.

タスク	説明
1. 機能比較を確認する	Review the 2022.10 cheat sheet for functionality and feature comparisons from previous product versions before upgrading to 2022.10.
2. ユーザーを移行する	v2021.10 よりも前のバージョンからアップグレードする場合、Insights の権限を持つユーザーは、新しいインストールに自動的に移行されません。必要に応じて、ユーザー移行ツールを使用して移行できます。 v2021.10 へのアップグレード時にこのツールを既に使用した場合は、ユーザー移行ツールを再び実行する必要はありません。
3. (ダッシュボードの移行) LookerPreInstallationTool を実行して Looker のボリュームをエクスポートする	When upgrading your Looker on the Insights Linux Machine, run the preinstallation tool from the Insights Windows Machine to generate a ZIP file. Use the same procedure to run the Looker-initialization.sh script. Make sure to export your Looker data (dashboards, views, and app settings), in Step 6 of the Looker Preinstallation tool section, to migrate your dashboards to the Insights Linux Machine.
4. Install the new Insights version on a separate machine from the existing installation	Insights のインストール手順に従って、別のマシンに Insights をインストールします。 新しいマシンに最新バージョンの Insights をインストールすると、古いデータの取り込みが停止します。
5. 古いバージョンの Insights をアンインストールする	新しくインストールするバージョンの Insights で新しいカスタム ダッシュボードと式の作成が完了したら、古いバージョンを安全にアンインストールできます。

v2022.4 から v2022.10 にアップグレードする

1. Open the UiPath Insights installation package and proceed through the license agreement. When you get to Orchestrator Settings, paste the installation token in the Identity Installation Token. You can generate the installation token through UiPath Identity Management by logging in as the host tenant.

   

2. [アップグレード] をクリックして続行し、データベースをバックアップしたことを確認します。これでマシンに Insights がインストールされます。

3. To complete the upgrade, follow the steps from Insights Installation.

関連ドキュメント

• Insights のサービスを検証する
• Insights の構成を変更する