Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion machine_configuration/mco-update-boot-images.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,6 @@ include::modules/mco-update-boot-images-configuring.adoc[leveloffset=+1]

include::modules/mco-update-boot-images-disable.adoc[leveloffset=+1]


[role="_additional-resources"]
.Additional resources
* xref:../machine_configuration/mco-update-boot-skew-mgmt.adoc#mco-update-boot-skew-mgmt[Boot image skew enforcement]
1 change: 1 addition & 0 deletions machine_configuration/mco-update-boot-skew-mgmt.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -28,3 +28,4 @@ include::modules/mco-update-boot-skew-mgmt-updating.adoc[leveloffset=+1]

* xref:../machine_configuration/mco-update-boot-images.adoc#mco-update-boot-images[Boot image management]
* xref:../machine_configuration/mco-update-boot-images-manual.adoc#mco-update-boot-images-manual[Manually updating the boot image]
* xref:../machine_configuration/mco-update-boot-images.adoc#mco-update-boot-images-configuring_machine-configs-configure[Enable boot image management]
6 changes: 6 additions & 0 deletions modules/mco-update-boot-images-disable.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ $ oc -n openshift-config patch cm admin-acks --patch '{"data":{"ack-4.21-boot-im

You disable the boot image management feature for the control plane or worker machine sets in your cluster by editing the `MachineConfiguration` object.

You cannot disable boot image management in a cluster where boot image skew enforcement is set to `Automatic`. You must first set boot image skew enforcement to `manual` or `none` before disabling boot image management. For more information, see "About boot image skew enforcement."

include::snippets/mco-update-boot-images-intro.adoc[]

Disabling this feature does not rollback the nodes or machine sets to the originally-installed boot image. The machine sets retain the boot image version that was present when the feature was disabled and is not updated if the cluster is upgraded to a new {product-title} version in the future. This feature has no effect on existing nodes.
Expand All @@ -36,6 +38,10 @@ If boot image management is disabled, you must update the boot image version tha

After disabling the feature, you can re-enable the feature at any time. For more information, see "Enabling updated boot images".

.Prerequisite

* Boot image skew enforcement is set to `manual` or `none`.

.Procedure

. Edit the `MachineConfiguration` object, named `cluster`, by using the following command::
Expand Down
5 changes: 5 additions & 0 deletions modules/mco-update-boot-skew-mgmt-configuring.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,11 @@ Alternatively, you can disable boot image skew enforcement by setting the `mode`

In {product-title} 4.22, the automatic mode is available only for {aws-short}, {gcp-short}, {azure-short}, and {vmw-short} clusters and is the default for these platforms. If you modify a cluster from the automatic mode to the manual or none mode, you can revert a cluster back to automatic mode only by removing the `bootImageSkewEnforcement` stanza from the `MachineConfiguration` object.

[NOTE]
====
You cannot revert a cluster back to `Automatic` if that cluster has the boot image management feature disabled. You must first enable boot image management before you can revert boot image skew enforcement back to `Automatic`. For more information, see "Enable boot image management".
====

All other platforms default to manual mode with the {product-title} version set as the boot image version in the `MachineConfiguration` object. In manual mode, you are expected to manually update the `MachineConfiguration` object with new boot image version whenever you update the boot image.

.Procedure
Expand Down