Uninstall Portworx from a Kubernetes cluster using the Operator

Using the Portworx Operator, you can efficiently uninstall Portworx from your clusters. This can be achieved by updating the StorageCluster object, and you have the option to either keep the data on your drives or wipe them completely.

• Uninstall: Removes the Kubernetes objects, Portworx systemctl service, /etc/pwx and /opt/pwx directories, and all traces of Portworx on the nodes. The drives will not be formatted and Portworx Metadata in the KVDB will not be deleted. You may need to uninstall Portworx if you installed it in the wrong namespace.
• Uninstall and wipe: Removes all of the resources listed in the "Uninstall" procedure, and also removes (formats) all data from your disks permanently, including the Portworx metadata. You may want to perform an uninstall and wipe when you decommission a cluster.

Prerequisites

• A successfully deployed Portworx Operator on your cluster.

Uninstall Portworx

Kubernetes

1. Display the Portworx StorageCluster:

   Use the kubectl get command to display the name of your Portworx storage cluster:

   kubectl get -n <px-namespace> storagecluster <storagecluster-name>

2. Edit the StorageCluster:

   Modify your storage cluster to initiate the uninstall process:

   kubectl edit -n <px-namespace> storagecluster <storagecluster-name>

   Update the deleteStrategy field in the StorageCluster object:

   • For Uninstall Only:

     apiVersion: core.libopenstorage.org/v1
     kind: StorageCluster
     metadata:
       name: portworx
       namespace: <px-namespace>
     spec:       
       deleteStrategy:
         type: Uninstall

   • For Uninstall and Wipe:

     apiVersion: core.libopenstorage.org/v1
     kind: StorageCluster
     metadata:
       name: portworx
       namespace: <px-namespace>
     spec:       
       deleteStrategy:
         type: UninstallAndWipe

     note

     Wiping operations will permanently remove all data, including Portworx metadata, from your disks.

3. Delete the StorageCluster:

   Execute the following command, specifying your StorageCluster object:

   kubectl delete StorageCluster <storagecluster-name> -n <px-namespace>

   This operation can take several minutes to complete.

4. Remove the Portworx Operator:

   Finally, delete the Portworx Operator deployment:

   kubectl delete deployment -n <px-namespace> portworx-operator

Openshift

1. Display the Portworx StorageCluster:

   Enter the oc get command to display the name of your Portworx storage cluster and specify your namespace:

   oc get -n portworx storagecluster <storagecluster-name>

2. Edit the StorageCluster: Enter the oc edit command to modify your storage cluster and specify your namespace:

   oc edit -n portworx storagecluster <storagecluster-name>

   Modify your StorageCluster object, adding the deleteStrategy field with either the Uninstall or UninstallAndWipe type:

   • Uninstall Portworx only:

     apiVersion: core.libopenstorage.org/v1
     kind: StorageCluster
     metadata:
       name: portworx
       namespace: portworx
     spec:       
       deleteStrategy:
         type: Uninstall

   • Uninstall Portworx and wipe all drives:

     note

     Wipe operations remove all data from your disks permanently including the Portworx metadata, use caution when applying the DeleteStrategy spec.

     apiVersion: core.libopenstorage.org/v1
     kind: StorageCluster
     metadata:
       name: portworx
       namespace: portworx
     spec:       
       deleteStrategy:
         type: UninstallAndWipe

3. Delete the StorageCluster:

   Enter the oc delete command, specifying the name of your StorageCluster object and specify your namespace:

   oc delete StorageCluster <your-storagecluster-name> -n portworx

   note

   This operation can take several minutes to complete.

4. Remove the Portworx Operator:

   Finally, delete the Portworx Operator deployment:

   oc delete deployment -n <px-namespace> portworx-operator