Home
Administrator Guide
This guide describes how to install HCL OneTest™ Server software. After you install the software, you can perform administration tasks such as license configuration, user management, security, memory, and disk usage management, back up and restore user data. This guide is intended for administrators.
Server software upgrade methods
When you want to use the enhanced functionalities of HCL OneTest™ Server, you must upgrade to the latest version of the server software.
Server software upgrade on Red Hat OpenShift
When you want to use the latest version of the server software on Red Hat OpenShift, you must upgrade HCL OneTest™ Server from the previous version of the software.
Server software upgrade by using upgrade (by new install) method
When you do not have any specific requirement to upgrade the server software, you can uninstall the existing version of the server software, and then install the latest version.

Administrator Guide
This guide describes how to install HCL OneTest™ Server software. After you install the software, you can perform administration tasks such as license configuration, user management, security, memory, and disk usage management, back up and restore user data. This guide is intended for administrators.
- Installation of the server software
  To get started 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 to the latest version of the server software.
  - Server software upgrade on Red Hat OpenShift
    When you want to use the latest version of the server software on Red Hat OpenShift, you must upgrade HCL OneTest™ Server from the previous version of the software.
    - Upgrading the server software by using the in-place upgrade method
      When you want to install the latest version of the server software in the same location that contained the V10.1.0 or V10.1.1, then you can upgrade HCL OneTest™ Server by using the helm upgrade command.
    - Server software upgrade by using upgrade (by new install) method
      When you do not have any specific requirement to upgrade the server software, you can uninstall the existing version of the server software, and then install the latest version.
  - 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.
- Backing up and restoring the user data
  You might want to restore an earlier environment state if you install a new version of HCL OneTest™ Server, move environments to different systems (both real and virtual), or set up a test environment ready for testing. To address any of these needs, you can back up and restore HCL OneTest Server user data installed either on Ubuntu or on Red Hat OpenShift platform.
- 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.

Server software upgrade by using upgrade (by new install) method

When you do not have any specific requirement to upgrade the server software, you can uninstall the existing version of the server software, and then install the latest version.

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

Installed Helm V3.5.2. For more information, refer to the Installing a Helm chart on an OpenShift Container Platform cluster section in the Red Hat OpenShift documentation.
Informed users that HCL OneTest™ Server is offline temporarily during the upgrade process.
Completed all test executions that are running on the existing HCL OneTest™ Server V10.1.0 or later.
Stopped all stub executions that are running on the existing HCL OneTest™ Server V10.1.0 or later.
Canceled any scheduled test runs that have a future date or time.

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. The following table describes the options that are available in the this method:

Table 1. Upgrade options
Existing version	Upgrade (by new install) options
HCL OneTest™ Server V10.0.2, Fix Pack 1 or earlier	Option 1
HCL OneTest™ Server V10.1.0 or V10.1.1	Option 2

Important:

After you migrate the server data from a previous version to a newer version, the Project Owner must log in to HCL OneTest™ Server so that other members of the project can access the test assets in that project.

Table 2. Option 1
Tasks	Task description	More information
1	Back up the user data, and then uninstall the server software.	Uninstalling the server software
2	Install the server software, and then restore the user data on the existing version of the server software.	Installing the server software on Red Hat OpenShift

Table 3. Option 2
Tasks	Task description	More information
1	Back up the user data from V10.1.0 or V10.1.1.	Backing up the user data
2	Uninstall the V10.1.0 or V10.1.1 of the server software.	Uninstalling the server software from Red Hat OpenShift
3	Install the latest version of the server software, and then restore the user data on the existing version of the server software.	Installing the server software on Red Hat OpenShift