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 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 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 complete 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 cstorvolumes.openebs.io
    7. kubectl delete crd runtasks.openebs.io
    8. kubectl delete crd storagepoolclaims.openebs.io
    9. kubectl delete crd storagepools.openebs.io
    10. kubectl delete crd volumesnapshotdatas.volumesnapshot.external-storage.k8s.io
    11. kubectl delete crd volumesnapshots.volumesnapshot.external-storage.k8s.io
    12. kubectl delete crd disks.openebs.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 cstorpoolclusters.openebs.io
    19. kubectl delete crd upgradetasks.openebs.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