You can install vCloud Availability for vCloud Director by running a single command and you are also given an option to participate in the installation process if needed. You can view the status of the installation, update the registry file, restart or resume the installation process, or run or skip a given task at any time.

Viewing the Installation Tasks and the Deployment State

After a successful pre-validation, the vCloud Availability Installer Appliance creates a list of installation and configuration tasks. The vCloud Availability Installer Appliance runs these tasks one at a time. Each task creates or configures vCloud Availability for vCloud Director VMs and containers.

To view the list of all numbered tasks required for a complete installation and configuration, you run the vcav status command at any time of the installation and configuration process. You can see the status of each task which can be Started or Not Started. For a started task, you can see when it was started. To view the endpoints related to each task, run the vcav status command with an extra --verbose argument.

Running a Single Task

You can run a single task by running the vcav next command. The vCloud Availability Installer Appliance detects the first task that is not completed and runs it.

You can indicate which task you want to run by adding the --task=Task-Number argument.

To rerun a task, you add the --rerun argument to the command.

You can add the following arguments to the vcav next command.

Argument

Description

Default Value

--overwrite

Overwrite existing VMs or containers

False

--no-overwrite

Do not overwrite existing VMs or containers

True

--reconfigure

Reconfigure VMs or containers

False

--no-reconfigure

Do not reconfigure VMs or containers

True

--unregister-hms-extension

Unregister existing HMS extensions

False

--no-unregister-hms-extension

Do not unregister existing HMS extensions

True

Skipping a Single Task

To skip a task, run the vcav skip --task =Task-Number command.

Resuming the Installation Process

If the installation and configuration process is interrupted, you can resume it to the last completed task by running the vcav resume command. If a command fails, you can run the vcav resume command and rerun the failed command.

Restarting the Installation Process

To restart the installation and configuration process, run the vcav cancel command.

By running this command, you force the list of tasks to be cleaned. Then you must start a new deployment.

Updating the Registry File During the Installation Process

If you need to add or remove entries from the registry file after the installation start, without removing any existing VMs and configuration, you must update the task list. In this case, you run the vcav cancel command and do the necessary changes in the registry file. To resume the installation and configuration process, run the vcav prevalidate command and add the --no-overwrite --no-reconfigure arguments.

Handling Installation Errors

If the deployment fails during the execution of a single task, resolve the issue causing the error and resume the installation process by running the vcav resume command.

In there is an error, you can see the log file .vcav/vcav.log. You can check the log of the affected appliance. For more information, see Service Provider Diagnostics.

Getting the IP Addresses of the Components

To get the IP addresses of all vCloud Availability for vCloud Director components, run the vcav registry list-endpoints command.