“File with Compatibility Matrix Content for Compatibility controller VMWARE_COMPAT is not found.” during VCF Deployment or Patching

Products

• VMware SDDC Manager / VCF Installer

Issue/Introduction

• VCF deployment or upgrade fails during validation/pre-check.
  
  
• The following is seen on the Validate/Deploy page on VCF Installer : 
  Failed to retrieve Compatibility Matrix: File with Compatibility Matrix Content for Compatibilty controller VMWARE_COMPAT is not found.
Remediation: Please, make sure Compatibility Matrix is downioaded to VCF Installer. It is located in:/nfs/vmware/vcf/nfs-mount/compatibiity/VmwareCompatibilityDatajson. For troubleshooting.
Please check the following KB Article: https://knowledge.broadcom.com/external/article/403530/getting-error-failed-to-retrieve-compati.html

  
  
  
• The following log entries can be observed in /var/log/vmware/vcf/domainmanager/domainmanager.log

{"errorCode":"BROWNFIELD_VSPHERE_CHECK.error","arguments":["Compatibility validation","VcManager vcenter.example.com: An error occurred when validating VMware Cloud Foundation compatibility: File with Compatibility Matrix Content for Compatibility controller VMWARE_COMPAT is not found.","Please refer to error message above and contact support for more details."],"context":{"severity":"ERROR","bundleName":"com.vmware.evo.sddc.common.validation.errors.messages","validation.taskId":"########-####-####-###-#######059"},"message":"VcManager vcenter.example.com: An error occurred when validating VMware Cloud Foundation compatibility: File with Compatibility Matrix Content for Compatibility controller VMWARE_COMPAT is not found.","remediationMessage":"Please refer to error message above and contact support for more details."},
  
  
• This can also be seen while upgrading the SDDC Manager 5.x.

Cause

• The compatibility directory or the VmwareCompatibilityData.json metadata file is missing from the local SDDC Manager repository.
  
  
• This can be validated by connecting to the SDDC Manager using SSH and listing the directory, the following output is seen : 

ls -althr /nfs/vmware/vcf/nfs-mount/compatibility
ls: cannot access '/nfs/vmware/vcf/nfs-mount/compatibility': No such file or directory               ======>>>>>

Resolution

1. Connect to the SDDC Manager over SSH as vcf user and elevate to the root user access using the command su -
2. Create the compatibility directory : 
   mkdir /nfs/vmware/vcf/nfs-mount/compatibility
3. Download VmwareCompatibilityData.json file using the following curl command (use -k flag if the download fails with connection refused) : 
   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
4. Change the permission on the directory using the following command : 
   chown -R vcf_lcm:vcf /nfs/vmware/vcf/nfs-mount/compatibility
5. Re-run the validation from the installer.

Additional Information

Japanese KB: 新しい VCF インスタンスをデプロイすると、次のエラーが発生します。“VcManager vc1.example.com: An error occurred when validating VMware Cloud Foundation compatibility: File with Compatibility Matrix Content for Compatibility controller VMWARE_COMPAT is not found.”