Moving Orchestrator Server To A New Environment

How to move Orchestrator server to a new environment?

For Orchestrator version 20.4 and above :

Follow the below steps to set up the Orchestrator in new environment.

  1. Do a fresh installation of same version of Orchestrator in new VM
  2. Restore the old DB
  3. Now point the new orchestrator to old DB by changing the connection string in below 3 files
  • UiPath.Orchestrator.dll.config
  • appsettings.production.json file present in Identity folder
  • appsettings.production.json file present in Webbooks folder
  1. Update the encryption key present in UiPath.Orchestrator.dll.config present in new instance with the old one
  2. Regarding the license, the new instance will get licensed as soon as it points to the old DB.

For Orchestrator version 19.10 and below:

  1. Do a fresh installation of same version of Orchestrator in new VM
  2. Restore the old DB
  3. Copy the web.config from older instance and replace it with the web.config of new instance. Take a backup of new instance web.config before that
  4. Then change the connection string accordingly in the web.config.

Regarding the license, the new instance will get licensed as soon as it points to the old DB.

Note: As soon as the new instance is ready and tested please decommission the old instance as same license should not be used in different instances.

A post was split to a new topic: Why procedure for Orchestrator versions above 20.4 miss the appsettings.production.json of the “ResouceCatalog” service in the “ResourceCatalog” folder?