Bug 2037736

Summary: [GSS][Doc] Incorrect odf must-gather image path in Troubleshooting Doc
Product: [Red Hat Storage] Red Hat OpenShift Data Foundation Reporter: Sonal <sarora>
Component: documentationAssignee: Anjana Suparna Sriram <asriram>
Status: CLOSED DUPLICATE QA Contact: Raz Tamir <ratamir>
Severity: high Docs Contact:
Priority: unspecified    
Version: 4.9CC: asriram, bkunal, branto, muagarwa, nberry, ocs-bugs, odf-bz-bot, oviner
Target Milestone: ---Flags: nberry: needinfo? (asriram)
Target Release: ---   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2022-01-07 06:58:41 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:

Description Sonal 2022-01-06 13:17:10 UTC
Describe the issue:

The path of odf must-gather for 4.9 is incorrect in Troubleshooting Doc.

~~~
Run the must-gather command from the client connected to the Red Hat OpenShift Data Foundation cluster:

$ oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9 --dest-dir=<directory-name>
~~~

On running the above image, getting error 'Back-off pulling image "registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9'

~~~
oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9 --dest-dir=
[must-gather      ] OUT Using must-gather plug-in image: registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9
When opening a support case, bugzilla, or issue please include the following summary data along with any other requested information.
ClusterID: 38b7b9fb-9980-454e-b3ed-9ea4fc25869e
ClusterVersion: Stable at "4.9.12"
ClusterOperators:
	All healthy and stable


[must-gather      ] OUT namespace/openshift-must-gather-zztdn created
[must-gather      ] OUT clusterrolebinding.rbac.authorization.k8s.io/must-gather-kt9c2 created
[must-gather      ] OUT pod for plug-in image registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9 created
[must-gather-hrkdk] OUT gather did not start: unable to pull image: ImagePullBackOff: Back-off pulling image "registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9"
[must-gather      ] OUT clusterrolebinding.rbac.authorization.k8s.io/must-gather-kt9c2 deleted
[must-gather      ] OUT namespace/openshift-must-gather-zztdn deleted
~~~


Describe the task you were trying to accomplish:

To capture ODF must-gather

Suggestions for improvement:

The correct image path is :

# oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9--dest-dir=<directory-name>


Document URL:

https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/4.9/html/troubleshooting_openshift_data_foundation/downloading-log-files-and-diagnostic-information_rhodf

Chapter/Section Number and Title:

CHAPTER 2. DOWNLOADING LOG FILES AND DIAGNOSTIC INFORMATION USING MUST-GATHER

There are 4 occurrences of the incorrect image path in Chapter-2.

Product Version:

ODF 4.9

Environment Details:

Any

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

None

Additional information:

Comment 4 Oded 2022-01-06 22:22:52 UTC
The mg command with the image "registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9" return error
We need to change the image on the doc.

SetUp:
OCP Version:4.10.0-0.nightly-2021-12-23-153012
ODF Version:4.10.0-50
Provider:Vmware


Test Process:
1.Run mg with image registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9
$ oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9 
[must-gather      ] OUT Using must-gather plugin-in image: registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9
[must-gather      ] OUT namespace/openshift-must-gather-flvzt created
[must-gather      ] OUT clusterrolebinding.rbac.authorization.k8s.io/must-gather-rz5wn created
[must-gather      ] OUT pod for plug-in image registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9 created
[must-gather-chbnd] OUT gather did not start: unable to pull image: ImagePullBackOff: Back-off pulling image "registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9"
[must-gather      ] OUT clusterrolebinding.rbac.authorization.k8s.io/must-gather-rz5wn deleted
[must-gather      ] OUT namespace/openshift-must-gather-flvzt deleted
error: gather did not start for pod must-gather-chbnd: unable to pull image: ImagePullBackOff: Back-off pulling image "registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.9"

$ tree
.
└── must-gather.local.4824502181053735671
    ├── event-filter.html
    └── timestamp

1 directory, 2 files

2.Run mg with image "registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9"
$ oc adm must-gather --image=registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 
[must-gather      ] OUT Using must-gather plugin-in image: registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9
[must-gather      ] OUT namespace/openshift-must-gather-q7fwq created
[must-gather      ] OUT clusterrolebinding.rbac.authorization.k8s.io/must-gather-l6kmk created
[must-gather      ] OUT pod for plug-in image registry.redhat.io/odf4/ocs-must-gather-rhel8:v4.9 created
[must-gather-zwgwv] POD checking for existing must-gather resource
[must-gather-zwgwv] POD No resources found in openshift-storage namespace.
[must-gather-zwgwv] POD creating helper pod

Comment 5 Mudit Agarwal 2022-01-07 05:40:25 UTC
Build team knows the best, there is no code change from our side which can cause this.

Comment 6 Bipin Kunal 2022-01-07 06:58:41 UTC

*** This bug has been marked as a duplicate of bug 2035180 ***

Comment 7 Boris Ranto 2022-01-07 07:34:49 UTC
Yes, the image is now located under odf4 org in RH registry. All the images were moved there in 4.9 onwards.