Bug 1662131

Summary: Wrongly documented to delete the directories to uninstall OCS, which causes openshift playbooks to fail.
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Anshul Verma <ansverma>
Component: doc-Container_Native_Storage_with_OpenShiftAssignee: Bhavana <bmohanra>
Status: CLOSED NOTABUG QA Contact: storage-qa-internal <storage-qa-internal>
Severity: high Docs Contact:
Priority: high    
Version: ocs-3.11CC: ansverma, asriram, bkunal, bmohanra, knarra, rhs-bugs, sankarshan, storage-doc, storage-qa-internal
Target Milestone: ---Keywords: ZStream
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-03-11 11:20:15 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1672844    

Description Anshul Verma 2018-12-26 10:31:48 UTC
Document URL: 
1) https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index#idm140254129768144
2) https://access.redhat.com/documentation/en-us/red_hat_gluster_storage/3.3/html-single/container-native_storage_for_openshift_container_platform/#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Uninstalling

Section Number and Name: 
For 1) Under Note sections
For 2) Step 3: Cleanup the persistent directories

Describe the issue: 

These links suggest deleting the following directories in order to uninstall OCS from OCP -
~~
# rm -rf /var/lib/heketi \
   /etc/glusterfs \
   /var/lib/glusterd \
   /var/log/glusterfs
~~

When these directories are deleted while the glusterfs package which actually creates these directories is already installed. Now when re-installing OCS the glusterfs package is already installed so it would not get re-installed and these directories do not get created again and then if any playbook which needs to use the /var/log/glusterfs directory, does not get the directory in place and is not able to create a log file which it needs to create in this particular directory and the playbooks fails.

There is already a bug opened for not deleting these directories rather, either deleting the content inside these directories or removing the packages directly which would be again installed when reinstalling OCS.
https://bugzilla.redhat.com/show_bug.cgi?id=1661965

Suggestions for improvement: 
The possible solutions could be to document that either we suggest to remove the packages glusterfs or just to delete the content of there directories rather than removing the directories themselves.
~~
# rm -rf /var/lib/heketi/* \
   /etc/glusterfs/* \
   /var/lib/glusterd/* \
   /var/log/glusterfs/*
~~

Additional information: 
KCS article created for the case -
https://access.redhat.com/solutions/3773501

Comment 2 RamaKasturi 2019-02-20 10:02:26 UTC
This is taken care by ansible uninstall playbook at [1] and this bug is no longer valid. Can we close this bug ?

[1] https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/3.11/html-single/deployment_guide/index#chap-Documentation-Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-Uninstall_CNS

Comment 3 Anjana Suparna Sriram 2019-03-11 11:20:15 UTC
(In reply to RamaKasturi from comment #2)
> This is taken care by ansible uninstall playbook at [1] and this bug is no
> longer valid. Can we close this bug ?
> 
> [1]
> https://access.redhat.com/documentation/en-us/
> red_hat_openshift_container_storage/3.11/html-single/deployment_guide/
> index#chap-Documentation-
> Red_Hat_Gluster_Storage_Container_Native_with_OpenShift_Platform-
> Uninstall_CNS

Based on QE's inputs, closing this bug.