Document URL:

https://access.redhat.com/documentation/en-us/openshift_container_platform/4.13/html-single/virtualization/index#usage-and-examples_virt-collecting-virt-data

Section Number and Name:

14.2.3.1.2. Usage and examples

Describe the issue:

The doc is asking to run the "script" as below:

~~~
oc adm must-gather \
--image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v4.12.3 \
– gather_vms_details
~~~

This will fail with the below error:

~~~
[must-gather-tlbdx] POD 2023-06-05T07:45:47.809798106Z + echo 'This script should not be directly executed.'
[must-gather-tlbdx] POD 2023-06-05T07:45:47.809808455Z This script should not be directly executed.
[must-gather-tlbdx] POD 2023-06-05T07:45:47.809817753Z + echo 'Please check "/usr/bin/gather --help" for execution options.'
[must-gather-tlbdx] POD 2023-06-05T07:45:47.809817753Z Please check "/usr/bin/gather --help" for execution options.
[must-gather-tlbdx] POD 2023-06-05T07:45:47.809821660Z + exit 1
~~~

Suggestions for improvement:

We should run as below:

~~~
oc adm must-gather --image-stream=openshift/must-gather --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel8:v4.12.3 – /usr/bin/gather --vms_details
~~~

Also, refer https://github.com/kubevirt/must-gather#flags

Additional information:

This is applicable for both 4.12 and 4.13.