Initialize the Appliance by Using the Initialization API

The vSphere Integrated Containers appliance provides an API that allows you to initialize the appliance after deployment without having to manually enter information in the appliance welcome page. This API helps you to automate the deployment of appliances without manual intervention.

The appliance exposes the initialization API endpoint at https://vic_appliance_address:9443/register. If the vSphere Integrated Containers appliance was configured to expose the file server on a different port, 9443 is replaced with the appropriate port.

Prerequistes

You deployed an instance of the vSphere Integrated Containers appliance without completing the Platform Services Controller registration wizard that appears when you first go to the vSphere Integrated Containers appliance welcome page.

Procedure

1. On your usual working system, create a file named payload.json, to include information about your vSphere environment.

   vCenter Server with an embedded Platform Services Controller:

   {
   "target":"vcenter_server_address",
   "user":"sso_administrator_account",
   "password":"sso_administrator_password"
   "thumbprint":"vc_thumbprint"
   }

   vCenter Server with an external Platform Services Controller:

   {
   "target":"vcenter_server_address",
   "user":"sso_administrator_account",
   "password":"sso_administrator_password",
   "thumbprint":"vc_thumbprint"
   "externalpsc":"psc_address",
   "pscdomain":"psc_domain"
   }

2. Run a curl command to pass the payload.json file to the initialization API endpoint.

   Copy the command as shown, replacing vic_appliance_address with the address of the appliance.

   curl -k -w '%{http_code}' -d @payload.json https://vic_appliance_address:9443/register
   

   If successful, you see the message operation complete 200.

Result

The appliance initializes and registers with the Platforms Services Controller. After initialization, vSphere Integrated Containers services are available at https://vic_appliance_address:9443.

Example

Here is an example of a completed payload.json file:

{
  "target":"vcenter-server1.mycompany.org",
  "user":"Administrator@vsphere.local",
  "password":"p@ssw0rd!",
  "thumbprint":"12:34:F3:B2:85:2F:F7:95:B3:1E:99:F4:FB:28:4E:E7:5E:E0:5B:33",
  "externalpsc":"psc1.mycompany.org",
  "pscdomain":"vsphere.local"
}