Upgrade

You can upgrade Test Manager to the latest version using the installation package.

Checklist

Before you start the upgrade process, take a look at the following items:

Task	Description
Review system requirements	Make sure that you meet the system requirements: Hardware Requirements Software Requirements and Prerequisites
Database backup	Make sure you back up your database. For more information, see Test Manager backup and restore.

Upgrade through Windows installer

Download the latest UiPath Test Manager installation package and choose an upgrade scenario:

• Upgrade from version 2021.4 to a newer version
• Upgrade from version 2020.10 to 2021.4 or higher

• Upgrade from version 2020.4.2 to 2021.10 or newer versions

  Important:

  • The previous configuration settings are retained and already filled in based on your upgrade scenario.
  • IIS needs to be enabled during the upgrade.
  • To avoid data loss during the upgrade, consider stopping all test executions before proceeding with this process.

Upgrade from version 2021.4 to a newer version

In this upgrade scenario, the Test Manager UiPath Identity Settings are already provided, as you upgrade post-version 2021.4 or 2021.10.

Open the UiPath Test Manager installation package, proceed through the license agreement, and then click Upgrade. After you confirm that you have backed up your database, Test Manager is installed.

Upgrade from version 2020.10 to 2021.4 or higher

In this upgrade scenario, you need to provide the Identity Installation Token. You can generate the installation token through UiPath Identity Management by logging in as the host tenant.

Open the UiPath Test Manager installation package, proceed through the license agreement, and then paste the installation token in the Identity Installation Token.

Click Upgrade to continue and confirm if you have backed up your database. Test Manager is installed on your machine.

Upgrade from version 2020.4.2 to 2021.10 or newer versions when Test Manager credentials cannot be recovered

In a typical scenario, upgrading from 2020.4.2 to newer versions only requires a new Identity Installation Token and upgrading through the Test Manager installation package.

If you have lost access to your old Test Manager account, you need to perform a parallel installation of Test Manager version 20.4.2 on the same server hosting your existing version 20.4.2 of Test Manager. Afterwards, you can upgrade to the 2021.10 version

Assumptions

You have Orchestrator 2021.10.0 installed on a server, while Test Manager 2020.4.2 is installed on a different server.

Before you upgrade

Perform a backup of the existing Test Manager installation folder, located on your machine in Program Files, alongside a snapshot of the server that is hosting the product.

Step 1: Install a parallel 2020.4.2 version of Test Manager

You need to install Test Manager 2020.4.2 on the same server where you have the existing version 2020.4.2 of Test Manager.

To complete this step, follow the Test Manager Installation procedure and consider the following:

• Use a different user with administrator permissions on the machine where you are about to install Test Manager
• Use the default port number. Make sure you uncheck Verify port availability in the Test Manager IIS Settings step from the installation. Leaving this option checked means that you will have to use a non-default port number and change it later in the application settings file.
• Keep the default Orchestrator tenant name.

Step 2: Update the application settings for the parallel version of Test Manager

After the installation is completed, you need to update the database connection strings of the new Test Manager instance.

1. Go to C:\Program Files (x86)\UiPath\Test Manager\ and open appsettings.production.json.
2. Update the Database Connection Strings with the backup that you have previously made before installing the parallel version of Test Manager.

   "Database": {
       "ConnectionStrings": {
         "testmanagementhub": "Data Source=.\\yourTestManagerSQL;Initial Catalog=UiPathTestManager-21.10;Integrated Security=True"
       }

3. Save the file.

Note: Open your parallel version of Test Manager to make sure it works.

Step 3: Install ASP.NET 5.0.12

Download and install ASP.NET Core 5.0 Runtime.

Step 4: Install Test Manager 2021.10

Open the UiPath Test Manager 2021.10 installation package, proceed through the license agreement, and then click Upgrade. After you confirm that you have backed up your database, Test Manager is installed.