Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1879180

Summary: [DOCS] Update docs to include
Product: OpenShift Container Platform Reporter: Morgan Peterman <morgan.peterman>
Component: DocumentationAssignee: Vikram Goyal <vigoyal>
Status: CLOSED DUPLICATE QA Contact: Xiaoli Tian <xtian>
Severity: medium Docs Contact: Vikram Goyal <vigoyal>
Priority: unspecified    
Version: 4.5CC: adahiya, aos-bugs, jokerman
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2020-09-15 16:56:48 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Morgan Peterman 2020-09-15 15:45:11 UTC
Description of problem:

OCP 4.5 Docs state that you need to create a folder in VMware using the name of the cluster specified in install-config.yaml.

'The folder name must match the cluster name that you specified in the install-config.yaml file.'

Starting in OCP 4.5 the `cloud-provider-config` no longer uses the Cluster Name and instead uses the infraID generated during the install as the expected folder name in VMware.

This will result in issues if a Customer follows the instructions and tries to deploy a PVC with the following error message: `Failed to provision volume with StorageClass "thin": folder '/LAB/vm/openshift-hkzhw' not found`


Version-Release number of selected component (if applicable): 4.5


Expected results:

Docs should provide instructions on how to obtain the infraID. At this time the only two places the infraID can be found is in the following two files in the install-dir.

metadata.json
.openshift_install_state.json

To extract the infraID you can run the following commands.


$ jq -r .infraID metadata.json
ocp45-hkzhw

$ cat .openshift_install_state.json | jq -r '."*installconfig.ClusterID".InfraID'
ocp45-hkzhw



Additional info:

Example OCP 4.5 cloud-provider-config showing the expected path:


apiVersion: v1
kind: ConfigMap
metadata:
  name: cloud-provider-config
  namespace: openshift-config
data:
  config: |
    [Global]
    secret-name = "vsphere-creds"
    secret-namespace = "kube-system"
    insecure-flag = "1"

    [Workspace]
    server = "vcenter.exmaple.com"
    datacenter = "DC"
    default-datastore = "datastore"
    folder = "/DC/vm/openshift-rwt29"

    [VirtualCenter "vcenter.exmaple.com"]
    datacenters = "DC"

Comment 2 Abhinav Dahiya 2020-09-15 16:56:48 UTC

*** This bug has been marked as a duplicate of bug 1849434 ***