diff --git a/modules/migration-using-must-gather.adoc b/modules/migration-using-must-gather.adoc index 97c67a71b7..dac4316af5 100644 --- a/modules/migration-using-must-gather.adoc +++ b/modules/migration-using-must-gather.adoc @@ -2,7 +2,6 @@ // // * migrating_from_ocp_3_to_4/troubleshooting-3-4.adoc // * migration_toolkit_for_containers/troubleshooting-mtc.adoc -// * backup_and_restore/application_backup_and_restore/troubleshooting.adoc :_mod-docs-content-type: PROCEDURE [id="migration-using-must-gather_{context}"] @@ -12,26 +11,14 @@ You can collect logs, metrics, and information about {local-product} custom reso The `must-gather` data must be attached to all customer cases. -ifdef::troubleshooting-3-4,troubleshooting-mtc[] You can collect data for a one-hour or a 24-hour period and view the data with the Prometheus console. -endif::[] -ifdef::oadp-troubleshooting[] -You can run the `must-gather` tool with the following data collection options: -* Full `must-gather` data collection collects Prometheus metrics, pod logs, and Velero CR information for all namespaces where the OADP Operator is installed. -* Essential `must-gather` data collection collects pod logs and Velero CR information for a specific duration of time, for example, one hour or 24 hours. Prometheus metrics and duplicate logs are not included. -* `must-gather` data collection with timeout. Data collection can take a long time if there are many failed `Backup` CRs. You can improve performance by setting a timeout value. -* Prometheus metrics data dump downloads an archive file containing the metrics data collected by Prometheus. -endif::[] .Prerequisites * You must be logged in to the {product-title} cluster as a user with the `cluster-admin` role. * You must have the OpenShift CLI (`oc`) installed. -ifdef::oadp-troubleshooting[] -* You must use {op-system-base-full} {op-system-version-9} with {oadp-short} 1.4. -endif::[] .Procedure @@ -56,6 +43,7 @@ $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-g + This operation can take a long time. This command saves the data as the `must-gather/metrics/prom_data.tar.gz` file. endif::[] + ifdef::troubleshooting-mtc[] * To collect data for the past 24 hours, run the following command: + @@ -74,39 +62,3 @@ $ oc adm must-gather --image=registry.redhat.io/rhmtc/openshift-migration-must-g + This operation can take a long time. This command saves the data as the `must-gather/metrics/prom_data.tar.gz` file. endif::[] -ifdef::oadp-troubleshooting[] -* Full `must-gather` data collection, including Prometheus metrics: -+ -[source,terminal,subs="attributes+"] ----- -$ oc adm must-gather --image={must-gather-v1-4} ----- -+ -The data is saved as `must-gather/must-gather.tar.gz`. You can upload this file to a support case on the link:https://access.redhat.com/[Red Hat Customer Portal]. - -* Essential `must-gather` data collection, without Prometheus metrics, for a specific time duration: -+ -[source,terminal,subs="attributes+"] ----- -$ oc adm must-gather --image={must-gather-v1-4} \ - -- /usr/bin/gather_