UiPath Installation and Upgrade

The UiPath Installation and Upgrade Guide



You can upgrade Insights to the latest version using the installation package.



Make sure that you keep Insights enabled until you complete the installation of the new version (e.g., v2021.10) and finish creating your custom formulas and dashboards. For more information, see Considerations when uninstalling and reinstalling Insights.


Before you start the upgrade process, take a look at the following items and take action based on your upgrade scenario:



Review system requirements

Hardware and Software Requirements

Database backup

Make sure you back up your database.

Get disabled tenants data from previous installations (for upgrades to 2021.10 only)

If you need to report on data from disabled tenants, make sure to enable them first via the Insights Admin Tool.

You can only get this data before starting the upgrade process on both Orchestrator and Insights. Historical data on disabled tenants is not available post-upgrade.

Review feature comparison when upgrading to version 2021.10

2021.10 Upgrade Cheat Sheet.

Considerations when uninstalling and reinstalling Insights

To upgrade to a new version of Insights, you need to install the most recent version, and then uninstall the old one. Consider the following action items when you uninstall and reinstall Insights:

  • Both the Orchestrator and Insights versions need to match. For example, if you have upgraded Orchestrator to 2021.10.1, you need to run the same 2021.10.1 version of Insights to establish proper communication between the two UiPath products.
  • Insights database needs to point to the same database used by Orchestrator.
  • Install the new Insights version on a separate server from the existing installation.
  • Make sure you point Orchestrator to the new Insights server location. For this step, you need to provide a new Identity Installation Token. You can generate the installation token through UiPath Identity Management by logging in as the host tenant.
  • After you have installed the new version of Insights, your dashboards on the old Insights server will still be available.
    Keep in mind that the old Insights version is not going to be available through Orchestrator, after you set up a connection for the new version.
    You can use these dashboards to create your custom formulas and dashboards in your new version of Insights, however no new data will flow to these dashboards.
  • Once you are satisfied with your new custom dashboards and formulas, you can uninstall the old version of Insights.



After installing the new version of Insights, data will no longer flow to your previous installation.

Following an upgrade, you will need to re-enter the data to the ROI Dataset.

Upgrade from version 2021.10 to 2021.10.1

In this upgrade scenario, you might encounter the following IIS error:

You can click Ignore as it won't obstruct the Insights installation.

Related articles

Updated about 17 hours ago


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.