Unable to install VCF 9.1 due to missing compatibility metadata file
search cancel

Unable to install VCF 9.1 due to missing compatibility metadata file

book

Article ID: 450175

calendar_today

Updated On:

Products

VMware SDDC Manager / VCF Installer

Issue/Introduction

  • During VCF 9.1 installation, the "Deploy SDDC Manager" step fails at the "Configure Base Install Image Repository in SDDC Manager" task.

    Task: Configure Base Install Image Repository in SDDC Manager
    Metadata file /nfs/vmware/vcf/nfs-mount/compatibility/VmwareCompatibilityData.json does not exist Reference Token: ####

  • Checking the SDDC Manager via SSH confirms that /nfs/vmware/vcf/nfs-mount/compatibility/VmwareCompatibilityData.json does not exist
  • vvs.broadcom.com is unreachable from the SDDC Manager

Environment

VCF 9.1

Cause

The Compatibility directory and the required VmwareCompatibilityData.json file are missing from the NFS mount path /nfs/vmware/vcf/nfs-mount/compatibility/ because the environment lacks internet connectivity to reach vvs.broadcom.com.

Resolution

Follow the below steps to resolve the issue

  • Create the missing directory path on the NFS mount:

    mkdir -p /nfs/vmware/vcf/nfs-mount/compatibility/

  • From a Windows workstation/Linux Machine with internet access, manually download the VmwareCompatibilityData.json file.

    curl.exe --request GET --url "https://vvs.broadcom.com/v1/products/bundles/type/vcf-lcm-v2-bundle?format=json" --header "x-vmw-esp-clientid: vcf-lcm" > "C:\temp\VmwareCompatibilityData.json"

  • Command from Linux machine:

curl --request GET --url 'https://vvs.broadcom.com/v1/products/bundles/type/vcf-lcm-v2-bundle?format=json' --header 'x-vmw-esp-clientid: vcf-lcm' > /nfs/vmware/vcf/nfs-mount/compatibility/VmwareCompatibilityData.json

  • Transfer the downloaded VmwareCompatibilityData.json file to the  VCF environment and place it in the newly created directory: 

    /nfs/vmware/vcf/nfs-mount/compatibility/

  • Set the correct ownership and permissions on the directory and file so the LCM services can access it: 

    chown -R vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/compatibility/

  • Rerun the binary validation from the VCF Installer UI. The Binary Management section should now display a success status.