From 91d3964bf9afb87fd39d6b48c62afdef371e06af Mon Sep 17 00:00:00 2001 From: Kevin Lamenzo Date: Mon, 30 Mar 2020 16:54:42 -0400 Subject: [PATCH] BZ1771435 gather data for restricted install --- ...talling-restricted-networks-preparations.adoc | 2 ++ ...estricted-cluster-to-gather-support-data.adoc | 16 ++++++++++++++++ modules/support-gather-data.adoc | 9 +++++++++ 3 files changed, 27 insertions(+) create mode 100644 modules/installation-preparing-restricted-cluster-to-gather-support-data.adoc diff --git a/installing/install_config/installing-restricted-networks-preparations.adoc b/installing/install_config/installing-restricted-networks-preparations.adoc index 9ac58f6444..636cdf372a 100644 --- a/installing/install_config/installing-restricted-networks-preparations.adoc +++ b/installing/install_config/installing-restricted-networks-preparations.adoc @@ -49,6 +49,8 @@ In production environments, add the required images to a registry in your restri include::modules/installation-mirror-repository.adoc[leveloffset=+1] +include::modules/installation-preparing-restricted-cluster-to-gather-support-data.adoc[leveloffset=+1] + include::modules/installation-restricted-network-samples.adoc[leveloffset=+1] .Next steps diff --git a/modules/installation-preparing-restricted-cluster-to-gather-support-data.adoc b/modules/installation-preparing-restricted-cluster-to-gather-support-data.adoc new file mode 100644 index 0000000000..b61857f2b3 --- /dev/null +++ b/modules/installation-preparing-restricted-cluster-to-gather-support-data.adoc @@ -0,0 +1,16 @@ +// Module included in the following assemblies: +// +// * installing/install_config/installing-restricted-networks-preparations.adoc + +[id="installation-preparing-restricted-cluster-to-gather-support-data_{context}"] += Preparing your cluster to gather support data + +Clusters using a restricted network must imporat the default must-gather image in order to gather debugging data for Red Hat support. The must-gather image is not imported by default, and clusters on a restricted network do not have access to the internet to pull the latest image from a remote repository. + +.Procedure + +. Import the default must-gather image from your installation payload: ++ +---- +$ oc import-image is/must-gather -n openshift +---- diff --git a/modules/support-gather-data.adoc b/modules/support-gather-data.adoc index 1a95921b53..b273876666 100644 --- a/modules/support-gather-data.adoc +++ b/modules/support-gather-data.adoc @@ -28,6 +28,15 @@ $ oc adm must-gather ==== If this command fails, for example if you cannot schedule a Pod on your cluster, then use the `oc adm inspect` command to gather information for particular resources. Contact Red Hat Support for the recommended resources to gather. ==== ++ +[NOTE] +==== +If your cluster is using a restricted network you must import the default must-gather image before running the `oc adm must-gather` command. + +---- +$ oc import-image is/must-gather -n openshift +---- +==== . Create a compressed file from the `must-gather` directory that was just created in your working directory. For example, on a computer that uses a Linux