Upgrading

To upgrade to a new version of Insights, you need to follow the steps based on your upgrading scenario.

Important:

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.
If the customer uses the GPG key for any version prior to the April release (23.10.3, 23.4.6, etc.), they must upgrade using the same account/user that performed the initial install, or they will need to do a fresh install.

In 2021.10, the Insights Windows machine ran Docker which hosted the Looker Linux container. Starting with Windows 2022, the driver used to nest the Linux containers in Windows OS (called lcow) is not supported anymore by Microsoft for enterprise applications. As a result, we had to change our deployment architecture to require two machines - one Windows machine to run the UiPath Insights components, and a Linux machine to run the Looker container. With this change, enterprise support is available from OS vendors for the components needed to run UiPath products. The supported versions of Linux OS are the same that Automation Suite supports.

Note: Review hardware and software requirements.

Both the Orchestrator and Insights versions need to match. For example, if you have upgraded Orchestrator to 2022.10, you need to run the same 2022.10 version of Insights to establish proper communication between the two UiPath products.

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.

Upgrade Scenarios

Upgrade From 2021.4 or Earlier Version to 2022.10

Task	Description
1. Migrate users	When upgrading from a version earlier than 2021.10, users with Insights permissions are not automatically migrated to your new installation. They can be optionally migrated via the User Migration tool.
2. Install the new Insights version on a separate machine from the existing installation	Follow the Insights Installation instructions to install it on a separate machine. After you install the latest Insights version on a new machine, the ingestion of old data will stop.
3. Uninstall the old version of Insights	Once you have completed the creation of the new custom dashboards and formulas on the newly installed version of Insights, you can safely uninstall the old version.

Note:

Both old and new Insights installations will use the same database while the dashboards are being moved.
To login to Insights, you can use the old https://<old Insights url>/app/account/login URL and the same admin account that was configured during installation.

To disable the old builds, follow the steps below:

Login to the old URL (https://<old Insights url>/app/account/login).
Go to https://<old Insights url>/app/data.
Click the three-dots icon on each cube and go to the build schedule to disable the builds.

Upgrade From 2021.10 to 2022.10

Note: 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.

Task	Description
1. Review feature comparison	Review the 2022.10 cheat sheet for functionality and feature comparisons from previous product versions before upgrading to 2022.10.
2. Migrate users	When upgrading from a version earlier than 2021.10, users with Insights permissions are not automatically migrated to your new installation. They can be optionally migrated via the User Migration tool. If you already used the tool when upgrading to 2021.10, you do not have to re-run the user migration tool again.
3. (Dashboard migration) Run LookerPreInstallationTool and export Looker volumes	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	Follow the Insights Installation instructions to install it on a separate machine. After you install the latest Insights version on a new machine, the ingestion of old data will stop.
5. Uninstall the old version of Insights	Once you have completed the creation of the new custom dashboards and formulas on the newly installed version of Insights, you can safely uninstall the old version.

Upgrade From 2022.4 to 2022.10

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.
Click Upgrade to continue and confirm if you have backed up your database. Insights will be installed on your machine.
To complete the upgrade, follow the steps from Insights Installation.