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.3, then you can upgrade HCL OneTest™ Server by using the helm upgrade
command.
Before you begin
You must have completed the following tasks:
-
Informed users that HCL OneTest™ Server is offline temporarily during the upgrade process.
-
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.
-
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.
-
Copied the Secret key from the Harbor repository.
Optional. You can back up the user data from the previous version of the product. If the upgrade fails, then you can use that backup file to restore it on V10.2.0. See Backing up the server data on Red Hat OpenShift.
Procedure
- Log in to your OCP cluster as a cluster administrator by running the oc login command.
-
Add the software registry to Helm to access the server install charts by running the
following command:
helm repo add hclsoftware https://hclcr.io/chartrepo/ot --username {okta-email-address} --password {harbor-cli-secret}
Note: You must replace{okta-email-address}
with the user name of the Harbor repository and replace{harbor-cli-secret}
with the secret key that you copied from the Harbor repository.If the user name contains any special characters, such as $, you must enclose it within single quotes.
-
Run the following command to get the latest updates from the repository:
helm repo update
-
Run the following command to retrieve the charts:
helm pull --untar hclsoftware/hcl-onetest-server --version 5.1020.0
-
Create a Secret to pull images that are used by HCL OneTest™ Server by running the following commands:
oc create secret docker-registry hclcr.io \ -n test-system \ --docker-server=hclcr.io \ --docker-username={okta-email-address} \ --docker-password={harbor-cli-secret} \ --docker-email=example@abc.com
Notes:-
You must replace
{okta-email-address}
with the user name of the Harbor repository and replace{harbor-cli-secret}
with the secret key that you copied from the Harbor repository.If the user name contains any special characters, such as $, you must enclose it within single quotes.
-
You can replace
example@abc.com
with the email address of the administrator if required.
Remember: test-system is the name of the namespace. If you created a namespace by using a different value, then you must use that value in place of the test-system in all the instances in this procedure. -
-
Perform the following steps to upgrade the server software:
-
Run the following command to verify and test the upgraded server
software:
$ helm test {my-ots} -n test-system
where
{my-ots}
is the name of the release that was provided during the installation of the server software.
Results
-
Keycloak URL to manage and authenticate users.
-
A URL to access the HCL OneTest™ Server UI.