You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
= Configuring regions and zones for a VMware vCenter
13
-
You can modify the default installation configuration file, so that you can deploy an {product-title} cluster to multiple vSphere datacenters that run in a single VMware vCenter.
13
+
You can modify the default installation configuration file, so that you can deploy an {product-title} cluster to multiple vSphere data centers that run in a single VMware vCenter.
14
14
15
15
The default `install-config.yaml` file configuration from the previous release of {product-title} is deprecated. You can continue to use the deprecated default configuration, but the `openshift-installer` will prompt you with a warning message that indicates the use of deprecated fields in the configuration file.
16
16
@@ -24,7 +24,7 @@ The example uses the `govc` command. The `govc` command is an open source comman
24
24
+
25
25
[IMPORTANT]
26
26
====
27
-
You must specify at least one failure domain for your {product-title} cluster, so that you can provision datacenter objects for your VMware vCenter server. Consider specifying multiple failure domains if you need to provision virtual machine nodes in different datacenters, clusters, datastores, and other components. To enable regions and zones, you must define multiple failure domains for your {product-title} cluster.
27
+
You must specify at least one failure domain for your {product-title} cluster, so that you can provision data center objects for your VMware vCenter server. Consider specifying multiple failure domains if you need to provision virtual machine nodes in different data centers, clusters, datastores, and other components. To enable regions and zones, you must define multiple failure domains for your {product-title} cluster.
. Change to the directory that contains the installation program and initialize the cluster deployment according to your chosen installation requirements.
78
78
79
-
.Sample `install-config.yaml` file with multiple datacenters defined in a vSphere center
79
+
.Sample `install-config.yaml` file with multiple data centers defined in a vSphere center
Copy file name to clipboardExpand all lines: modules/cpmso-yaml-failure-domain-vsphere.adoc
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,9 +8,9 @@
8
8
9
9
On {vmw-full} infrastructure, the cluster-wide infrastructure Custom Resource Definition (CRD), `infrastructures.config.openshift.io`, defines failure domains for your cluster.
10
10
The `providerSpec` in the `ControlPlaneMachineSet` custom resource (CR) specifies names for failure domains that the control plane machine set uses to ensure control plane nodes are deployed to the appropriate failure domain.
11
-
A failure domain is an infrastructure resource made up of a control plane machine set, a vCenter datacenter, vCenter datastore, and a network.
11
+
A failure domain is an infrastructure resource made up of a control plane machine set, a vCenter data center, vCenter datastore, and a network.
12
12
13
-
By using a failure domain resource, you can use a control plane machine set to deploy control plane machines on separate clusters or datacenters.
13
+
By using a failure domain resource, you can use a control plane machine set to deploy control plane machines on separate clusters or data centers.
14
14
A control plane machine set also balances control plane machines across defined failure domains to provide fault tolerance capabilities to your infrastructure.
Copy file name to clipboardExpand all lines: modules/images-configuration-registry-mirror.adoc
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,7 +25,7 @@ Setting up repository mirroring can be done in the following ways:
25
25
26
26
* At {product-title} installation:
27
27
+
28
-
By pulling container images needed by {product-title} and then bringing those images behind your company's firewall, you can install {product-title} into a datacenter that is in a disconnected environment.
28
+
By pulling container images needed by {product-title} and then bringing those images behind your company's firewall, you can install {product-title} into a data center that is in a disconnected environment.
29
29
30
30
* After {product-title} installation:
31
31
+
@@ -53,6 +53,6 @@ requested from the source repository.
53
53
54
54
For new clusters, you can use IDMS, ITMS, and ICSP CRs objects as desired. However, using IDMS and ITMS is recommended.
55
55
56
-
If you upgraded a cluster, any existing ICSP objects remain stable, and both IDMS and ICSP objects are supported. Workloads using ICSP objects continue to function as expected. However, if you want to take advantage of the fallback policies introduced in the IDMS CRs, you can migrate current workloads to IDMS objects by using the `oc adm migrate icsp` command as shown in the *Converting ImageContentSourcePolicy (ICSP) files for image registry repository mirroring* section that follows. Migrating to IDMS objects does not require a cluster reboot.
56
+
If you upgraded a cluster, any existing ICSP objects remain stable, and both IDMS and ICSP objects are supported. Workloads using ICSP objects continue to function as expected. However, if you want to take advantage of the fallback policies introduced in the IDMS CRs, you can migrate current workloads to IDMS objects by using the `oc adm migrate icsp` command as shown in the *Converting ImageContentSourcePolicy (ICSP) files for image registry repository mirroring* section that follows. Migrating to IDMS objects does not require a cluster reboot.
Copy file name to clipboardExpand all lines: modules/installation-configuration-parameters.adoc
+13-13Lines changed: 13 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2692,7 +2692,7 @@ endif::vsphere[]
2692
2692
vsphere:
2693
2693
failureDomains:
2694
2694
region:
2695
-
|If you define multiple failure domains for your cluster, you must attach the tag to each vCenter datacenter. To define a region, use a tag from the `openshift-region` tag category. For a single vSphere datacenter environment, you do not need to attach a tag, but you must enter an alphanumeric value, such as `datacenter`, for the parameter.
2695
+
|If you define multiple failure domains for your cluster, you must attach the tag to each vCenter data center. To define a region, use a tag from the `openshift-region` tag category. For a single vSphere data center environment, you do not need to attach a tag, but you must enter an alphanumeric value, such as `datacenter`, for the parameter.
2696
2696
|String
2697
2697
2698
2698
|platform:
@@ -2706,7 +2706,7 @@ endif::vsphere[]
2706
2706
vsphere:
2707
2707
failureDomains:
2708
2708
zone:
2709
-
|If you define multiple failure domains for your cluster, you must attach a tag to each vCenter cluster. To define a zone, use a tag from the `openshift-zone` tag category. For a single vSphere datacenter environment, you do not need to attach a tag, but you must enter an alphanumeric value, such as `cluster`, for the parameter.
2709
+
|If you define multiple failure domains for your cluster, you must attach a tag to each vCenter cluster. To define a zone, use a tag from the `openshift-zone` tag category. For a single vSphere data center environment, you do not need to attach a tag, but you must enter an alphanumeric value, such as `cluster`, for the parameter.
2710
2710
|String
2711
2711
2712
2712
|platform:
@@ -2722,8 +2722,8 @@ endif::vsphere[]
2722
2722
failureDomains:
2723
2723
topology:
2724
2724
datacenter:
2725
-
|Lists and defines the datacenters where {product-title} virtual machines (VMs) operate.
2726
-
The list of datacenters must match the list of datacenters specified in the `vcenters` field.
2725
+
|Lists and defines the data centers where {product-title} virtual machines (VMs) operate.
2726
+
The list of data centers must match the list of data centers specified in the `vcenters` field.
2727
2727
|String
2728
2728
2729
2729
ifdef::vsphere[]
@@ -2758,9 +2758,9 @@ endif::agent[]
2758
2758
failureDomains:
2759
2759
topology:
2760
2760
folder:
2761
-
|Optional: The absolute path of an existing folder where the user creates the virtual machines, for example, `/<datacenter_name>/vm/<folder_name>/<subfolder_name>`.
2761
+
|Optional: The absolute path of an existing folder where the user creates the virtual machines, for example, `/<data_center_name>/vm/<folder_name>/<subfolder_name>`.
2762
2762
ifdef::vsphere[]
2763
-
If you do not provide this value, the installation program creates a top-level folder in the datacenter virtual machine folder that is named with the infrastructure ID. If you are providing the infrastructure for the cluster and you do not want to use the default `StorageClass` object, named `thin`, you can omit the `folder` parameter from the `install-config.yaml` file.
2763
+
If you do not provide this value, the installation program creates a top-level folder in the data center virtual machine folder that is named with the infrastructure ID. If you are providing the infrastructure for the cluster and you do not want to use the default `StorageClass` object, named `thin`, you can omit the `folder` parameter from the `install-config.yaml` file.
2764
2764
endif::vsphere[]
2765
2765
|String
2766
2766
@@ -2778,9 +2778,9 @@ endif::vsphere[]
2778
2778
topology:
2779
2779
resourcePool:
2780
2780
2781
-
|Optional: The absolute path of an existing resource pool where the installation program creates the virtual machines, for example, `/<datacenter_name>/host/<cluster_name>/Resources/<resource_pool_name>/<optional_nested_resource_pool_name>`.
2781
+
|Optional: The absolute path of an existing resource pool where the installation program creates the virtual machines, for example, `/<data_center_name>/host/<cluster_name>/Resources/<resource_pool_name>/<optional_nested_resource_pool_name>`.
2782
2782
ifdef::vsphere[]
2783
-
If you do not specify a value, the installation program installs the resources in the root of the cluster under `/<datacenter_name>/host/<cluster_name>/Resources`.
2783
+
If you do not specify a value, the installation program installs the resources in the root of the cluster under `/<data_center_name>/host/<cluster_name>/Resources`.
2784
2784
endif::vsphere[]
2785
2785
|String
2786
2786
@@ -2814,7 +2814,7 @@ endif::vsphere[]
2814
2814
vsphere:
2815
2815
vcenters:
2816
2816
datacenters:
2817
-
|Lists and defines the datacenters where {product-title} virtual machines (VMs) operate. The list of datacenters must match the list of datacenters specified in the `failureDomains` field.
2817
+
|Lists and defines the data centers where {product-title} virtual machines (VMs) operate. The list of data centers must match the list of data centers specified in the `failureDomains` field.
2818
2818
|String
2819
2819
2820
2820
|platform:
@@ -2880,7 +2880,7 @@ endif::vsphere[]
2880
2880
|platform:
2881
2881
vsphere:
2882
2882
datacenter:
2883
-
|Defines the datacenter where {product-title} virtual machines (VMs) operate.
2883
+
|Defines the data center where {product-title} virtual machines (VMs) operate.
2884
2884
|String
2885
2885
2886
2886
|platform:
@@ -2893,7 +2893,7 @@ endif::vsphere[]
2893
2893
vsphere:
2894
2894
folder:
2895
2895
|Optional: The absolute path of an existing folder where the installation program creates the virtual machines. If you do not provide this value, the installation program creates a folder that is named with the infrastructure ID in the data center virtual machine folder.
2896
-
|String, for example, `/<datacenter_name>/vm/<folder_name>/<subfolder_name>`.
2896
+
|String, for example, `/<data_center_name>/vm/<folder_name>/<subfolder_name>`.
2897
2897
2898
2898
ifdef::vsphere[]
2899
2899
|platform:
@@ -2922,8 +2922,8 @@ endif::vsphere[]
2922
2922
|platform:
2923
2923
vsphere:
2924
2924
resourcePool:
2925
-
|Optional: The absolute path of an existing resource pool where the installation program creates the virtual machines. If you do not specify a value, the installation program installs the resources in the root of the cluster under `/<datacenter_name>/host/<cluster_name>/Resources`.
2926
-
|String, for example, `/<datacenter_name>/host/<cluster_name>/Resources/<resource_pool_name>/<optional_nested_resource_pool_name>`.
2925
+
|Optional: The absolute path of an existing resource pool where the installation program creates the virtual machines. If you do not specify a value, the installation program installs the resources in the root of the cluster under `/<data_center_name>/host/<cluster_name>/Resources`.
2926
+
|String, for example, `/<data_center_name>/host/<cluster_name>/Resources/<resource_pool_name>/<optional_nested_resource_pool_name>`.
Copy file name to clipboardExpand all lines: modules/installation-initializing.adoc
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -333,7 +333,7 @@ The installation program connects to your vCenter instance.
333
333
+
334
334
[NOTE]
335
335
====
336
-
After you create the installation configuration file, you can modify the file to create a multiple vSphere datacenters environment. This means that you can deploy an {product-title} cluster to multiple vSphere datacenters that run in a single VMware vCenter. For more information about creating this environment, see the section named _VMware vSphere region and zone enablement_.
336
+
After you create the installation configuration file, you can modify the file to create a multiple vSphere data center environment. This means that you can deploy an {product-title} cluster to multiple vSphere data centers that run in a single VMware vCenter. For more information about creating this environment, see the section named _VMware vSphere region and zone enablement_.
0 commit comments