Uninstalling IBM App Connect from the Red Hat OpenShift cluster

OpenShift-only contentIf 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 IAM-enabled environment

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 will 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 where IAM is not enabled

If IAM is not enabled in your environment, follow these instructions to uninstall your App Connect instances and the IBM App Connect Operator by using the Red Hat OpenShift CLI.

Procedure

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

  1. From the command line, log in to your Red Hat OpenShift cluster by using the oc login command.
  2. Delete all deployed instances of App Connect Dashboard, App Connect Designer, integration servers, 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 servers:
      oc get integrationserver -n namespaceName
      oc delete integrationserver --all -n namespaceName
    3. Integration runtimes:
      oc get integrationruntime -n namespaceName
      oc delete integrationruntime --all -n namespaceName
    4. Configuration objects:
      oc get configuration -n namespaceName
      oc delete configuration --all -n namespaceName
    5. App Connect Dashboard instances:
      oc get dashboard -n namespaceName
      oc delete dashboard --all -n namespaceName
    6. Switch server:
      oc get switchserver -n namespaceName
      oc delete switchserver --all -n namespaceName
  3. 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
  4. 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, 11.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
  5. 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
  6. 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