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 Getting Started page. This API helps you to automate the deployment of appliances without manual intervention.

The appliance exposes the initialization API endpoint at http://vic_appliance_address:9443/register.

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 http://vic_appliance_address.

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"
   }

   vCenter Server with an external Platform Services Controller:

   {
   "target":"vcenter_server_address",
   "user":"sso_administrator_account",
   "password":"sso_administrator_password",
   "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 http://vic_appliance_address.

Example

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

{
  "target":"vcenter-server1.mycompany.org",
  "user":"Administrator@vsphere.local",
  "password":"p@ssw0rd!",
  "externalpsc":"psc1.mycompany.org",
  "pscdomain":"vsphere.local"
}