Uninstalling Cognos Analytics

An instance administrator can uninstall Cognos Analytics.

Who needs to complete this task?

Instance administrator To uninstall Cognos Analytics, you must be an instance administrator. An instance administrator has permission to manage software in the following projects:

The operators project for the instance: The operators for this instance of Cloud Pak for Data are installed in the operators project. In the uninstall commands, the ${PROJECT_CPD_INST_OPERATORS} environment variable refers to the operators project.
The operands project for the instance: The Cloud Pak for Data control plane and the services for this instance of Cloud Pak for Data are installed in the operands project. In the uninstall commands, the ${PROJECT_CPD_INST_OPERANDS} environment variable refers to the operands project.
The tethered projects for the instance: If any projects are tethered to the operands project, you have permission to manage the software in the tethered projects.

When do you need to complete this task?

Complete this task if you want to remove Cognos Analytics from an instance of Cloud Pak for Data.

Repeat as needed If you are responsible for multiple instances of Cloud Pak for Data, you can repeat this task to remove other instances of Cognos Analytics on the cluster.

Information you need to complete this task

Review the following information before you uninstall Cognos Analytics:

Environment variables

The commands in this task use environment variables so that you can run the commands exactly as written.

If you don't have the script that defines the environment variables, see Setting up installation environment variables.
To use the environment variables from the script, you must source the environment variables before you run the commands in this task. For example, run:
```
source ./cpd_vars.sh
```

Procedure

Complete the following tasks to uninstall Cognos Analytics:

Deleting service instances
Uninstalling the service

Deleting service instances

Before you uninstall Cognos Analytics, you must delete any service instances that are associated with Cognos Analytics to ensure that each instance releases the resources that it reserved.

Who needs to complete this task?: A user with the Manage service instances permission must complete this task.

When do you need to complete this task?: Complete this task before you uninstall Cognos Analytics.

From the Cloud Pak for Data web client:

Log in to the web client as a user with sufficient permissions to complete the task.
From the menu, select Services > Instances.
Filter the list to show the cognos-analytics-app type.
Delete each cognos-analytics-app instance in the list.

Uninstalling the service

To uninstall Cognos Analytics:

Run the cpd-cli manage login-to-ocp command to log in to the cluster as a user with sufficient permissions to complete this task. For example:
```
cpd-cli manage login-to-ocp \
--username=${OCP_USERNAME} \
--password=${OCP_PASSWORD} \
--server=${OCP_URL}
```
Tip: The login-to-ocp command takes the same input as the oc login command. Run oc login --help for details.

Delete the custom resource for Cognos Analytics.

cpd-cli manage delete-cr \
--components=cognos_analytics \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS}

Wait for the cpd-cli to return the following message before you proceed to the next step:

[SUCCESS]... The delete-cr command ran successfully

Delete the OLM objects for Cognos Analytics:

cpd-cli manage delete-olm-artifacts \
--cpd_operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--components=cognos_analytics

Wait for the cpd-cli to return the following message:

[SUCCESS]... The delete-olm-artifacts command ran successfully