Description of problem (please be detailed as possible and provide log snippests): ------------------------------------------------------------------------ Currently in OCS docs, we have the following Note in case deletion of oenshift-storage project is not successful and is stuck in terminating state """""" [NOTE] While uninstalling OpenShift Container Storage, if namespace is not deleted completely and remains in Terminating state, perform the steps in the article https://access.redhat.com/solutions/3881901 to identify objects that are blocking the namespace from being terminated. OpenShift objects such as Cephcluster, StorageCluster, NooBaa, and PVC that have the finalizers might be the cause for the namespace to be in Terminating state. If PVC has a finalizer, force delete the associated pod to remove the finalizer. """"" The steps to mitigate the issue in https://access.redhat.com/solutions/3881901 are not clear enough and it would be better to have a separate section in Troubleshooting guide to explain the problem and the workaround. With some common examples. Then we can link to the Troubleshooting guide, instead of the above article. Some details - Bug 1856083 - UNINSTALLING OPENSHIFT CONTAINER STORAGE - CRD cephclients and finalizers Version of all relevant components (if applicable): --------------------------- Atleast from OCS 4.5 onwards.
Talur, could you verify these changes?
After a meeting with Agil and Bipin on Thursday, we came up with consolidated steps for the troubleshooting Guide here [1] https://docs.google.com/document/d/1A8Lc4n50ZGJsPNoo-4-cr0bTnomrpsdIJ_asejJM-9c/edit?userstoinvite=agantony%40redhat.com&ts=5f33f727&actionButton=1
I have incorporated the review comments. Please cross check the draft in comment #6.
The content in https://docs.google.com/document/d/1_6VzcV_uaPaXUSaRSb9CDapfrwFsu6Klqbs-By6KCKw/edit# LGTM
(In reply to Agil Antony from comment #11) > Hi, > > @all > > > Here is the preview link : > > https://access.redhat.com/documentation/en-us/ > red_hat_openshift_container_storage/4.5/html-single/ > troubleshooting_openshift_container_storage/ > index?lb_target=preview#troubleshooting-and-deleting-remaining-resources- > during-uninstall_rhocs > > [gitlab]: > https://gitlab.cee.redhat.com/red-hat-openshift-container-storage- > documentation/red-hat-openshift-container-storage-4.5/-/merge_requests/110/ > diffs > > Please use the draft to put in your comments and suggestions (if any). > [comment #6] > > Thanks, Requesting one more round of review from JC and Bipin
@Agil, Few more suggestions for adding "extra line before Output" added in the gdoc https://docs.google.com/document/d/1_6VzcV_uaPaXUSaRSb9CDapfrwFsu6Klqbs-By6KCKw/edit
The troubleshooting guide is clear.
Hi Agil, can we add a small change in the docs for Step 2 . It is a little urgent as at times, one needs to look for both the messages Current current: 2. Check for the NamespaceFinalizersRemaining messages in the STATUS section of the command output and perform the next step for each of the listed resources. Suggested statement: 2. Check for the NamespaceFinalizersRemaining and NamespaceContentRemaining messages in the STATUS section of the command output and perform the next step for each of the listed resources.