Performing VCF bring-up includes “feeding” Cloud Builder with all the information needed to deploy all the components automagically for you, including vCenter, vSAN, NSX, SDDC Manager and configuring all to actually work together. Sounds too good to be true, but it is… it is true indeed.
I personally like to use json files as it gives me an easier way to replace IPs, passwords, etc, as well as change size and a number of components. More on that later…
Once you deploy the Cloud Builder appliance, you can use the completed worksheet or you can use a json file. Cloud Builder provides a way to convert your Excel spreadsheet into a json file via a python script and also via SoS (Supportability and Serviceability) utility.
There is an official document on this procedure, and probably a couple of blog posts out there; however, there was a recent move to Python3, so the syntax has changed a bit.
Here are the steps to generate the json file with python3:
- Use a file transfer utility (WinSCP) to copy the Excel file to Cloud Builder.
- Log in with Cloud Builder admin account
- copy/past excel file from your computer to /home/admin
- Copy the Excel file from /home/admin to /opt/vmware/sddc-support using sudo command to gain access to the destination, or switch to root (su)
- sudo cp <file-name.xlsx> /opt/vmware/sddc-support
- Change directory to /opt/vmware/sddc-support and verify the xlsx file was copied successfully
- Then run the following command to generate the json file
- sudo python3 -m cloud_admin_tools.JsonGenerator.JsonGenerator -t cloud_admin_tools/JsonGenerator/template -d vcf-public-ems -i <file-name-path.xlsx>
- you can use -h to see other flags available
- you should see the json file being generated
- Navigate to your output location or if you used the default, navigate to /opt/vmware/Resources/<design chosen (vcf-ems, vcf-public-ems)>
- verify that you see the json file and you can then read it
- cat vcf-public-ems.json
- You may need to switch to root user to access the output directory.
- You can also assign a output directory with the flag -o or –output
- In this example I set the json file directory to be /home/admin/
- You can now export the file and use it as the input file during Cloud Builder bring-up workflow
SoS Utility Option
Instead of using the python option, you can also leverage the SoS utility by executing the following on the Cloud Builder appliance:
- SSH to Cloud Builder with admin account
- type su to switch to root, enter the root password
- Switch to the following directory /opt/vmware/sddc-support
- Run the following command
./sos --jsongenerator --jsongenerator-input <path-to-parameter-file> --jsongenerator-design vcf-public-ems
./sos --jsongenerator --jsongenerator-input /home/admin/poclab-ems-deployment-parameter.xlsx --jsongenerator-design vcf-public-ems
- If you already generated a json file prior to running this command it will ask you if you want to overwrite
- Once you run the SoS command, the json file will be located in /opt/vmware/sddc-support/cloud_admin_tools/Resources/vcf-public-ems