---
# System prepended metadata

title: SPLAT-823 and changes to vSphere platform spec

---

# SPLAT-823 and changes to vSphere platform spec



- The existing platform below spec is depreciated and will be removed in a future release

```yaml
platform:
  vsphere:
    vcenter: "vcenter1"
    datacenter: "datacenter"
    defaultDatastore: "datastore1"
    cluster: "cluster1"
    network: "network1"
    password: ""
    username: ""
    resourcePool: "rp1"
    folder: "folder1"
```

- Replacement fields
```yaml
platform:
  vsphere:
    vcenters:
    - server: "test-server"
      port: 443
      username: "test-username"
      password: "test-password"
      datacenters:
      - "test-datacenter1"
      - "test-datacenter4"
    failureDomains:
    - name: "region-1-zone-1a"
      region: "region-1"
      zone: "zone-1a"
      server: "test-server"
      topology:
        datacenter: "test-datacenter1"
        computeCluster: "/test-datacenter1/host/test-computecluster1"
        networks:
        - "network1"
        datastore: "/test-datacenter1/datstore/test-datastore1"
        resourcePool:   ""
        folder:         ""
    - name: "region-2-zone-2a"
      region: "region-2"
      zone: "zone-2a"
      server: "test-server"
      topology:
        datacenter: "test-datacenter1"
        computeCluster: "/test-datacenter1/host/test-computecluster2"
        networks:
        - "network2"
        datastore: "/test-datacenter1/datastore/test-datastore2"
        resourcePool: ""
        folder: ""
    - name: "region-3-zone-3a"
      region: "region-3"
      zone: "zone-3a"
      server: "test-server"
      topology:
        datacenter: "test-datacenter1"
        computeCluster: "/test-datacenter1/host/test-computecluster3"
        networks:
        - "network3"
        datastore: "/test-datacenter1/datastore/test-datastore3"
        resourcePool:   "/test-datacenter1/host/test-computecluster3/Resources/test-resourcepool4"
        folder: ""
     - name:   "region-4-zone-4a"
       region: "region-4"
       zone:   "zone-4a"
       server: "test-server"
       topology:
         datacenter: "test-datacenter4"
         computeCluster: "/test-datacenter4/host/test-computecluster4"
         networks:
         - "network4"
         datastore: "/test-datacenter4/datastore/datastore4"
         resourcePool: ""
         folder: "/test-datacenter4/vm/test-folder4"   
```
Notes:
- currently vcenters can only be one entry
- Existing customers typically would need a single failure domain, at least one is required
- multiple failure domains would typically indicate using CCM or Storage zoning features _but_ a customer could potentially use multiple failure domains just for the ability to provision virtual machines in different datacenters, clusters, datastores (or folder and resource pool - but less likely)
- optional fields:
    - port
    - resourcePool
    - folder
- It is depreciated to use non-path vSphere topology fields (except datacenter and network). 
    - computeCluster: `/datacenter1/host/cluster1`
    - resourcePool: `/datacenter1/host/cluster1/Resources/resourcePool1`
    - folder: `/datacenter1/vm/folder1`
    - datastore: `/datacenter1/datastore/datstore1`
- Conversion from existing depreciated platform spec exists in the installer but will be removed in a future release


# Zoning 

- (need to look at existing docs)
- Still requires tag category: openshift-region, openshift-zone prior to installation
- still requires tags created and attached: openshift-region tag to a vCenter datacenter, openshift-zone tag to a vCenter cluster. The tag name are abaritary _but_ should equal to zone,regions within failureDomains.











