Backup and Restore

In this topic you will learn how to back up and restore Test Manager for scenarios such as migrating to new environments, recovery and other use cases.

Prerequisites

Before taking any steps towards Test Manager migration, make sure that both Orchestrator and Identity Server have been backed up and restored to your new environment. When you restore Orchestrator, select Test Automation during the setup .

Important: Both Orchestrator and Test Manager can only be restored to the same version from which the backup was taken. For example, if you want to perform a migration for Orchestrator and Test Manager version 2021.4.x, you need to install the same product version in your new environment. Upgrade is possible only after the migration is completed.

Backup

You will need to back up the following Test Manager components:

Test Manager Database

To back up Test Manager Database consider the backup policies used in your enterprise. You can find backup information that is relevant to this scenario in Backup and Restore.

Test Manager config file

Test Manager configuration settings are defined in the appsettings.production.json file. You can find the file in C:\Program Files (x86)\UiPath\Test Manager\.

Test Manager storage location

To find out the storage location of your Test Manager files, you need to check the Storage section in the appsettings.production.json file.

Restore

To restore Test Manager on your new environment you need to perform the following steps:

Install Test Manager.

Important: Make sure you install the same version as the one you just backed up.
Restore the Test Manager backup.

For more information on restoring backups using SQL Server Management Studio (SSMS), see Restore a backup.
Restore the files from the Storage location to the new location found in the appsettings.production.json file.
Restore the settings from the backed up Test Manager config file, including the DataEncryptionKey to encrypt your data. To find the file, see [Test Manager config file]((doc:test-manager-backup-and-restore#test-manager-config-file).