:_mod-docs-content-type: ASSEMBLY
[id="installing-vsphere-installer-provisioned-customizations"]
= Installing a cluster on vSphere with customizations
include::_attributes/common-attributes.adoc[]
:context: installing-vsphere-installer-provisioned-customizations
:platform: vSphere

toc::[]

[role="_abstract"]
In {product-title} version {product-version}, you can install a cluster on your
{vmw-first} instance by using installer-provisioned infrastructure with customizations, including network configuration options. In each, you modify parameters in the `install-config.yaml` file before you install the cluster.

By customizing your network configuration, your cluster can coexist with existing IP address allocations in your environment and integrate with existing MTU and VXLAN configurations.

You must set most of the network configuration parameters during installation, and you can modify only `kubeProxy` configuration parameters in a running cluster.

[id="prerequisites_installing-vsphere-installer-provisioned-customizations"]
== Prerequisites

* You have completed the tasks in "Preparing to install a cluster using installer-provisioned infrastructure".
* You reviewed your {vmw-short} platform licenses. Red{nbsp}Hat does not place any restrictions on your {vmw-short} licenses, but some {vmw-short} infrastructure components require licensing.
* You reviewed details about the {product-title} installation and update processes.
* You read the documentation on selecting a cluster installation method and preparing it for users.
* You provisioned persistent storage for your cluster. To deploy a private image registry, your storage must provide `ReadWriteMany` access modes.
* The {product-title} installer requires access to port 443 on the vCenter and ESXi hosts. You verified that port 443 is accessible.
* If you use a firewall, you confirmed with the administrator that port 443 is accessible. Control plane nodes must be able to reach vCenter and ESXi hosts on port 443 for the installation to succeed.
* If you use a firewall, you configured it to allow the sites that your cluster requires access to.
+
[NOTE]
====
Be sure to also review this site list if you are configuring a proxy.
====

include::modules/cluster-entitlements.adoc[leveloffset=+1]

include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1]

include::modules/installation-vsphere-regions-zones-host-groups.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources

* xref:../../../installing/installing_vsphere/installation-config-parameters-vsphere.adoc#installation-configuration-parameters-additional-vsphere_installation-config-parameters-vsphere[Additional {vmw-full} configuration parameters]

* xref:../../../installing/installing_vsphere/installation-config-parameters-vsphere.adoc#deprecated-parameters-vsphere_installation-config-parameters-vsphere[Deprecated {vmw-full} configuration parameters]

* xref:../../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration-sc-vsphere_persistent-storage-csi-migration[{vmw-short} automatic migration]

* xref:../../../storage/container_storage_interface/persistent-storage-csi-vsphere.adoc#persistent-storage-csi-vsphere-top-aware_persistent-storage-csi-vsphere[{vmw-full} CSI Driver Operator]

include::modules/installation-initializing.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources
* xref:../../../installing/installing_vsphere/installation-config-parameters-vsphere.adoc#installation-config-parameters-vsphere[Installation configuration parameters]

include::modules/installation-vsphere-config-yaml.adoc[leveloffset=+2]

include::modules/installation-configure-proxy.adoc[leveloffset=+2]

include::modules/ipi-install-modifying-install-config-for-dual-stack-network.adoc[leveloffset=+2]

include::modules/configuring-vsphere-regions-zones.adoc[leveloffset=+2]

include::modules/configuring-vsphere-host-groups.adoc[leveloffset=+2]

// Specifying multiple NICS
include::modules/installation-vsphere-multiple-nics.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* xref:../../../installing/installing_vsphere/installation-config-parameters-vsphere.adoc#installation-configuration-parameters-network_installation-config-parameters-vsphere[Network configuration parameters]

// Network configuration phases
include::modules/nw-network-config.adoc[leveloffset=+1]

// Specifying advanced network configuration
include::modules/nw-modifying-operator-install-config.adoc[leveloffset=+1]

// Specifying multiple subnets for your network
include::modules/nw-operator-vsphere-multiple-subnets.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* xref:../../../rest_api/config_apis/infrastructure-config-openshift-io-v1.adoc#spec-platformspec-vsphere-nodenetworking[`.spec.platformSpec.vsphere.nodeNetworking`]

// Cluster Network Operator configuration
include::modules/nw-operator-cr.adoc[leveloffset=+1]

// Services for a user-managed load balancer
include::modules/nw-osp-services-external-load-balancer.adoc[leveloffset=+1]

// Configuring a user-managed load balancer
include::modules/nw-osp-configuring-external-load-balancer.adoc[leveloffset=+2]

// Deploying the cluster
include::modules/installation-launching-installer.adoc[leveloffset=+1]

include::modules/cli-logging-in-kubeadmin.adoc[leveloffset=+1]

include::modules/registry-removed.adoc[leveloffset=+1]

include::modules/installation-registry-storage-config.adoc[leveloffset=+1]

include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+2]

include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* xref:../../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#registry-configuring-storage-vsphere_configuring-registry-storage-vsphere[Configuring the registry for vSphere]

include::modules/cluster-telemetry.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources

* xref:../../../support/remote_health_monitoring/about-remote-health-monitoring.adoc#about-remote-health-monitoring[About remote health monitoring]

include::modules/ipi-install-configure-network-components-to-run-on-the-control-plane.adoc[leveloffset=+1]

[role="_additional-resources"]
.Additional resources

* xref:../../../installing/installing_vsphere/ipi/ipi-vsphere-preparing-to-install.adoc#ipi-vsphere-preparing-to-install[Preparing to install a cluster using installer-provisioned infrastructure]
* xref:../../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update processes]
* xref:../../../installing/overview/installing-preparing.adoc#installing-preparing[Selecting a cluster installation method and preparing it for users]
* xref:../../../storage/understanding-persistent-storage.adoc#understanding-persistent-storage[Persistent storage]
* xref:../../../installing/install_config/configuring-firewall.adoc#configuring-firewall-module_configuring-firewall[Configuring your firewall to allow required sites]
* xref:../../../post_installation_configuration/cluster-tasks.adoc#available_cluster_customizations[Customize your cluster]
* xref:../../../support/remote_health_monitoring/remote-health-reporting.adoc#remote-health-reporting[Remote health reporting]
* xref:../../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Set up your registry and configure registry storage]
* xref:../../../installing/installing_vsphere/using-vsphere-problem-detector-operator.adoc#vsphere-problem-detector-viewing-events_vsphere-problem-detector[View the events from the {vmw-short} Problem Detector Operator to determine if the cluster has permission or storage configuration issues]
