Chapter 13. Uninstalling AMQ Streams
You can uninstall AMQ Streams on OpenShift 4.8 to 4.12 from the OperatorHub using the OpenShift Container Platform web console or CLI.
Use the same approach you used to install AMQ Streams.
When you uninstall AMQ Streams, you will need to identify resources created specifically for a deployment and referenced from the AMQ Streams resource.
Such resources include:
- Secrets (Custom CAs and certificates, Kafka Connect secrets, and other Kafka secrets)
-
Logging
ConfigMaps(of typeexternal)
These are resources referenced by Kafka, KafkaConnect, KafkaMirrorMaker, or KafkaBridge configuration.
Deleting CustomResourceDefinitions results in the garbage collection of the corresponding custom resources (Kafka, KafkaConnect, KafkaMirrorMaker, or KafkaBridge) and the resources dependent on them (Deployments, StatefulSets, and other dependent resources).
13.1. Uninstalling AMQ Streams from the OperatorHub using the web console
This procedure describes how to uninstall AMQ Streams from the OperatorHub and remove resources related to the deployment.
You can perform the steps from the console or use alternative CLI commands.
Prerequisites
-
Access to an OpenShift Container Platform web console using an account with
cluster-adminorstrimzi-adminpermissions. You have identified the resources to be deleted.
You can use the following
ocCLI command to find resources and also verify that they have been removed when you have uninstalled AMQ Streams.Command to find resources related to an AMQ Streams deployment
oc get <resource_type> --all-namespaces | grep <kafka_cluster_name>
Replace <resource_type> with the type of the resource you are checking, such as
secretorconfigmap.
Procedure
- Navigate in the OpenShift web console to Operators > Installed Operators.
For the installed Red Hat Integration - AMQ Streams operator, select the options icon (three vertical dots) and click Uninstall Operator.
The operator is removed from Installed Operators.
- Navigate to Home > Projects and select the project where you installed AMQ Streams and the Kafka components.
Click the options under Inventory to delete related resources.
Resources include the following:
- Deployments
- StatefulSets
- Pods
- Services
- ConfigMaps
- Secrets
TipUse the search to find related resources that begin with the name of the Kafka cluster. You can also find the resources under Workloads.
Alternative CLI commands
You can use CLI commands to uninstall AMQ Streams from the OperatorHub.
Delete the AMQ Streams subscription.
oc delete subscription amq-streams -n openshift-operators
Delete the cluster service version (CSV).
oc delete csv amqstreams.<version> -n openshift-operatorsRemove related CRDs.
oc get crd -l app=strimzi -o name | xargs oc delete
13.2. Uninstalling AMQ Streams using the CLI
This procedure describes how to use the oc command-line tool to uninstall AMQ Streams and remove resources related to the deployment.
Prerequisites
-
Access to an OpenShift cluster using an account with
cluster-adminorstrimzi-adminpermissions. You have identified the resources to be deleted.
You can use the following
ocCLI command to find resources and also verify that they have been removed when you have uninstalled AMQ Streams.Command to find resources related to an AMQ Streams deployment
oc get <resource_type> --all-namespaces | grep <kafka_cluster_name>
Replace <resource_type> with the type of the resource you are checking, such as
secretorconfigmap.
Procedure
Delete the Cluster Operator
Deployment, relatedCustomResourceDefinitions, andRBACresources.Specify the installation files used to deploy the Cluster Operator.
oc delete -f install/cluster-operator
Delete the resources you identified in the prerequisites.
oc delete <resource_type> <resource_name> -n <namespace>
Replace <resource_type> with the type of resource you are deleting and <resource_name> with the name of the resource.
Example to delete a secret
oc delete secret my-cluster-clients-ca -n my-project
