Uninstalling OpenEBS

This section is to describe about the graceful deletion/uninstall of your OpenEBS cluster. OpenEBS cluster has three different storage engine, cStor,Local PV and Jiva. The deletion for the data from the disks after this operation is different for these storage Engines.

Uninstall OpenEBS Gracefully

The recommended steps to uninstall the OpenEBS cluster gracefully is as follows.

  • Delete all the OpenEBS PVCs that were created. You can check the status of PVC using the following command.

    1. kubectl get pvc -n <namespace>

    There should not have any entries of OpenEBS PVC.

  • Delete all the SPCs (In case of cStor storage engine). You can check the status of SPC using the following command.

    1. kubectl get spc

    There should not have any entries of OpenEBS SPC.

  • Ensure that there is no stale BlockDeviceClaims are present in the cluster. You can verify the status using the following command.

    1. kubectl get bdc -n <openebs namespace>

    If anything found, remove the finalizer entry from the corresponding BDC.

  • Ensure that no OpenEBS volume or pool pods are in terminating state . You can check the running status of Pods using the following command.

    1. kubectl get pods -n <openebs namespace>

  • Ensure that no openebs custom resources are present using the following command.

    1. kubectl get cvr -n <openebs namespace>

  • Ensure to delete OpenEBS related StorageClass. You can check the status of OpenEBS related StorageClasses using the following command.

    1. kubectl get sc

  • Delete the OpenEBS namespace either via helm delete <chart name> --purge if helm version is v2 or helm uninstall <chart name> -n <namespace> if helm version is v3 or kubectl delete ns openebs or you can delete the corresponding openebs-operator YAML using kubectl delete -f <openebs-operator.yaml>. You can check the status of OpenEBS namespace using the following command.

    1. kubectl get ns

  • Uninstalling the OpenEBS doesn’t automatically delete the CRDs that were created. If you would like to completely remove the CRDs and the associated objects, run the following commands:

    1. kubectl delete crd castemplates.openebs.io
    2. kubectl delete crd cstorpools.openebs.io
    3. kubectl delete crd cstorpoolinstances.openebs.io
    4. kubectl delete crd cstorvolumeclaims.openebs.io
    5. kubectl delete crd cstorvolumereplicas.openebs.io
    6. kubectl delete crd cstorvolumepolicies.openebs.io
    7. kubectl delete crd cstorvolumes.openebs.io
    8. kubectl delete crd runtasks.openebs.io
    9. kubectl delete crd storagepoolclaims.openebs.io
    10. kubectl delete crd storagepools.openebs.io
    11. kubectl delete crd volumesnapshotdatas.volumesnapshot.external-storage.k8s.io
    12. kubectl delete crd volumesnapshots.volumesnapshot.external-storage.k8s.io
    13. kubectl delete crd blockdevices.openebs.io
    14. kubectl delete crd blockdeviceclaims.openebs.io
    15. kubectl delete crd cstorbackups.openebs.io
    16. kubectl delete crd cstorrestores.openebs.io
    17. kubectl delete crd cstorcompletedbackups.openebs.io
    18. kubectl delete crd upgradetasks.openebs.io
    19. kubectl delete crd cstorpoolclusters.cstor.openebs.io
    20. kubectl delete crd cstorpoolinstances.cstor.openebs.io
    21. kubectl delete crd cstorvolumeattachments.cstor.openebs.io
    22. kubectl delete crd cstorvolumeconfigs.cstor.openebs.io
    23. kubectl delete crd cstorvolumepolicies.cstor.openebs.io
    24. kubectl delete crd cstorvolumereplicas.cstor.openebs.io
    25. kubectl delete crd cstorvolumes.cstor.openebs.io

    OpenEBS also installs some generic Kubernetes/CSI CRDs. In case OpenEBS is the only storage installed on your cluster, you can proceed to delete the following CRDs as well.

    1. kubectl delete crd csidrivers.csi.storage.k8s.io
    2. kubectl delete crd csinodeinfos.csi.storage.k8s.io
    3. kubectl delete crd volumesnapshotclasses.snapshot.storage.k8s.io
    4. kubectl delete crd volumesnapshotcontents.snapshot.storage.k8s.io
    5. kubectl delete crd volumesnapshots.snapshot.storage.k8s.io

Deletion of Jiva Volumes

As part of deleting the Jiva Volumes - OpenEBS launches scrub jobs for clearing the data from the nodes. This job will be running in OpenEBS installed namespace. The completed jobs need to be cleared using the following command.

  1. kubectl delete jobs -l openebs.io/cas-type=jiva -n <openebs_namespace>

In addition, the job is set with a TTL to get cleaned up, if the cluster version is greater than 1.12. However, for the feature to work, the alpha feature needs to be enabled in the cluster. More information can be read from here.

See Also:

FAQ

Troubleshooting

Feedback

Was this page helpful?

YesNo

Thanks for the feedback. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement. Engage and get additional help on https://kubernetes.slack.com/messages/openebs/.