diff --git a/doc/source/shared/abbrevs.txt b/doc/source/shared/abbrevs.txt index 47c9e2c3e..a70718c78 100755 --- a/doc/source/shared/abbrevs.txt +++ b/doc/source/shared/abbrevs.txt @@ -171,6 +171,7 @@ .. |PSPs| replace:: :abbr:`PSPs (Pod Security Policies)` .. |PTP| replace:: :abbr:`PTP (Precision Time Protocol)` .. |PTS| replace:: :abbr:`PTS (Primary Time Source)` +.. |PVs| replace:: :abbr:`PVs (Persistent Volumes)` .. |PVC| replace:: :abbr:`PVC (Persistent Volume Claim)` .. |PVCs| replace:: :abbr:`PVCs (Persistent Volume Claims)` .. |PXE| replace:: :abbr:`PXE (Preboot Execution Environment)` diff --git a/doc/source/storage/kubernetes/uninstall-rook-ceph-cbb046746782.rst b/doc/source/storage/kubernetes/uninstall-rook-ceph-cbb046746782.rst index 6e2fd0051..6f9977335 100644 --- a/doc/source/storage/kubernetes/uninstall-rook-ceph-cbb046746782.rst +++ b/doc/source/storage/kubernetes/uninstall-rook-ceph-cbb046746782.rst @@ -9,9 +9,24 @@ Uninstall Rook Ceph .. rubric:: |context| -To completely remove Rook Ceph you must remove the app and clear all the +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. + .. rubric:: |proc| #. Remove the application by running the script: