Bug 1903944

Summary: [Doc] Once we will release OCS 4.6 there will be problem to run latest must-gather command on OCS 4.5 clusters
Product: [Red Hat Storage] Red Hat OpenShift Container Storage Reporter: Petr Balogh <pbalogh>
Component: documentationAssignee: Laura Bailey <lbailey>
Status: CLOSED CURRENTRELEASE QA Contact: Petr Balogh <pbalogh>
Severity: high Docs Contact:
Priority: high    
Version: 4.6CC: asriram, ddf-bot, nberry, ocs-bugs, pkundra
Target Milestone: ---Keywords: Documentation
Target Release: OCS 4.6.0   
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: 2020-12-18 11:54:49 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: 1882363    

Description Petr Balogh 2020-12-03 08:17:17 UTC
Describe the issue:
The secret names changed in must gather image for 4.6 and we are documenting here:
https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/4.5/html-single/troubleshooting_openshift_container_storage/index

to use this command:
oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8 --dest-dir=<directory-name> --node-name=<node-name>

As we don't specify tag, we will use latest which is just fine as of now for 4.6 but in older versions, we should use proper version tag.

https://catalog.redhat.com/software/containers/ocs4/ocs-must-gather-rhel8/5ddef0005a13461646f7f364 here I see we can use tag: v4.5


Describe the task you were trying to accomplish:
I ran latest GAed must gather on OCS 4.5 on IBM Cloud where OCS 4.6 were installed which caused issue cause of change in secret name, Pulkit told me that the same problem will be when running 4.6 must gather on OCS 4.5 cluster, so I think we should fix that at least in previous versions.
Pulkit, please keep me honest here. Thanks

Suggestions for improvement:
So I propose to follow this and in each version specify proper tag like:
oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.5 --dest-dir=<directory-name> --node-name=<node-name>.


Document URL:
https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/4.5/html-single/troubleshooting_openshift_container_storage/index

Chapter/Section Number and Title:
Chapter 2. Downloading log files and diagnostic information using must-gather

Product Version:
4.5 and 4.6 and probably 4.4 as well as we support OCS n-2 IIRC

Environment Details:

Any other versions of this document that also needs this update:

Additional information:

Comment 7 Petr Balogh 2020-12-08 11:42:22 UTC
Looks ok, only 4.3 link doesn't content the tag.

- in the 4.3 docs, changed to ocs-must-gather-rhel8:v4.3
https://access.redhat.com/documentation/en-us/red_hat_openshift_container_storage/4.3/html-single/troubleshooting_openshift_container_storage/index?lb_target=preview

Hence failing QE

Comment 12 Petr Balogh 2020-12-08 13:05:33 UTC
Looks OK now.

Comment 13 Rejy M Cyriac 2020-12-18 11:54:49 UTC
OCS 4.6.0 GA completed on 17 December 2020

Comment 14 Ashish Singh 2020-12-24 11:21:40 UTC
*** Bug 1910333 has been marked as a duplicate of this bug. ***