Chapter 2. Troubleshooting installation issues

Procedure

1. Generate the commands that are required to obtain the installation logs from the bootstrap and control plane machines:

   • If you used installer-provisioned infrastructure, change to the directory that contains the installation program and run the following command:

     $ ./openshift-install gather bootstrap --dir <installation_directory>

     The installation_directory placeholder is for the directory you specified when you ran ./openshift-install create cluster. This directory contains the OpenShift Container Platform definition files that the installation program creates.

     For installer-provisioned infrastructure, the installation program stores information about the cluster, so you do not specify the hostnames or IP addresses.

   • If you used infrastructure that you provisioned yourself, change to the directory that contains the installation program and run the following command:

     $ ./openshift-install gather bootstrap --dir <installation_directory> \
         --bootstrap <bootstrap_address> \
         --master <master_1_address> \
         --master <master_2_address> \
         --master <master_3_address>

     where:

     • installation_directory:: Specifies the same directory you specified when you ran ./openshift-install create cluster. This directory contains the OpenShift Container Platform definition files that the installation program creates.
     • <bootstrap_address>:: Specifies the fully qualified domain name or IP address of the cluster’s bootstrap machine.

     • <master_*_address>:: For each control plane, or master, machine in your cluster, replace this placeholder with its fully qualified domain name or IP address.

       Note

       A default cluster contains three control plane machines. List all of your control plane machines as shown, no matter how many your cluster uses.

     Example output

     INFO Pulling debug logs from the bootstrap machine
     INFO Bootstrap gather logs captured here "<installation_directory>/log-bundle-<timestamp>.tar.gz"

     If you open a Red Hat support case about your installation failure, include the compressed logs when opening a Red Hat support case.

Procedure

1. Collect the bootkube.service service logs from the bootstrap host by entering the journalctl command:

   $ journalctl -b -f -u bootkube.service

2. Collect the container logs of the bootstrap host by using the podman logs. Podman logs are shown as a loop to get all of the container logs from the host.

   $ for pod in $(sudo podman ps -a -q); do sudo podman logs $pod; done

3. Alternatively, collect the container logs of the host by entering the tail command:

   # tail -f /var/lib/containers/storage/overlay-containers/*/userdata/ctr.log

4. Collect the kubelet.service and crio.service service logs from the control plane and compute hosts using the journalctl command by running:

   $ journalctl -b -f -u kubelet.service -u crio.service

5. Collect the control plane and compute host container logs by entering the tail command:

   $ sudo tail -f /var/log/containers/*

Procedure

1. Access journald unit logs under /var/log by running:

   $ oc adm node-logs --role=master -u kubelet

2. Access host file paths under /var/log by running:

   $ oc adm node-logs --role=master --path=openshift-apiserver

Procedure

1. Destroy the cluster and remove all the resources associated with the cluster, including the hidden installer state files in the installation directory:

   $ ./openshift-install destroy cluster --dir <installation_directory>

   Where <installation_directory> is the directory you specified when you ran ./openshift-install create cluster. This directory contains the OpenShift Container Platform definition files that the installation program creates.

2. Before reinstalling the cluster, delete the installation directory by running a command similar to the following command:

   $ rm -rf <installation_directory>

3. Follow the procedure for installing a new OpenShift Container Platform cluster.