- リリース ノート
- 基本情報
- アクセスと権限
- インストールとアップグレード
- Insights を操作する
- 履歴データのエクスポート
- ログ
- パフォーマンスとスケーラビリティ
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 2023.4 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 がサポートするバージョンと同じです。
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 以前のバージョンから v2023.4 にアップグレードする
| タスク | 説明 |
|---|---|
| 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と、インストール時に設定したものと同じ管理者アカウントを使用できます。
古いビルドを無効化するには、以下の手順に従います。
- 古い URL (
https://<old Insights url>/app/account/login) にログインします。 https://<old Insights url>/app/dataに移動します。- 各キューブの 3 点リーダー メニューのアイコンをクリックし、作成スケジュールに移動して作成を無効化します。
v2021.10 から v2023.4 にアップグレードする
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.
The default nlog rule has changed. To find out more details check Default Log Rules for Versions 2022.4 and higher page.
| タスク | 説明 |
|---|---|
| 1. 機能比較を確認する | Review the 2023.4 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 で新しいカスタム ダッシュボードと式の作成が完了したら、古いバージョンを安全にアンインストールできます。 |
2022.4 または 2022.10 から 2023.4 にアップグレードする
アップグレードの手順
Insights を新しいバージョンにアップグレードする前に、以下の点を確認してください。
- 必要に応じて Orchestrator のバージョンを確認し、アップグレードします。Orchestrator と Insights は同じバージョン (例:Orchestrator バージョン 2022.10 および Insights バージョン 2022.10)。同じバージョンを使用しない場合はアプリケーションのパフォーマンスに影響します。Orchestrator のインストール方法については、現在のバージョンを更新する場合は「インストールについて」と「更新について」をご覧ください。
- MSI パッケージとpreinstallationtool.exeをダウンロードし、バージョンが一致していることを確認します。(例: Orchestrator バージョン 2022.10、 preinstallationtool for Insights v2022.10)。 Customer Portal >製品のダウンロード ページを確認して必要なファイルをダウンロードするか、サポート チームにお問い合わせください。
アップグレード プロセスを開始するには、次の手順に従います。
- UiPath Orchestrator のメジャー バージョンを Insights のメジャー バージョンと一致するようにアップグレードします。
- MSI パッケージと preinstallationtool.exe をダウンロードします。Customer Portal > 製品のダウンロード ページを確認して必要なファイルをダウンロードするか、サポート チームにお問い合わせください。
- preinstallationtool を実行し、要求される情報 (Linux ホスト名、証明書の拇印など) を入力します。
- preinstallationtool によって生成されたファイルを Linux 仮想マシンにコピーします。
- ファイルを解凍し、次のコマンドを実行します。
bash Insights_looker_’unzipfile’docker ps を使用すると、コンテナーが実行されているかどうかを確認できます。bash コマンドを実行するとファイルが生成されます。 - 生成されたファイルを Windows 仮想マシンにコピーします。
- Insights の MSI を実行します。