Migration of user data

You can find information about the migration limitations and methods when you want to migrate data such as projects, test resources, configuration details of integrated applications, and so on. You can migrate data that is generated in an earlier version of HCL DevOps Test Hub (Test Hub) after you upgrade to or install the latest version, and then use that data in the latest version.

Limitations for user data migration

Before you can decide on the migration method for the version of Test Hub, you must review the limitations that apply to the migrated data.

Table 1. Migration limitations
Migrating from	Migrating to	Limitation	The workaround, if available
10.5.4 or earlier	11.0.0	You cannot migrate the Jira integration or its associated Xray integration to Test Hub 11.0.0 or later, as the method to authenticate the Jira connection is changed in 11.0.0 or later. Note: The links to the Jira or Xray project that are created in earlier versions will be available and will work after Jira and Xray are reconfigured in Test Hub 11.0.0 or later.	You must reconfigure Jira as a change management system on Test Hub 11.0.0 or later. You must also reconfigure the Xray integration, if configured.
10.5.0	10.5.1	You cannot migrate the IBM® Engineering Test Management data that is generated when it is configured as a quality management solution on Test Hub 10.5.0 to Test Hub 10.5.1.	You must reconfigure IBM® Engineering Test Management as a quality management solution in the latest version of Test Hub.
10.5.0 or earlier	10.5.1	If you configured Jira as a change management system on Test Hub, and subsequently changed the name of the project in Jira, then you cannot then configure the changed project name in the CHANGE MANAGEMENT SYSTEM tab of Test Hub 10.5.1.	You must reconfigure Jira as a change management system in the latest version of Test Hub.
10.5.0 or earlier	10.5.1	If you configured IBM® Engineering Test Management as a quality management solution on Test Hub 10.5.0, and subsequently updated or deleted a Project area in Engineering Test Management, then you cannot perform the following tasks: Delete your project from Test Hub. Delete the configured Engineering Test Management from the Test Hub project.	You must reconfigure IBM® Engineering Test Management as a quality management solution in the latest version of Test Hub.
10.2.3	10.5.0	If you configured IBM® Engineering Test Management on Test Hub 10.2.3, the information about Engineering Test Management is not visible after you migrate Test Hub from 10.2.3 to 10.5.0 or later.	You must reconfigure IBM® Engineering Test Management as a quality management solution in the latest version of Test Hub.
10.2.3	10.5.0	If you configured Jira on Test Hub 10.2.3, the information about Jira is not visible after you migrate Test Hub from 10.2.3 to 10.5.0 or later.	You must reconfigure Jira as a change management system in the latest version of Test Hub.
10.2.3 or earlier	10.5.0	You cannot migrate edited test assets that were created in Test Hub 10.2.3 or earlier, to Test Hub 10.5.0 or later.	You might have to open and edit the test assets in the latest version of Test Hub.
10.2.0	10.2.1 or later	If you edited test assets in your project on Test Hub 10.2.0 and migrated them, then the values displayed in the Last Changed By field might be incorrect for the edited test assets.

Migration methods

The data that is generated in Test Hub can be migrated and used in a later version of Test Hub with except for the limitations detailed in Migration limitations.

You can refer to the following table to know the details of the migration when you want to upgrade to the latest Test Hub version:

Table 2. Migration method used during an upgrade
OS / Platform	Server version	Upgrade method	Migration method
Ubuntu	10.1.3 or later	Upgrade by new install	When you upgrade Test Hub by uninstalling the existing version, and installing the required version of Test Hub, then you must perform the migration task after the installation of Test Hub is complete. For more information about the migration process, see Migrating user data on Ubuntu from 10.1.3 or later or Migrating user data on Ubuntu from 10.1.2 or earlier.
Ubuntu	10.1.2 or earlier	Upgrade by new install
Azure Kubernetes Service	10.2.3 or later	In-place upgrade	When you upgrade Test Hub by using the helm upgrade command, the migration of user data takes place during the upgrade process.