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 Rational® Test Automation Server software.

  • Closed Rational® Test Automation Server, any open web browsers, and all other applications that are enabled by Rational® Test Automation Server.

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

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
    Remember: The 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 test-system in all the instances in this procedure.
  3. Run the following command to uninstall the server software:
    helm uninstall {my-rtas} -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.
    Note: You must substitute {my-rtas} with the same release name that you used during the installation of the server software.
  4. Run the following commands to delete the entire Kubernetes environment, including all user data:
    #Run the following command if you are on Ubuntu 18.04
    cd ibm-rtas-case/inventory/ibmRtasBase/files
    sudo ./ubuntu-wipe.sh --confirm
    
    #Run the following command if you are on Ubuntu 20.04
    cd ibm-rtas-case/inventory/ibmRtasBase/files
    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.