mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
77 lines
2.5 KiB
Plaintext
77 lines
2.5 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * installing/installing-with-agent-based-installer/installing-with-agent-based-installer.adoc
|
|
// * installing/installing_with_agent_based_installer/installing-with-agent-basic.adoc
|
|
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="installing-ocp-agent-gather-log_{context}"]
|
|
= Gathering log data from a failed Agent-based installation
|
|
|
|
Use the following procedure to gather log data about a failed Agent-based installation to provide for a support case.
|
|
|
|
.Prerequisites
|
|
|
|
* You have configured a DNS record for the Kubernetes API server.
|
|
|
|
.Procedure
|
|
|
|
. Run the following command and collect the output:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ ./openshift-install --dir <installation_directory> agent wait-for bootstrap-complete --log-level=debug
|
|
----
|
|
+
|
|
.Example error message
|
|
[source,terminal]
|
|
----
|
|
...
|
|
ERROR Bootstrap failed to complete: : bootstrap process timed out: context deadline exceeded
|
|
----
|
|
|
|
. If the output from the previous command indicates a failure, or if the bootstrap is not progressing, run the following command to connect to the rendezvous host and collect the output:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ ssh core@<node-ip> agent-gather -O >agent-gather.tar.xz
|
|
----
|
|
+
|
|
[NOTE]
|
|
====
|
|
Red{nbsp}Hat Support can diagnose most issues using the data gathered from the rendezvous host, but if some hosts are not able to register, gathering this data from every host might be helpful.
|
|
====
|
|
|
|
. If the bootstrap completes and the cluster nodes reboot, run the following command and collect the output:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ ./openshift-install --dir <install_directory> agent wait-for install-complete --log-level=debug
|
|
----
|
|
|
|
. If the output from the previous command indicates a failure, perform the following steps:
|
|
|
|
.. Export the `kubeconfig` file to your environment by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ export KUBECONFIG=<install_directory>/auth/kubeconfig
|
|
----
|
|
|
|
.. Gather information for debugging by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc adm must-gather
|
|
----
|
|
|
|
.. Create a compressed file from the `must-gather` directory that was just created in your working directory by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ tar cvaf must-gather.tar.gz <must_gather_directory>
|
|
----
|
|
|
|
. Excluding the `/auth` subdirectory, attach the installation directory used during the deployment to your support case on the link:https://access.redhat.com[Red{nbsp}Hat Customer Portal].
|
|
|
|
. Attach all other data gathered from this procedure to your support case.
|