Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Uninstalling

Red Hat OpenShift Service Mesh 3.0.0tp1

Uninstalling OpenShift Service Mesh

Red Hat OpenShift Documentation Team

Abstract

This documentation provides information about uninstalling OpenShift Service Mesh.

Chapter 1. Uninstalling OpenShift Service Mesh

You can uninstall the Red Hat OpenShift Service Mesh Operator from an existing OpenShift Container Platform instance and remove its resources either by using the OpenShift Container Platform web console, or through the command line interface (CLI). You can also delete Istio custom resource definitions (CRDs).

1.1. Uninstalling OpenShift Service Mesh Operator 3 and the Istio control plane using the web console

Uninstalling Red Hat OpenShift Service Mesh Operator 3 and the Istio control plane from an existing OpenShift Container Platform instance requires removing the following:

  • Istio resource
  • IstioCNI resource
  • Red Hat OpenShift Service Mesh Operator 3
  • istio-system project
  • istio-cni project

Optionally, you can remove the Istio custom resource definitions (CRDs).

You can uninstall the Red Hat OpenShift Service Mesh Operator 3 either by using the OpenShift Container Platform web console.

Procedure

  1. Delete the Istio resource:

    1. In the OpenShift web console, click Operators → Installed Operators.
    2. Click Istio in the Provided APIs column.
    3. Click the Options menu → Delete Istio.
    4. At the prompt to confirm the action, click Delete.

  2. Delete the IstioCNI resource:

    1. In the OpenShift web console, click Operators → Installed Operators.
    2. Click IstioCNI in the Provided APIs column.
    3. Click the Options menu → Delete IstioCNI.
    4. At the prompt to confirm the action, click Delete.

  3. Uninstall Red Hat OpenShift Service Mesh 3 Operator:

    1. In the OpenShift web console, click Operators → Installed Operators.
    2. Locate Red Hat OpenShift Service Mesh 3 Operator.
    3. Click the Options menu → Uninstall Operator.
    4. At the prompt to confirm the action, select the Delete all operand instances for this operator checkbox.
    5. Click Uninstall.

  4. Delete the istio-system project:

    1. In the OpenShift web console, click Home → Projects.
    2. Locate the name of the istio-system project.
    3. Click the Options menu → Delete Project.
    4. At the prompt to confirm the action, enter the name of the project.
    5. Click Delete.

  5. Delete the istio-cni project:

    1. In the OpenShift web console, click Home → Projects.
    2. Locate the name of the istio-cni project.
    3. Click the Options menu → Delete Project.
    4. At the prompt to confirm the action, enter the name of the project.
    5. Click Delete.

1.2. Uninstall OpenShift Service Mesh by using the CLI

Uninstalling Red Hat OpenShift Service Mesh Operator 3 and the Istio control plane from an existing OpenShift Container Platform instance requires removing the following:

  • Istio resource
  • IstioCNI resource
  • Red Hat OpenShift Service Mesh Operator 3
  • istio-system project
  • istio-cni project

Optionally, you can remove the Istio custom resource definitions (CRDs).

You can uninstall the Red Hat OpenShift Service Mesh Operator 3 either by using the OpenShift Container Platform command line interface (CLI).

Procedure

  1. Delete the Istio resource:

    1. Retrieve the Istio resource name by running the following command: 

      $ oc get istio -n istio-system

    2. Replace <name_of_custom_resource> with the output from the previous command, and run the following command to remove the custom resource: 

      $ oc delete istio/<name_of_custom_resource>

  2. Delete the IstioCNI resource:

    1. Retrieve the name of the IstioCNI resource by running the following command: 

      $ oc get istioCNI -n istio-system

    2. Replace <name_of_custom_resource> with the output from the previous command, and run the following command to remove the custom resource: 

      $ oc delete istioCNI/<name_of_custom_resource>

  3. Delete the istio-system and istio-cni projects:

    1. Delete the istio-system namespace by running the following command: 

      $ oc delete ns istio-system

    2. Delete the istio-cni namespace by running the following command: 

      $ oc delete ns istio-cni

  4. Uninstall OpenShift Service Mesh Operator 3:

    1. Delete the servicemeshoperator3 subscription: 

      $ oc delete subscription servicemeshoperator3 -n openshift-operators

      Example output

      output: subscription.operators.coreos.com "servicemeshoperator3" deleted

    2. Check the current version of the servicemeshoperator3 subscribed Operator in the currentCSV field by running the following command: 

      $ oc get subscription servicemeshoperator3 -n openshift-operators -o yaml | grep currentCSV

      Example output

      output: currentCSV: servicemeshoperator3.v3.0.0-tp.1

    3. Delete the cluster service version (CSV) for the Operator in the target namespace using the currentCSV value from the previous step: 

      $ oc delete clusterserviceversion servicemeshoperator3.v3.0.0-tp.1 -n openshift-operators

      Example output

      clusterserviceversion.operators.coreos.com "servicemeshoperator3.v3.0.0-tp.1" deleted.

1.3. Delete Istio custom resource definitions

Deleting Istio custom resource definitions (CRDs) are optional.

Procedure

  1. To delete the Istio CRDs, run the following command: 
$ oc get crds -oname | grep -e istio.io -e sailoperator.io | xargs kubectl delete

Additional resources

Legal Notice

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.