Uninstalling Watson Text to Speech

A project administrator can uninstall Watson Text to Speech from IBM® Cloud Pak for Data.

Permissions you need for this task: You must be an administrator of the OpenShift® project (Kubernetes namespace) where Watson Text to Speech is installed.

Procedure

Complete the following tasks to uninstall Watson Text to Speech:

Uninstalling the service
Uninstalling the operator

Note: Complete step 2 only if you want to completely remove the Speech services software from your cluster.

Uninstalling the service

When you need to complete this task

Complete this task when you want to remove a running instance of Watson Text to Speech.

If you installed multiple instances of Watson Text to Speech on the cluster, you must complete this task for each instance of Watson Text to Speech that you want to uninstall.

If you plan to uninstall the operator, you must uninstall all instances of Watson Text to Speech before you uninstall the operator.

When you delete the WatsonSpeech custom resource, the WatsonSpeech operand is uninstalled. (The operand is the running instance of Watson Text to Speech.)

Uninstalling Watson Text to Speech will remove all of the data that is associated with this instance of Watson Text to Speech.

To uninstall the service:

From the web client, remove any provisioned instances of Watson Text to Speech:
1. Log in to the Cloud Pak for Data web client as an administrator.
2. From the menu, select Services > Instances.
3. Filter the list to show only text-to-speech instances.
4. Delete each text-to-speech instance.
Log in to Red Hat® OpenShift Container Platform as a user with sufficient permissions to complete the task:
```
oc login OpenShift_URL:port
```
Change to the project (namespace) where Watson Text to Speech is installed:
```
oc project ${PROJECT_CPD_INSTANCE}
```

Get the name of the custom resource:

oc get WatsonSpeech -n ${PROJECT_CPD_INSTANCE}

Delete the WatsonSpeech custom resource:

oc delete WatsonSpeech custom-resource-name -n ${PROJECT_CPD_INSTANCE}

Run the following command to verify that the resources that were created by Watson Text to Speech are deleted:
```
oc get all,pvc -l "release in (custom-resource-name, custom-resource-name-rabbitmq)"
```
If Watson Text to Speech was uninstalled successfully, the response is empty. If the response is not empty, you can run the following command to force the deletion:
```
oc delete all,pvc -l "release in (custom-resource-name, custom-resource-name-rabbitmq)" \
  --force --grace-period=0
```
Run the following command to verify that the secret that was created by Watson Text to Speech is deleted:
```
oc get secret | grep custom-resource-name
```
If Watson Text to Speech was uninstalled successfully, the response is empty. If the response is not empty, you can run the following command to force the deletion:
```
oc delete secret custom-resource-name-ca custom-resource-name-instance-tls
```

Uninstalling the operator

When you need to complete this task

Complete this task only if you want to completely remove Watson Text to Speech from your cluster.

Complete this task after you uninstall the service.

Before you begin

Ensure the IBM Cloud Pak® CLI (cloudctl) is installed on your local machine. If the IBM Cloud Pak CLI is not installed:

Download the cloudctl software from the IBM/cloud-pak-cli repository on GitHub. Ensure that you download the appropriate package for your workstation:
```
cloudctl-operating-system-architecture.tar.gz
```
Extract the contents of the archive file:
```
tar -xzf archive-name
```
Change to the directory where you extracted the file and make the file executable:
```
chmod 775 cloudctl-architecture
```

Move the file to the /usr/local/bin directory:

mv cloudctl-architecture /usr/local/bin/cloudctl

Confirm that the IBM Cloud Pak CLI (cloudctl) is installed:
```
cloudctl --help
```

Tip: Additional guidance for validating the archive file is available in the IBM/cloud-pak-cli repository.

To uninstall the operator:

Specify the directory where you want to download the CASE package for Watson Speech. For example, you could download the file to $HOME/offline:
```
export OFFLINEDIR=$HOME/offline
```

Download the CASE package for Watson Speech:

cloudctl case save \
  --repo https://github.com/IBM/cloud-pak/raw/master/repo/case \
  --case ibm-watson-speech \
  --version 4.0.10 \
  --outputdir ${OFFLINEDIR}

Change to the directory where you downloaded the CASE package.
Log in to Red Hat OpenShift Container Platform as a user with sufficient permissions to complete the task:
```
oc login OpenShift_URL:port
```

Run the following command to see a preview of the items that will be removed when you uninstall the operator:

The operators are in the ibm-common-services project (express installations)

cloudctl case launch \
  --case ibm-watson-speech-4.0.10.tgz \
  --inventory speechOperatorSetup \
  --namespace ibm-common-services \
  --action uninstall-operator \
  --args "--dryRun"

The operators are in the cpd-operators project (specialized installations)

cloudctl case launch \
  --case ibm-watson-speech-4.0.10.tgz \
  --inventory speechOperatorSetup \
  --namespace cpd-operators \
  --action uninstall-operator \
  --args "--dryRun"

Uninstall the operator. You can either:
- Rerun the previous command without the --args "--dryRun" entry.
- Run the oc commands that were specified in the dry run output.