Uninstalling the server software from Ubuntu

When you want to install a new version of server software or you want to reinstall the server software when an ongoing installation fails, you can uninstall the server software and its components from the Ubuntu platform.

Before you begin

You must have completed the following tasks:
  • Installed HCL OneTest Server software.

  • Closed HCL OneTest Server, any open web browsers, and all other applications that are enabled by HCL OneTest Server.

  • Optional: Backed-up data from the previous version of the product.

About this task

You must replace {my-rtas}{my-ots} with the name of the release that you provided during the installation of the server software in all the instances in this procedure.

The test-system is the name of the namespace that is created during the setting up of the k3s environment.

Procedure

  1. Log in to the Ubuntu server using an SSH session.
  2. Run the following command to stop the workload that is running:
    kubectl delete all,cm,secret -lexecution-marker -n test-system
  3. Run the following command to uninstall the server software:
    helm uninstall {my-ots} -n test-system

    The PersistentVolumeClaims and PersistentVolumes that were created during the installation are not deleted automatically. If you reinstall the server software, the user data is reused unless you specifically delete those volumes.

  4. Run the following commands to delete the entire Kubernetes environment, including all user data:
    Ubuntu version Commands to be run

    18.04

    cd hcl-onetest-base
    sudo ./ubuntu-wipe.sh --confirm

    20.04

    cd hcl-onetest-base
    sudo HOME=$HOME ./ubuntu-wipe.sh --confirm

    After you run this command, the system returns to the same state as if ubuntu-init.sh was never run.

    Important: If you want to migrate data from a previous version to the latest version of the product, then you must ensure to back up the data before you run this command.

Results

You have uninstalled the server software from the Ubuntu platform.