This process allows you to remove Red Hat OpenShift Service Mesh from an existing OpenShift Container Platform instance.

Removing the Red Hat OpenShift Service Mesh control plane

You can remove the Service Mesh control plane by using the OpenShift Container Platform web console or the CLI.

Removing the control plane with the web console

Follow this procedure to remove the Red Hat OpenShift Service Mesh control plane by using the web console.

Prerequisites
  • The Red Hat OpenShift Service Mesh control plane must be deployed.

Procedure
  1. Log in to the OpenShift Container Platform web console.

  2. Click the Project menu and choose the istio-system project from the list.

  3. Navigate to CatalogsInstalled Operators.

  4. Click on Service Mesh Control Plane under Provided APIs.

  5. Click the ServiceMeshControlPlane menu kebab.

  6. Click Delete Service Mesh Control Plane.

  7. Click Delete on the confirmation dialog window to remove the ServiceMeshControlPlane.

Removing the control plane from the CLI

Follow this procedure to remove the Red Hat OpenShift Service Mesh control plane by using the CLI.

Prerequisites
  • The Red Hat OpenShift Service Mesh control plane must be deployed.

  • Access to the OpenShift Container Platform Command-line Interface (CLI) also known as oc.

Procedure

When you remove the ServiceMeshControlPlane, Service Mesh tells the Operator to begin uninstalling everything it installed.

You can use the shortened smcp alias in place of servicemeshcontrolplane.

  1. Log in to the OpenShift Container Platform CLI.

  2. Run this command to retrieve the name of the installed ServiceMeshControlPlane:

    $ oc get servicemeshcontrolplanes -n istio-system
  3. Replace <name_of_custom_resource> with the output from the previous command, and run this command to remove the custom resource:

    $ oc delete servicemeshcontrolplanes -n istio-system <name_of_custom_resource>

Removing the installed Operators

You must remove the Operators to successfully remove Red Hat OpenShift Service Mesh. Once you remove the Red Hat OpenShift Service Mesh Operator, you must remove the Jaeger Operator, Kiali Operator, and the Elasticsearch Operator.

Removing the Red Hat OpenShift Service Mesh Operator

Follow this procedure to remove the Red Hat OpenShift Service Mesh Operator.

Prerequisites
  • Access to the OpenShift Container Platform web console.

  • The Red Hat OpenShift Service Mesh Operator must be installed.

Procedure
  1. Log in to the OpenShift Container Platform web console.

  2. Navigate to CatalogsOperator Management.

  3. Click the Project menu, and then click openshift-operators.

  4. Click the servicemeshoperator Options menu kebab, and then click Remove Subscription.

  5. Select Also completely remove the Operator from the selected namespace, and then click Remove.

Removing the Jaeger Operator

Follow this procedure to remove the Jaeger Operator.

Prerequisites
  • Access to the OpenShift Container Platform web console.

  • The Jaeger Operator must be installed.

Procedure
  1. Log in to the OpenShift Container Platform web console.

  2. Navigate to CatalogsOperator Management.

  3. Click the Project menu, and then click openshift-operators.

  4. Click the jaegeroperator Options menu kebab, and then click Remove Subscription.

  5. Select Also completely remove the Operator from the selected namespace, and then click Remove.

Removing the Kiali Operator

Follow this procedure to remove the Kiali Operator.

Prerequisites
  • Access to the OpenShift Container Platform web console.

  • The Kiali Operator must be installed.

Procedure
  1. Log in to the OpenShift Container Platform web console.

  2. Navigate to CatalogsOperator Management.

  3. Click the Project menu, and then click openshift-operators.

  4. Click the kiali-ossm Options menu kebab, and then click Remove Subscription.

  5. Select Also completely remove the Operator from the selected namespace, and then click Remove.

Removing the Elasticsearch Operator

Follow this procedure to remove the Elasticsearch Operator.

Prerequisites
  • Access to the OpenShift Container Platform web console.

  • The Elasticsearch Operator must be installed.

Procedure
  1. Log in to the OpenShift Container Platform web console.

  2. Navigate to CatalogsOperator Management.

  3. Click the Project menu, and then click openshift-operators.

  4. Click the elasticsearch-operator Options menu kebab, and then click Remove Subscription.

  5. Select Also completely remove the Operator from the selected namespace, and then click Remove.

Clean up Operator resources

Follow this procedure to manually remove resources left behind after removing the Red Hat OpenShift Service Mesh Operator by using the OperatorHub interface.

Prerequisites
  • An account with cluster administration access.

  • Access to the OpenShift Container Platform Command-line Interface (CLI) also known as oc.

Procedure
  1. Log in to the OpenShift Container Platform CLI as a cluster administrator.

  2. Run the following commands to clean up resources after uninstalling the Operators:

    Replace <operator-project> with the name of the project where the Red Hat OpenShift Service Mesh Operator was installed. This is typically openshift-operators.

    $ oc delete validatingwebhookconfiguration/<operator-project>.servicemesh-resources.maistra.io
    $ oc delete -n <operator-project> daemonset/istio-node
    $ oc delete clusterrole/istio-admin
    $ oc get crds -o name | grep '.*\.istio\.io' | xargs -r -n 1 oc delete
    $ oc get crds -o name | grep '.*\.maistra\.io' | xargs -r -n 1 oc delete