Subscribe

UiPath Installation and Upgrade

The UiPath Installation and Upgrade Guide

Updating the Robot

Before you proceed with updating the Robot, we highly recommend checking out the compatibility matrix.

It is usually recommended to first upgrade your Orchestrator and then your Robots. In this scenario, the Robots have to be reconnected to Orchestrator after the update.

Regardless of the version you want to update from, you need to take into consideration how the Robot was installed, in Service Mode or in User Mode.

As a general rule, we advise you to have the same Robot, Studio, and Orchestrator, so that you can take advantage of all the latest features. Studio and Robot must have the same version.

The installation artifacts are provided when you first purchase Robot or they can be provided by your customer success manager or our support team.

📘

Note:

If both Studio and Robot are on the same machine, you have to upgrade them at the same time, regardless if the Robot was installed in Service Mode or in User Mode.

It is possible to update Robot either by using the UiPathPlatform.exe installer, or the UiPathStudio.msi, but please keep in mind that the .exe does not accept command line arguments. Additionally, UiPathPlatform.exe also enables you to update Orchestrator.

Regardless of how you choose to update the Robot, the connection to Orchestrator is kept intact, so you don’t have to provision or connect it again.

You can always check the Robot version from the Tray or in Orchestrator.

📘

Important:

Remember to properly migrate your processes when updating the 2018.3 UiPath Platform. The dependencies and activities installation algorithm has improved, which can cause conflicts when executing processes with packages installed from local feeds. If you encounter any issues while updating, check out possible solutions on this page. Also, remember to check out how to Open Projects Created with Previous Versions.

Service Mode Robot

If your Robot was previously installed in Service Mode and want to update it, run UiPathPlatform.exe or UiPathStudio.msi. Executing one of these installers automatically replaces all the old files without modifying any of your settings.

Please keep in mind that, upon upgrade, the activities packages are cumulated in the C:\Program Files (x86)\UiPath\Studio\Packages folder. Find out more about managing dependencies.

To update the Service Mode Robot from the command line use the following command: UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterService.

User Mode Robot

Updating the User Mode Robot is possible through the UiPathStudio.msi installer, its command line arguments, or by using the Community Edition installer (UiPathStudio.exe).

If your previous version of Robot is installed with the aforementioned Community installer, it is always up to date, on the chosen channel - Stable or Beta. More information on this installer is available here.

Please note that the Robot’s connection to Orchestrator is lost if it is installed with the Community edition installer (UiPathStudio.exe) and during the update process you close Studio. This issue does not reproduce on UiPathStudio.exe installations that are licensed.

To update the User Mode Robot from the command line use the following command: UiPathStudio.msi ADDLOCAL=DesktopFeature,Robot,RegisterUserModeService

Robot Deployment Conversion

When updating the Robot, you can also switch it from Service Mode to User Mode, or vice versa. This is only possible through the UiPathStudio.msi.

📘

Note:

When updating the configuration variables, the Robot has to be restarted for changes to take effect. However, when updating the following settings in Orchestrator, a restart is not needed:

  • RunDisconnectedHours

  • SignalR settings (including on/off)

  • HeartbeatPeriodSeconds

  • NuGet feeds

Updated 2 months ago


Updating the Robot


Suggested Edits are limited on API Reference Pages

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