Uninstall Rook Ceph

About this task

To completely remove Rook Ceph, you must remove the application and clear all the environment configurations to prevent an automatic reinstall.

Note

Before removing the Rook Ceph application(s), unmount all the persistent volumes associated with the Rook Ceph cluster. This is achieved by removing all the applications dependent on StorageClasses provided by the Rook Ceph application. After removing the application(s), delete all PVCs and PVs that were previously provided to the application(s).

If dependent application removal is not desired, then minimal cleanup is needed. All pods with PVCs must be deleted, scaled down to zero, or edited removing the PVC volume mounts. Otherwise, Rook Ceph application removal will fail, volumes may hang, and nodes may require a restart. In this case, a --force option is needed to remove the Rook Ceph application and tear down the Ceph cluster.

Procedure

1. Remove the application by running the script:

   source /etc/platform/openrc
   system application-remove rook-ceph --force
   retry_count=1
   retries=200
   while [ $retry_count -le $retries ]; do
       rookstatus=$(system application-list | grep rook-ceph | awk '{print $10}')
       echo $rookstatus
       if [[ "$rookstatus" == "uploaded" ]]; then
           system application-delete rook-ceph
           break
       fi
       echo "Retry #" $retry_count
       let retry_count++
   done
   

2. Remove the environment configurations completely.

   1. Remove OSDs.

      1. Lock the host.

         ~(keystone_admin)$ system host-lock <hostname>
         

      2. List all OSDs to get the uuid of each OSD.

         ~(keystone_admin)$ system host-stor-list <hostname>
         

      3. Remove each OSD using the uuid of all OSDs.

         ~(keystone_admin)$ system host-stor-delete <uuid>
         

      4. Unlock the host.

         ~(keystone_admin)$ system host-unlock <hostname>
         

   2. (AIO-DX Only) Remove controllerfs.

      1. To remove a controllerfs, the standby controller must be locked and the controllerfs needs to be in Ready state.

         ~(keystone_admin)$ system host-lock <hostname>
         

      2. Remove the controllerfs.

         ~(keystone_admin)$ system controllerfs-delete ceph-float
         

      3. Unlock the standby controller.

         ~(keystone_admin)$ system host-unlock <hostname>
         

   3. Remove the host-fs.

      ~(keystone_admin)$ system host-fs-delete <hostname> ceph
      

   4. Remove the storage backend ceph-rook.

      ~(keystone_admin)$ system storage-backend-delete ceph-rook-store --force