You can send HTTP requests to complete stage 2 of the deployment process of a newly deployed vCenter Server instance.
You set up a newly deployed vCenter Server instance by providing configuration settings in the body of the HTTP request.
Prerequisites
- Verify that the newly deployed vCenter Server instance is reachable.
- Verify that you have the correct credentials for sending HTTP requests.
Procedure
- Check whether the vCenter Server instance state is set to INITIALIZED.
GET https://<server>:5480/rest/vcenter/deployment
If the
vCenter Server instance is in the correct state, you receive a message body that contains the following line and you can continue with the setup process.
...
"state": "INITIALIZED",
...
- (Optional) Validate the configuration settings that you provide in the body of the HTTP request.
POST https://<server>:5480/rest/vcenter/deployment/install?action=check
The following example shows syntax that you can use in the body of the HTTP request.
{
"spec": {
"vcsa_embedded": {
"ceip_enabled": true,
"standalone": {
"sso_domain_name": "vsphere.local",
"sso_admin_password": "<your_password>"
}
},
"auto_answer": true
}
}
If the input is valid, you receive the following response.
{
"status": "SUCCESS"
}
- Initiate the setup process by providing valid input in the body of the HTTP request.
POST https://<server>:5480/rest/vcenter/deployment/install?action=start
- Monitor the progress of the setup process.
GET https://<server>:5480/rest/vcenter/deployment
The following example shows part of the response body when the setup process is ongoing.
{
"progress": {
"completed": 2,
"message": {
"id": "install.ciscommon.component.starting",
"args": [
"VMware Authentication Framework"
],
"default_message": "Starting VMware Authentication Framework..."
},
"total": 3
},
"status": "RUNNING",
"state": "CONFIG_IN_PROGRESS",
"operation": "INSTALL",
...
The following example shows part of the response body when the setup process has completed successfully.
{
"subtask_order": [
"rpminstall",
"validate",
"firstboot"
],
"cancelable": false,
"progress": {
"completed": 3,
"total": 3,
"message": {
"default_message": "Task has completed successfully.",
"id": "com.vmware.vcenter.deploy.task.complete.success",
"args": []
}
},
"status": "SUCCEEDED",
"description": {
"default_message": "Install vCenter Server.",
"id": "com.vmware.vcenter.deploy.task.description.op.install",
"args": []
},
"state": "CONFIGURED",
...
Results
You successfully configured the newly deployed
vCenter Server instance.