Preparing to install on VMC

Preparing to install on VMC

Prerequisites

You reviewed details about the OKD installation and update processes.
You read the documentation on selecting a cluster installation method and preparing it for users.
If you use a firewall and plan to use Telemetry, you configured the firewall to allow the sites required by your cluster.

Choosing a method to install OKD on VMC

You can install OKD on VMC by using installer-provisioned or user-provisioned infrastructure. The default installation type uses installer-provisioned infrastructure, where the installation program provisions the underlying infrastructure for the cluster. You can also install OKD on infrastructure that you provide. If you do not use infrastructure that the installation program provisions, you must manage and maintain the cluster resources yourself.

See the Installation process for more information about installer-provisioned and user-provisioned installation processes.

The steps for performing a user-provisioned infrastructure installation are provided as an example only. Installing a cluster with infrastructure you provide requires knowledge of the VMC platform and the installation process of OKD. Use the user-provisioned infrastructure installation instructions as a guide; you are free to create the required resources through other methods.

Installer-provisioned infrastructure installation of OKD on VMC

Installer-provisioned infrastructure allows the installation program to pre-configure and automate the provisioning of resources required by OKD.

Installing a cluster on VMC: You can install OKD on VMC by using installer-provisioned infrastructure installation with no customization.
Installing a cluster on VMC with customizations: You can install OKD on VMC by using installer-provisioned infrastructure installation with the default customization options.
Installing a cluster on VMC with network customizations: You can install OKD on installer-provisioned VMC infrastructure, with network customizations. You can customize your OKD network configuration during installation, so that your cluster can coexist with your existing IP address allocations and adhere to your network requirements.
Installing a cluster on VMC in a restricted network: You can install a cluster on VMC infrastructure in a restricted network by creating an internal mirror of the installation release content. You can use this method to deploy OKD on an internal network that is not visible to the internet.

User-provisioned infrastructure installation of OKD on VMC

User-provisioned infrastructure requires the user to provision all resources required by OKD.

Installing a cluster on VMC with user-provisioned infrastructure: You can install OKD on VMC infrastructure that you provision.
Installing a cluster on VMC with user-provisioned infrastructure and network customizations: You can install OKD on VMC infrastructure that you provision with customized network configuration options.
Installing a cluster on VMC in a restricted network with user-provisioned infrastructure: OKD can be installed on VMC infrastructure that you provision in a restricted network.

VMware vSphere infrastructure requirements

You must install the OKD cluster on a VMware vSphere version 6 or 7 instance that meets the requirements for the components that you use.

Table 1. Version requirements for vSphere virtual environments
Virtual environment product	Required version
VM hardware version	13 or later
vSphere ESXi hosts	6.5 or later
vCenter host	6.5 or later

Installing a cluster on VMware vSphere version 6.7U3 or earlier and virtual hardware version 13 is now deprecated. These versions are still fully supported, but version 4.11 of OKD will require vSphere virtual hardware version 15 or later. Hardware version 15 is now the default for vSphere virtual machines in OKD. To update the hardware version for your vSphere nodes, see the “Updating hardware on nodes running in vSphere” article.

If your vSphere nodes are below hardware version 15 or your VMware vSphere version is earlier than 6.7U3, upgrading from OKD 4.10 to OKD 4.11 is not available.

Table 2. Minimum supported vSphere version for VMware components
Component	Minimum supported versions	Description
Hypervisor	vSphere 6.5 and later with HW version 13	This version is the minimum version that Fedora CoreOS (FCOS) supports. See the Red Hat Enterprise Linux 8 supported hypervisors list.
Storage with in-tree drivers	vSphere 6.5 and later	This plug-in creates vSphere storage by using the in-tree storage drivers for vSphere included in OKD.

If you use a vSphere version 6.5 instance, consider upgrading to 6.7U3 or 7.0 before you install OKD.

You must ensure that the time on your ESXi hosts is synchronized before you install OKD. See Edit Time Configuration for a Host in the VMware documentation.

VMware vSphere CSI Driver Operator requirements

The following requirements must be met in order to install the CSI Driver Operator:

VMware vSphere version 6.7U3 or later
Virtual machines of hardware version 15 or later
No third-party CSI driver already installed in the cluster

If a third-party CSI driver is present in the cluster, OKD does not overwrite it. The presence of a third-party CSI driver prevents OKD from upgrading to 4.11.

Additional resources

To remove a third-party CSI driver, see Removing a third-party vSphere CSI Driver.

Uninstalling an installer-provisioned infrastructure installation of OKD on VMC

Uninstalling a cluster on VMC that uses installer-provisioned infrastructure: You can remove a cluster that you deployed on VMC infrastructure that used installer-provisioned infrastructure.