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.