Backup Configuration Files and NuGet Packages

Backing up your Orchestrator configuration and NuGet packages requires copying the relevant files and folders to your designated backup location. This page provides the details needed to identify and locate those files and folders you must copy.

Orchestrator Web.config and UiPath.Orchestrator.dll.config Files

Backup

The steps needed to backup your Orchestrator configuration vary slightly depending on your deployment model (e.g. On-prem and IaaS (Infrastructure as a Service), or PaaS (Platform as a Service)).

On-Prem and IaaS Deployments

1. Open your Orchestrator installation directory. By default, this is C:\Program Files (x86)\UiPath\Orchestrator.
2. Copy the web.config and UiPath.Orchestrator.dll.config files located there to your designated backup location.

Azure PaaS Deployments

1. Select your Orchestrator App Service.
2. From the Development Tools menu navigate to Advanced Tools > Go > Debug Console > CMD.
3. Open the Site folder and navigate to wwwroot.
4. Select Web.config and click Download.
5. Copy the downloaded file to your designated backup location.
6. Select UiPath.Orchestrator.dll.config and click Download.
7. Copy the downloaded file to your designated backup location.

In addition to the web.config and UiPath.Orchestrator.dll.config files, you must also copy the Application Settings and Connections Strings as follows:

1. Select your Orchestrator App Service.
2. From the Settings menu, select Configuration.
3. From the Application Settings section, select Advanced Edit and copy the displayed value.
4. From the Connection strings section, select Advanced Edit and copy the displayed value.
5. Save these values to your designated backup location.

Restore

Note: When restoring the web.config and UiPath.Orchestrator.dll.config files, you must do so all on Orchestrator nodes in your deployment.

On-Prem and IaaS Deployments

To restore your previous Orchestrator configuration, whether to a new environment or following a failure:

1. Copy the web.config and UiPath.Orchestrator.dll.config files from your desired backup.
2. Open your Orchestrator installation directory. By default, this is C:\Program Files (x86)\UiPath\Orchestrator.
3. Replace the web.config and UiPath.Orchestrator.dll.config files located there with your designated backup.

Azure PaaS Deployments

After you have retrieved your desired web.config and UiPath.Orchestrator.dll.config backup file:

1. Select your Orchestrator App Service.
2. From the Development Tools menu navigate to Advanced Tools > Go > Debug Console > CMD.
3. Open the Site folder and navigate to wwwroot.
4. Replace the web.config and UiPath.Orchestrator.dll.config files located there with your designated backup.

In addition to replacing the web.config and UiPath.Orchestrator.dll.config files, you must also restore the Application Settings and Connections Strings with their previous values, as follows:

1. Select your Orchestrator App Service.
2. From the Settings menu, select Configuration.
3. From the Application Settings section, select Advanced Edit and replace the value there with your previously saved backup.
4. From the Connection strings section, select Advanced Edit and replace the value there with your previously saved backup.

NuGet Packages

Backup

The location(s) of your NuGet package directories is indicated in the Deployment section of the UiPath.Orchestrator.dll.config file.

1. Check the value of the NuGet.Repository.Type key. The following values are possible:
   • Legacy - packages are stored in the locations specified in the NuGet.Packages.Path and NuGet.Activities.Path keys.
   • Composite - packages are stored in the locations specified in the Storage.Type and Storage.Location keys.
2. For Legacy repository types, copy the folders identified by the NuGet.Packages.Path and NuGet.Activities.Path keys to your designated backup location.
3. For Composite repository types where the Storage.Type key is:
   1. FileSystem - copy the folder(s) identified in the RootPath parameter of the Storage.Location key to your designated backup location.
   2. Azure - a connection string is provided in the Storage.Type key. Data integrity and availability is covered by Microsoft, however you can use their guide if you want to save the files stored there locally.
   3. Amazon - a connection string is provided in the Storage.Type key. Data integrity and availability is covered by Amazon, however you can use their guide if you want to save the files stored there locally.

Restore

Restoring your previous NuGet package directories follows the reverse of the backup process detailed above, as follows:

1. For Legacy repositories, copy your backups of the NuGet packages and activities folders to the directories identified by the NuGet.Packages.Path and NuGet.Activities.Path keys indicated in the Deployment section of the UiPath.Orchestrator.dll.config file.
2. For Composite repository types where the Storage.Type key is:
   • FileSystem - copy your backup folder(s) to the directory identified in the Storage.Location key of the RootPath parameter, found in the Deployment section of the UiPath.Orchestrator.dll.config file.
   • Azure - enter the previously saved connection string in the Storage.Type key.
   • Amazon - enter the previously saved connection string in the Storage.Type key.