Server software upgrade on Ubuntu

When you want to use the latest version of the server software on Ubuntu, you must upgrade HCL OneTest Server from the previous version of the software.

Before you upgrade the server software, you must ensure that you have completed the following tasks:

  • Installed Helm. For more information, refer to the Helm documentation.

  • Completed all test executions that are running on the existing version of HCL OneTest Server.

  • Stopped all stub executions that are running on the existing version of HCL OneTest Server.

  • Canceled any scheduled test runs that have a future date or time.

  • Informed users that HCL OneTest Server is offline temporarily during the upgrade process.

For more information about specific versions of software requirements, see System Requirements.

In upgrade (by new install) method, depending on the existing version of the software, you can upgrade the server software by using any of the following options.

To upgrade HCL OneTest Server (10.1.0 or later) to latest version, you must perform these tasks in sequence as listed in the following table:

Tasks Task description More information
1 Back up the user data from the previous version of HCL OneTest Server. Backing up user data
2 Uninstall the previous version of HCL OneTest Server including entire Kubernetes environment. Uninstalling the server software from Ubuntu
3 Set up the Kubernetes environment (k3s) by using the provided script. Setting up a Kubernetes environment (k3s) on Ubuntu
4 Install the latest version of the server software. Installing the server software on Ubuntu by using k3s
5 Migrate the user data after the installation is complete. Migrating user data on Ubuntu from 10.1.2 or earlier

Or

Migrating user data on Ubuntu from 10.1.3 or later

If your existing version of server software is 10.0.2, Fix Pack 1, or earlier, then you cannot directly upgrade to the latest version of the server software due to the steps involved in the migration process. Therefore, you must perform the tasks in sequence as listed in the following table:

Tasks Task description More information
1 Upgrade HCL OneTest Server 10.1.2. Installation of the server software on Ubuntu
2 Back up the user data from HCL OneTest Server 10.1.2. Backing up user data - 10.1.2
3 Uninstall HCL OneTest Server 10.1.2 including entire Kubernetes environment. Uninstalling the server software
4 Install the latest version of the server software. Installing the server software on Ubuntu by using k3s
5 Migrate the user data after the installation is complete. Migrating user data on Ubuntu from 10.1.2 or earlier