Skip to main content

Windows Machine Config Operator prerequisites

You can review the following information for details on the supported platform versions, Windows Server versions, and networking configurations for the Windows Machine Config Operator (WMCO). See the vSphere documentation for any information that is relevant to only that platform.

WMCO supported installation method​

The WMCO fully supports installing Windows nodes into installer-provisioned infrastructure (IPI) clusters. This is the preferred OpenShift Container Platform installation method.

For user-provisioned infrastructure (UPI) clusters, the WMCO supports installing Windows nodes only into a UPI cluster installed with the platform: none field set in the install-config.yaml file (bare-metal or provider-agnostic) and only for the BYOH (Bring Your Own Host) use case. UPI is not supported for any other platform.

WMCO supported platforms and Windows Server versions​

The following table lists the Windows Server versions that are supported by WMCO 10.20.0, based on the applicable platform. Windows Server versions not listed are not supported and attempting to use them will cause errors. To prevent these errors, use only an appropriate version for your platform.

Platform Supported Windows Server version
Amazon Web Services (AWS)
  • Windows Server 2025, OS Build 10.0.26100 or later
  • Windows Server 2022, OS Build 20348.681 or later [1]
  • Windows Server 2019, version 1809
Microsoft Azure
  • Windows Server 2025, OS Build 10.0.26100 or later
  • Windows Server 2022, OS Build 20348.681 or later
  • Windows Server 2019, version 1809
VMware vSphere
  • Windows Server 2025, OS Build 10.0.26100 or later
  • Windows Server 2022, OS Build 20348.681 or later
Google Cloud
  • Windows Server 2025, OS Build 10.0.26100 or later
  • Windows Server 2022, OS Build 20348.681 or later
Nutanix
  • Windows Server 2025, OS Build 10.0.26100 or later
  • Windows Server 2022, OS Build 20348.681 or later
Bare metal or provider agnostic
  • Windows Server 2025, OS Build 10.0.26100 or later
  • Windows Server 2022, OS Build 20348.681 or later
  1. For disconnected clusters, the Windows AMI must have the EC2LaunchV2 agent version 2.0.2107 or later installed. For more information, see "Install the latest version of EC2Launch v2 (AWS documentation)".

Supported networking​

Hybrid networking with OVN-Kubernetes is the only supported networking configuration. See the additional resources below for more information on this functionality. The following tables outline the type of networking configuration and Windows Server versions to use based on your platform. You must specify the network configuration when you install the cluster.

note
  • The WMCO does not support OVN-Kubernetes without hybrid networking or OpenShift SDN.
  • Dual NIC is not supported on WMCO-managed Windows instances.

Platform networking support

PlatformSupported networking
Amazon Web Services (AWS)Hybrid networking with OVN-Kubernetes
Microsoft AzureHybrid networking with OVN-Kubernetes
VMware vSphereHybrid networking with OVN-Kubernetes with a custom VXLAN port
Google CloudHybrid networking with OVN-Kubernetes
NutanixHybrid networking with OVN-Kubernetes
Bare metal or provider agnosticHybrid networking with OVN-Kubernetes

Hybrid OVN-Kubernetes Windows Server support

Hybrid networking with OVN-Kubernetes Supported Windows Server version
Default VXLAN port
  • Windows Server 2025, OS Build 10.0.26100 or later
  • Windows Server 2022, OS Build 20348.681 or later
  • Windows Server 2019, version 1809
Custom VXLAN port
  • Windows Server 2025, OS Build 10.0.26100 or later
  • Windows Server 2022, OS Build 20348.681 or later

Additional resources