On August 24th VMware released VMware Cloud Foundation 4.3, and along with this release a small change was introduced concerning the JSON file used by VMware Cloud Builder to perform the management domain bring-up.
This change involves the JSON file generated from the Deployment Parameter Workbook being immediately deleted from the file system (usually stored under /opt/vmware/sddc-support/cloud_admin_tools/Resources/vcf-ems/) as its already automatically stored in the database where it’s used by the bring-up service.
The knock-on affect here is that it’s no longer then possible to retrieve the generated JSON from the VMware Cloud Builder appliance after uploading the Deployment Parameter Workbook using the UI so that you can either modify it in case of issues found during the validation process or use it for additional use-cases such as:
- Adding more than four ESXi hosts
- Adding multi-pNIC configuration
All is not lost, as its still possible to generate the JSON file manually using the following simple process.
Manually Generate JSON File
Step 1 – Connect to the VMware Cloud Builder appliance as admin using WinSCP and transfer your completed Deployment Parameter Workbook to /tmp
Step 2 – Connect to the VMware Cloud Builder appliance using and SSH client such as Putty using the admin user.
Step 3 – Enter su to switch to the root user and enter the password.
Step 4 – Execute the following command replacing <path-to-xls> with the path to your uploaded Deployment Parameter file.
/opt/vmware/sddc-support/sos –jsongenerator –jsongenerator-input <path-to-xls> –jsongenerator-design vcf-ems
NOTE: For VCF on VxRail use -jsongenerator-design vcf-vxrail
Step 5 – Move the generated JSON file to the /tmp folder using the following command:
mv /opt/vmware/sddc-support/cloud_admin_tools/Resources/vcf-ems/vcf-ems.json /tmp
Step 6 – Change the access to the file so that you can transfer the file out as the admin user.
chmod 644 /tmp/vcf-ems.json
Step 7 – Now you have a copy of the JSON file, you can modify as required and then upload via the VMware Cloud Builder UI instead of the Deployment Parameter Workbook file.