Home
Administrator Guide
This guide describes how to install the HCL OneTest™ Server software.
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.

Administrator Guide
This guide describes how to install the HCL OneTest™ Server software.
- Installation of the server software
  To get started working with HCL OneTest™ Server, you must first install the server software.
- Server software upgrade methods
  When you want to use the enhanced functionalities of HCL OneTest™ Server, you must upgrade HCL OneTest Server to the latest version.
- 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.
  - Migrating user data on Ubuntu from 10.1.2 or earlier
    When you want to use the data, which was in your earlier version, in a new version of HCL OneTest™ Server, you can migrate those user data.
  - Migrating user data on Ubuntu from 10.1.3 or later
    When you want to use the data, which was in your earlier version, in a new version of HCL OneTest™ Server, you can migrate those user data..
- Backup and restoration of the server data
  You must back up all your server data before you uninstall the current version of the server software or upgrade to the latest version of the server software. You must back up the server data to avoid data loss or inaccessibility of data.
- Uninstallation of the server software
  When you no longer require HCL OneTest™ Server, you can uninstall the server software. You can uninstall the server software depending on the platform on which you installed the server software.
- Configuration of the server software
  You can find information about the tasks that you must perform after you installed the server software to configure HCL OneTest™ Server.
- Team space administration
  You can find information about team spaces including the initial team space on HCL OneTest™ Server along with the tasks that you can perform to administer a team space.

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.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.