- Studio installation
- Robot installation
- Orchestrator installation
- Test Manager installation
Upgrade
You can upgrade Test Manager to the latest version using the installation package.
Before you start the upgrade process, take a look at the following items:
|
Task |
Description |
|---|---|
|
|
Make sure that you meet the system requirements: |
|
|
Make sure you back up your database. For more information, see Test Manager backup and restore. |
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
-
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.
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.
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
You have Orchestrator 2021.10.0 installed on a server, while Test Manager 2020.4.2 is installed on a different server.
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.
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.
After the installation is completed, you need to update the database connection strings of the new Test Manager instance.
- Go to
C:\Program Files (x86)\UiPath\Test Manager\and openappsettings.production.json. -
Update the
Database Connection Stringswith 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" }"Database": { "ConnectionStrings": { "testmanagementhub": "Data Source=.\\yourTestManagerSQL;Initial Catalog=UiPathTestManager-21.10;Integrated Security=True" } - Save the file.
- Checklist
- Upgrade through Windows installer
- 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 when Test Manager credentials cannot be recovered
- Assumptions
- Before you upgrade
- Step 1: Install a parallel 2020.4.2 version of Test Manager
- Step 2: Update the application settings for the parallel version of Test Manager
- Step 3: Install ASP.NET 5.0.12
- Step 4: Install Test Manager 2021.10
