7.3

Table Of Contents
The long list of command names and parameters is not reproduced in separate documentation. To use
the list effectively, identify a command of interest, and narrow your focus by entering the following
command.
vra-command help command-name
The vRealize Automation Installation API
The vRealize Automation REST API for installation gives you the ability to create purely software-
controlled installations for vRealize Automation.
The installation API requires a JSON formatted version of the same entries that the CLI based installation
obtains from the ha.properties answer file. The following guidelines familiarize you with how the API
works. From there, you should be able to design programmatic calls to the API to install
vRealize Automation.
n
To access the API documentation, point a Web browser to the following vRealize Automation
appliance page.
https://vrealize-automation-appliance-FQDN:5480/config
You need an unconfigured vRealize Automation appliance. See Deploy the vRealize Automation
Appliance.
n
To experiment with the API based installation, locate and expand the following PUT command.
PUT /vra-install
n
Copy the unpopulated JSON from the install_json box to a text editor. Fill in the answer values the
same way that you would for ha.properties. When your JSON formatted answers are ready, copy
the code back to install_json and overwrite the unpopulated JSON.
Alternatively, you can edit the following template JSON and copy the result to install_json.
/usr/lib/vcac/tools/install/installationProperties.json
You can also convert a completed ha.properties to JSON or vice versa.
n
In the action box, select validate and click Try It Out.
The validate action runs the vRealize Automation prerequisite checker and fixer.
n
The validate response includes an alphanumeric command ID that you can insert into the following
GET command.
GET /commands/command-id/aggregated-status
The response to the GET includes the progress of the validation operation.
n
When validation succeeds, you can run the actual installation by repeating the process. In the action
box, just select install instead of validate.
Installing vRealize Automation
VMware, Inc. 128