Skip to content

Commit 6223dac

Browse files
committed
how-to: troubleshoot bootstrap CVO
1 parent 26e3765 commit 6223dac

2 files changed

Lines changed: 15 additions & 0 deletions

File tree

docs/dev/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,3 +144,4 @@ deployment.apps/cluster-version-operator patched
144144

145145
- [Feed custom upgrade graphs to CVO](feed-cvo-custom-graphs.md)
146146
- [Run local CVO against a remote cluster](run-cvo-locally.md)
147+
- [Troubleshoot CVO on the bootstrap node](troubleshoot-bootstrap-cvo.md)
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Troubleshoot CVO on the bootstrap node
2+
3+
In the OpenShift installation process, a CVO pod runs on the [bootstrap node](https://docs.redhat.com/en/documentation/openshift_container_platform/4.21/html/installation_overview/ocp-installation-overview#installation-process-details). The pod's manifest is defined in [bootstrap-pod.yaml](../../bootstrap/bootstrap-pod.yaml) which is slightly differently from the one created for the [CVO deployment](../../install/0000_00_cluster-version-operator_30_deployment.yaml) running on a control plane after installation.
4+
5+
To troubleshoot issues from the CVO pod on the bootstrap node, it is useful digging into the installer log and log-bundle. See [OpenShift documentation](https://docs.redhat.com/en/documentation/openshift_container_platform/4.21/html/validation_and_troubleshooting/installing-troubleshooting) for details about how they are collected.
6+
In CI jobs, they are usually collected by a step during installation, such as [ipi-install-install](https://steps.ci.openshift.org/reference/ipi-install-install). See `.openshift_install-1775655648.log` and `log-bundle-20260408134042.tar` in the following files:
7+
8+
```console
9+
$ ls -A
10+
.openshift_install-1775655648.log install-config.yaml
11+
clusterapi_output-1775655648 log-bundle-20260408134042.tar
12+
```
13+
14+
In "log-bundle", there are logs from the CVO pod and other manifests for inspection.

0 commit comments

Comments
 (0)