Uninstalling IBM App Connect from the Red Hat OpenShift cluster

OpenShift-only content If no longer required, you can uninstall your IBM App Connect instances and the IBM App Connect Operator from your Red Hat® OpenShift® cluster.

The steps for uninstalling App Connect vary depending on whether identity and access management (IAM) is enabled in your environment by using Keycloak. IAM secures data and systems by controlling the access of authorized users to data and applications.

Before you begin

Ensure that you have cluster administrator authority with cluster-admin permissions.

Uninstalling App Connect from an environment that uses a managed Keycloak solution for IAM

If IAM is enabled in your environment, the IBM App Connect Operator is installed as part of an IBM Cloud Pak for Integration deployment, which includes a set of Operators that are needed to configure IAM. Depending on your license entitlement, the IBM Cloud Pak Platform UI, and instances of other product capabilities and their Operators might also be installed in this environment.

To uninstall, you therefore need to uninstall a collection of product-specific instances and multiple Operators. For more information, see Uninstalling in the Cloud Pak for Integration documentation.

Uninstalling App Connect from an environment that uses a self-managed Keycloak solution for IAM, or that has no IAM

If you are using an independent deployment of the IBM App Connect Operator without IAM or with a self-managed Keycloak solution for IAM, you can uninstall App Connect and Keycloak (if available) from you cluster. Follow these instructions to uninstall your App Connect instances and the IBM App Connect Operator by using the Red Hat OpenShift CLI. To uninstall Keycloak, see the documentation for the Keycloak solution that you are using.

Procedure

To uninstall your instances and Operator, complete the following steps:

From the command line, log in to your Red Hat OpenShift cluster by using the oc login command.
Delete all deployed instances of App Connect Dashboard, App Connect Designer, integration runtimes, switch servers, and configuration objects. Run the following commands to list (or check for), and then delete instances from the namespace (namespaceName) where they are installed. You can omit -n namespaceName if you're already in that namespace.

Tip: If the IBM App Connect Operator was installed cluster wide into all namespaces in the cluster, the instances might be installed across multiple namespaces and will need to be deleted from those namespaces.
1. App Connect Designer instances:
```
oc get designerauthoring -n namespaceName
```
```
oc delete designerauthoring --all -n namespaceName
```
2. Integration runtimes:
```
oc get integrationruntime -n namespaceName
```
```
oc delete integrationruntime --all -n namespaceName
```
3. Configuration objects:
```
oc get configuration -n namespaceName
```
```
oc delete configuration --all -n namespaceName
```
4. App Connect Dashboard instances:
```
oc get dashboard -n namespaceName
```
```
oc delete dashboard --all -n namespaceName
```
5. Switch server:
```
oc get switchserver -n namespaceName
```
```
oc delete switchserver --all -n namespaceName
```
List and then delete the subscription for the IBM App Connect Operator, where namespaceName is a single namespace where the Operator is installed, or is openshift-operators if the Operator was installed cluster wide.
```
oc get subscription ibm-appconnect -n namespaceName
```
```
oc delete subscription ibm-appconnect -n namespaceName
```
List and then delete the ClusterServiceVersion for the IBM App Connect Operator, where:
- namespaceName is a single namespace, or openshift-operators for a cluster-wide installation.
- V.R.M is the CSV version for the IBM App Connect Operator (for example, 13.4.0), which was displayed in the output for the oc get csv command.
```
oc get csv -n namespaceName
```
```
oc delete csv ibm-appconnect.vV.R.M -n namespaceName
```
List the CatalogSources in the OpenShift Operator catalog and then delete the CatalogSource for the IBM Operator Catalog.
CAUTION:
Only complete this step if you want to remove the IBM App Connect Operator and other IBM offerings from the catalog so they are no longer available for installation in your cluster.
```
oc get catalogsource -n openshift-marketplace
```
```
oc delete catalogsource ibm-operator-catalog -n openshift-marketplace
```
If the namespace where the IBM App Connect Operator was installed isn't being used for other resources, delete the namespace.
```
oc delete project namespaceName
```