Skip to content

OSDOCS-5726: Added link to in install docs to vSphere automatic mig s… #59712

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bscott-rh merged 1 commit into from
May 11, 2023
Merged

OSDOCS-5726: Added link to in install docs to vSphere automatic mig s… #59712

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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 ...lling_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,9 @@ include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1]

* xref:../../installing/installing_vsphere/installing-restricted-networks-installer-provisioned-vsphere.adoc#deprecated-parameters-vsphere_installing-restricted-networks-installer-provisioned-vsphere[Deprecated VMware vSphere configuration parameters]

* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration_persistent-storage-csi-migration[CSI automatic migration]
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration-sc-vsphere_persistent-storage-csi-migration[vSphere automatic migration]

* xref:../../storage/container_storage_interface/persistent-storage-csi-vsphere.html#persistent-storage-csi-vsphere-top-aware_persistent-storage-csi-vsphere[VMware vSphere CSI Driver Operator]

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

Expand Down
4 changes: 3 additions & 1 deletion installing/installing_vsphere/installing-restricted-networks-vsphere.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,9 @@ include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1]

* xref:../../installing/installing_vsphere/installing-restricted-networks-vsphere.adoc#deprecated-parameters-vsphere_installing-restricted-networks-vsphere[Deprecated VMware vSphere configuration parameters]

* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration_persistent-storage-csi-migration[CSI automatic migration]
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration-sc-vsphere_persistent-storage-csi-migration[vSphere automatic migration]

* xref:../../storage/container_storage_interface/persistent-storage-csi-vsphere.html#persistent-storage-csi-vsphere-top-aware_persistent-storage-csi-vsphere[VMware vSphere CSI Driver Operator]

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

Expand Down
4 changes: 3 additions & 1 deletion ...installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,9 @@ include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1]

* xref:../../installing/installing_vsphere/installing-vsphere-installer-provisioned-customizations.adoc#deprecated-parameters-vsphere_installing-vsphere-installer-provisioned-customizations[Deprecated VMware vSphere configuration parameters]

* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration_persistent-storage-csi-migration[CSI automatic migration]
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration-sc-vsphere_persistent-storage-csi-migration[vSphere automatic migration]

* xref:../../storage/container_storage_interface/persistent-storage-csi-vsphere.html#persistent-storage-csi-vsphere-top-aware_persistent-storage-csi-vsphere[VMware vSphere CSI Driver Operator]

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

Expand Down
4 changes: 3 additions & 1 deletion ...ng_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,9 @@ include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1]

* xref:../../installing/installing_vsphere/installing-vsphere-installer-provisioned-network-customizations.adoc#deprecated-parameters-vsphere_installing-vsphere-installer-provisioned-network-customizations[Deprecated VMware vSphere configuration parameters]

* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration_persistent-storage-csi-migration[CSI automatic migration]
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration-sc-vsphere_persistent-storage-csi-migration[vSphere automatic migration]

* xref:../../storage/container_storage_interface/persistent-storage-csi-vsphere.html#persistent-storage-csi-vsphere-top-aware_persistent-storage-csi-vsphere[VMware vSphere CSI Driver Operator]

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

Expand Down
4 changes: 3 additions & 1 deletion installing/installing_vsphere/installing-vsphere-network-customizations.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,9 @@ include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1]

* xref:../../installing/installing_vsphere/installing-vsphere-network-customizations.adoc#deprecated-parameters-vsphere_installing-vsphere-network-customizations[Deprecated VMware vSphere configuration parameters]

* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration_persistent-storage-csi-migration[CSI automatic migration]
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration-sc-vsphere_persistent-storage-csi-migration[vSphere automatic migration]

* xref:../../storage/container_storage_interface/persistent-storage-csi-vsphere.html#persistent-storage-csi-vsphere-top-aware_persistent-storage-csi-vsphere[VMware vSphere CSI Driver Operator]

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

Expand Down
4 changes: 3 additions & 1 deletion installing/installing_vsphere/installing-vsphere.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,9 @@ include::modules/installation-vsphere-regions-zones.adoc[leveloffset=+1]

* xref:../../installing/installing_vsphere/installing-vsphere.adoc#deprecated-parameters-vsphere_installing-vsphere[Deprecated VMware vSphere configuration parameters]

* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration_persistent-storage-csi-migration[CSI automatic migration]
* xref:../../storage/container_storage_interface/persistent-storage-csi-migration.adoc#persistent-storage-csi-migration-sc-vsphere_persistent-storage-csi-migration[vSphere automatic migration]

* xref:../../storage/container_storage_interface/persistent-storage-csi-vsphere.html#persistent-storage-csi-vsphere-top-aware_persistent-storage-csi-vsphere[VMware vSphere CSI Driver Operator]

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

Expand Down
20 changes: 10 additions & 10 deletions modules/installation-vsphere-regions-zones.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ You can deploy an {product-title} cluster to multiple vSphere datacenters that r
====
The VMware vSphere region and zone enablement feature requires the vSphere Container Storage Interface (CSI) driver as the default storage driver in the cluster. As a result, the feature only available on a newly installed cluster.

A cluster that was upgraded from a previous release defaults to using the in-tree vSphere driver, so you must enable CSI automatic migration for the cluster. You can then configure multiple regions and zones for the upgraded cluster.
A cluster that was upgraded from a previous release defaults to using the in-tree vSphere driver, so you must enable CSI automatic migration for the cluster. You can then configure multiple regions and zones for the upgraded cluster.
====

The default installation configuration deploys a cluster to a single vSphere datacenter. If you want to deploy a cluster to multiple vSphere datacenters, you must create an installation configuration file that enables the region and zone feature.
Expand All @@ -27,15 +27,15 @@ The default `install-config.yaml` file includes `vcenters` and `failureDomains`
The following list describes terms associated with defining zones and regions for your cluster:

* Failure domain: Establishes the relationships between a region and zone. You define a failure domain by using vCenter objects, such as a `datastore` object. A failure domain defines the vCenter location for {product-title} cluster nodes.
* Region: Specifies a vCenter datacenter. You define a region by using a tag from the `openshift-region` tag category.
* Zone: Specifies a vCenter cluster. You define a zone by using a tag from the `openshift-zone` tag category.
* Region: Specifies a vCenter datacenter. You define a region by using a tag from the `openshift-region` tag category.
* Zone: Specifies a vCenter cluster. You define a zone by using a tag from the `openshift-zone` tag category.

[NOTE]
====
If you plan on specifying more than one failure domain in your `install-config.yaml` file, you must create tag categories, zone tags, and region tags in advance of creating the configuration file.
====

You must create a vCenter tag for each vCenter datacenter, which represents a region. Additionally, you must create a vCenter tag for each cluster than runs in a datacenter, which represents a zone. After you create the tags, you must attach each tag to their respective datacenters and clusters.
You must create a vCenter tag for each vCenter datacenter, which represents a region. Additionally, you must create a vCenter tag for each cluster than runs in a datacenter, which represents a zone. After you create the tags, you must attach each tag to their respective datacenters and clusters.

The following table outlines an example of the relationship among regions, zones, and tags for a configuration with multiple vSphere datacenters running in a single VMware vCenter.

Expand All @@ -45,18 +45,18 @@ The following table outlines an example of the relationship among regions, zones

.4+|us-east

.2+|us-east-1
.2+|us-east-1
|us-east-1a
|us-east-1b
.2+|us-east-2
|us-east-2a
.2+|us-east-2
|us-east-2a
|us-east-2b

.4+|us-west
.2+|us-west-1
.2+|us-west-1
|us-west-1a
|us-west-1b
.2+|us-west-2
|us-west-2a
|us-west-2b
|us-west-2a
|us-west-2b
|===