Home
Administrator Guide
This guide describes how to install the IBM® Rational® Test Automation Server software.
Uninstallation of the server software
When you no longer require Rational® Test Automation Server, you can uninstall the server software. You can uninstall the server software depending on the platform on which you installed the server software.
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.

Administrator Guide
This guide describes how to install the IBM® Rational® Test Automation Server software.
- Installation of the server software
  To get started working with IBM® Rational® Test Automation Server, you must first install the server software.
- Server software upgrade methods
  When you want to use the enhanced functionalities of Rational® Test Automation Server, you must upgrade Rational Test Automation Server to the latest version.
- Migration of user data
  You can find information about the migration limitations and methods when you want to migrate data such as projects, test resources, configuration details of integrated applications, and so on. You can migrate data that is generated in an earlier version of IBM® Rational® Test Automation Server after you upgrade to or install the latest version, and then use that data in the latest version.
- Backup and restoration of the server data
  You must back up all your server data before you uninstall the current version of the server software or upgrade to the latest version of the server software. You must back up the server data to avoid data loss or inaccessibility of data.
- Uninstallation of the server software
  When you no longer require Rational® Test Automation Server, you can uninstall the server software. You can uninstall the server software depending on the platform on which you installed the server software.
  - Uninstalling the server software from IBM® Red Hat OpenShift
    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 Red Hat OpenShift platform.
  - 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.
  - Uninstalling the server software from Azure Kubernetes Service
    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 Azure Kubernetes Service (AKS) cluster.
- Configuration of the server software
  You can find information about the tasks that you must perform after you installed the server software to configure Rational® Test Automation Server.
- Team space administration
  You can find information about team spaces including the initial team space on IBM® Rational® Test Automation Server along with the tasks that you can perform to administer a team space.

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.

About this task

You must replace {my-rtas} 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

Log in to the Ubuntu server using an SSH session.
Run the following command to stop the workload that is running:
```
kubectl delete all,cm,secret -lexecution-marker -n test-system
```
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.

Run the following commands to delete the entire Kubernetes environment, including all user data:

Ubuntu version	Commands to be run
18.04	`cd ibm-rtas-case/inventory/ibmRtasBase/files sudo ./ubuntu-wipe.sh --confirm`
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.