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 OneTest™ Server 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 HCL OneTest™ Server, 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.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 HCL OneTest™ Server 10.5.0 to HCL OneTest™ Server 10.5.1.	You must reconfigure IBM® Engineering Test Management as a quality management solution in the latest version of HCL OneTest™ Server.
10.5.0 or earlier	10.5.1	If you configured Jira as a change management system on HCL OneTest™ Server, 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 HCL OneTest™ Server 10.5.1.	You must reconfigure Jira as a change management system in the latest version of HCL OneTest™ Server.
10.5.0 or earlier	10.5.1	If you configured IBM® Engineering Test Management as a quality management solution on HCL OneTest™ Server 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 HCL OneTest™ Server. Delete the configured Engineering Test Management from the HCL OneTest™ Server project.	You must reconfigure IBM® Engineering Test Management as a quality management solution in the latest version of HCL OneTest™ Server.
10.2.3	10.5.0	If you configured IBM® Engineering Test Management on HCL OneTest™ Server 10.2.3, the information about Engineering Test Management is not visible after you migrate HCL OneTest™ Server 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 HCL OneTest™ Server.
10.2.3	10.5.0	If you configured Jira on HCL OneTest™ Server 10.2.3, the information about Jira is not visible after you migrate HCL OneTest™ Server from 10.2.3 to 10.5.0 or later.	You must reconfigure Jira as a change management system in the latest version of HCL OneTest™ Server.
10.2.3 or earlier	10.5.0	You cannot migrate edited test assets that were created in HCL OneTest™ Server 10.2.3 or earlier, to HCL OneTest™ Server 10.5.0 or later.	You might have to open and edit the test assets in the latest version of HCL OneTest™ Server.
10.2.0	10.2.1 or later	If you edited test assets in your project on HCL OneTest™ Server 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 HCL OneTest™ Server can be migrated and used in a later version of HCL OneTest™ Server 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 HCL OneTest™ Server 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 the server software by uninstalling the existing version, and installing the required version of HCL OneTest™ Server, then you must perform the migration task after the installation of the server software 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 the software by using the helm upgrade command, the migration of user data takes place during the upgrade process.