mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
140 lines
7.8 KiB
Plaintext
140 lines
7.8 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * post_installation_configuration/machine-configuration-tasks.adoc
|
|
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="checking-mco-node-status-congifuring_{context}"]
|
|
= Checking machine config node status
|
|
|
|
During the update of a machine config pool (MCP), you can monitor the progress of all control plane and worker nodes in your cluster by using the `oc get machineconfignodes` and `oc describe machineconfignodes` commands. These commands provide information that can be helpful if issues arise during the update and you need to troubleshoot a node.
|
|
|
|
You cannot use these commands with custom machine config pools.
|
|
|
|
For more information on the meaning of these fields, see "About checking machine config node status."
|
|
|
|
.Prerequisites
|
|
|
|
* You enabled the required Technology Preview features for your cluster by editing the `FeatureGate` CR named `cluster`:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc edit featuregate cluster
|
|
----
|
|
+
|
|
.Example `FeatureGate` CR
|
|
[source,yaml]
|
|
----
|
|
apiVersion: config.openshift.io/v1
|
|
kind: FeatureGate
|
|
metadata:
|
|
name: cluster
|
|
spec:
|
|
featureSet: TechPreviewNoUpgrade
|
|
----
|
|
+
|
|
[WARNING]
|
|
====
|
|
Enabling the `TechPreviewNoUpgrade` feature set on your cluster cannot be undone and prevents minor version updates. This feature set allows you to enable these Technology Preview features on test clusters, where you can fully test them. Do not enable this feature set on production clusters.
|
|
====
|
|
+
|
|
After you save the changes, new machine configs are created, the machine config pools are updated, and scheduling on each node is disabled while the change is being applied.
|
|
|
|
.Procedure
|
|
|
|
* View the update status of all nodes in the cluster, including the current and desired machine configurations, by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get machineconfignodes
|
|
----
|
|
+
|
|
.Example output
|
|
[source,text]
|
|
----
|
|
NAME POOLNAME DESIREDCONFIG CURRENTCONFIG UPDATED
|
|
ci-ln-mdb23yt-72292-kzdsg-master-0 master rendered-master-f21b093d20f68a7c06f922ed3ea5fbc8 rendered-master-1abc053eec29e6c945670f39d6dc8afa False
|
|
ci-ln-mdb23yt-72292-kzdsg-master-1 master rendered-master-1abc053eec29e6c945670f39d6dc8afa rendered-master-1abc053eec29e6c945670f39d6dc8afa True
|
|
ci-ln-mdb23yt-72292-kzdsg-master-2 master rendered-master-1abc053eec29e6c945670f39d6dc8afa rendered-master-1abc053eec29e6c945670f39d6dc8afa True
|
|
ci-ln-mdb23yt-72292-kzdsg-worker-a-gfqjr worker rendered-worker-d0130cd74e9e576d7ba78ce166272bfb rendered-worker-8f61bf839898a4487c3b5263a430e94a False
|
|
ci-ln-mdb23yt-72292-kzdsg-worker-b-gknq4 worker rendered-worker-8f61bf839898a4487c3b5263a430e94a rendered-worker-8f61bf839898a4487c3b5263a430e94a True
|
|
ci-ln-mdb23yt-72292-kzdsg-worker-c-mffrx worker rendered-worker-8f61bf839898a4487c3b5263a430e94a rendered-worker-8f61bf839898a4487c3b5263a430e94a True
|
|
----
|
|
|
|
* View of all machine config node status fields for the nodes in your cluster by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get machineconfignodes -o wide
|
|
----
|
|
+
|
|
.Example output
|
|
[source,text]
|
|
----
|
|
NAME POOLNAME DESIREDCONFIG CURRENTCONFIG UPDATED UPDATEPREPARED UPDATEEXECUTED UPDATEPOSTACTIONCOMPLETE UPDATECOMPLETE RESUMED UPDATECOMPATIBLE UPDATEDFILESANDOS CORDONEDNODE DRAINEDNODE REBOOTEDNODE RELOADEDCRIO UNCORDONEDNODE
|
|
ci-ln-g6dr34b-72292-g9btv-master-0 master rendered-master-d4e122320b351cdbe1df59ddb63ddcfc rendered-master-6f2064fcb36d2a914de5b0c660dc49ff False True Unknown False False False True Unknown False False False False False
|
|
ci-ln-g6dr34b-72292-g9btv-master-1 master rendered-master-6f2064fcb36d2a914de5b0c660dc49ff rendered-master-6f2064fcb36d2a914de5b0c660dc49ff True False False False False False False False False False False False False
|
|
ci-ln-g6dr34b-72292-g9btv-master-2 master rendered-master-6f2064fcb36d2a914de5b0c660dc49ff rendered-master-6f2064fcb36d2a914de5b0c660dc49ff True False False False False False False False False False False False False
|
|
ci-ln-g6dr34b-72292-g9btv-worker-a-sjh5r worker rendered-worker-671b88c8c569fa3f60dc1a27cf9c91f2 rendered-worker-d5534cb730e5e108905fc285c2a42b6c False True Unknown False False False True Unknown False False False False False
|
|
ci-ln-g6dr34b-72292-g9btv-worker-b-xthbz worker rendered-worker-d5534cb730e5e108905fc285c2a42b6c rendered-worker-d5534cb730e5e108905fc285c2a42b6c True False False False False False False False False False False False False
|
|
ci-ln-g6dr34b-72292-g9btv-worker-c-gnpd6 worker rendered-worker-d5534cb730e5e108905fc285c2a42b6c rendered-worker-d5534cb730e5e108905fc285c2a42b6c True False False False False False False False False False False False False
|
|
----
|
|
|
|
* Check the update status of nodes in a specific machine config pool by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc get machineconfignodes $(oc get machineconfignodes -o json | jq -r '.items[]|select(.spec.pool.name=="<pool_name>")|.metadata.name') <1>
|
|
----
|
|
+
|
|
.Example output
|
|
[source,text]
|
|
----
|
|
NAME POOLNAME DESIREDCONFIG CURRENTCONFIG UPDATED
|
|
ci-ln-g6dr34b-72292-g9btv-worker-a-sjh5r worker rendered-worker-d5534cb730e5e108905fc285c2a42b6c rendered-worker-d5534cb730e5e108905fc285c2a42b6c True
|
|
ci-ln-g6dr34b-72292-g9btv-worker-b-xthbz worker rendered-worker-d5534cb730e5e108905fc285c2a42b6c rendered-worker-faf6b50218a8bbce21f1370866283de5 False
|
|
ci-ln-g6dr34b-72292-g9btv-worker-c-gnpd6 worker rendered-worker-faf6b50218a8bbce21f1370866283de5 rendered-worker-faf6b50218a8bbce21f1370866283de5 True
|
|
----
|
|
|
|
* Check the update status of an individual node by running the following command:
|
|
+
|
|
[source,terminal]
|
|
----
|
|
$ oc describe machineconfignode/<node_name>
|
|
----
|
|
+
|
|
.Example output
|
|
[source,text]
|
|
----
|
|
Name: <node_name>
|
|
Namespace:
|
|
Labels: <none>
|
|
Annotations: <none>
|
|
API Version: machineconfiguration.openshift.io/v1alpha1
|
|
Kind: MachineConfigNode
|
|
Metadata:
|
|
Creation Timestamp: 2023-10-17T13:08:58Z
|
|
Generation: 1
|
|
Resource Version: 49443
|
|
UID: 4bd758ab-2187-413c-ac42-882e61761b1d
|
|
Spec:
|
|
Node Ref:
|
|
Name: <node_name>
|
|
Pool:
|
|
Name: master
|
|
ConfigVersion:
|
|
Desired: rendered-worker-823ff8dc2b33bf444709ed7cd2b9855b
|
|
Status:
|
|
# ...
|
|
Message: Drained node. The drain is complete as the desired drainer matches current drainer: drain-rendered-worker-01f27f752eb84eba917450e43636b210
|
|
Reason: UpdateExecutedDrained
|
|
Status: True
|
|
Type: Drained
|
|
Last Transition Time: 2025-01-14T15:45:55Z
|
|
# ...
|
|
Config Version:
|
|
Current: rendered-master-8110974a5cea69dff5b263237b58abd8
|
|
Desired: rendered-worker-823ff8dc2b33bf444709ed7cd2b9855b
|
|
Observed Generation: 6
|
|
# ...
|
|
----
|