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
Delete the
Istio
resource:-
In the OpenShift web console, click Operators
Installed Operators. - Click Istio in the Provided APIs column.
-
Click the Options menu
Delete Istio. - At the prompt to confirm the action, click Delete.
-
In the OpenShift web console, click Operators
Delete the
IstioCNI
resource:-
In the OpenShift web console, click Operators
Installed Operators. - Click IstioCNI in the Provided APIs column.
-
Click the Options menu
Delete IstioCNI. - At the prompt to confirm the action, click Delete.
-
In the OpenShift web console, click Operators
Uninstall Red Hat OpenShift Service Mesh 3 Operator:
-
In the OpenShift web console, click Operators
Installed Operators. - Locate Red Hat OpenShift Service Mesh 3 Operator.
-
Click the Options menu
Uninstall Operator. - At the prompt to confirm the action, click Uninstall.
-
In the OpenShift web console, click Operators
Delete the
istio-system
project:-
In the OpenShift web console, click Home
Projects. -
Locate the name of the
istio-system
project. -
Click the Options menu
Delete Project. - At the prompt to confirm the action, enter the name of the project.
- Click Delete.
-
In the OpenShift web console, click Home
Delete the
istio-cni
project:-
In the OpenShift web console, click Home
Projects. -
Locate the name of the
istio-cni
project. -
Click the Options menu
Delete Project. - At the prompt to confirm the action, enter the name of the project.
- Click Delete.
-
In the OpenShift web console, click Home
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
Delete the
Istio
resource:Retrieve the
Istio
resource name by running the following command:$ oc get istio -n istio-system
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>
Delete the
IstioCNI
resource:Retrieve the name of the
IstioCNI
resource by running the following command:$ oc get istioCNI -n istio-system
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>
Delete the
istio-system
andistio-cni
projects:Delete the
istio-system
namespace by running the following command:$ oc delete ns istio-system
Delete the
istio-cni
namespace by running the following command:$ oc delete ns istio-cni
Uninstall OpenShift Service Mesh Operator 3:
Delete the
servicemeshoperator3
subscription:$ oc delete subscription servicemeshoperator3 -n openshift-operators
Example output
output: subscription.operators.coreos.com "servicemeshoperator3" deleted
Check the current version of the
servicemeshoperator3
subscribed Operator in thecurrentCSV
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
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
- 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