When you run the upgrade utility, you provide the setup information at the command line as options and arguments.

Table 1. Database Upgrade Utility Options and Arguments
Option Argument Description
--backup-completed None Specifies that you have completed a backup of the vCloud Director. When you include this option, the upgrade utility does not prompt you to back up the database.
--ceip-user The username for the CEIP service account. Upgrade will fail if a user with this username already exists in the System organization. Default: phone-home-system-account.
--enable-ceip Choose one:
  • true
  • false
Specifies whether this installation participates in the VMware Customer Experience Improvement Program (CEIP). Defaults to true if not provided and not set to false in the current configuration. VMware's Customer Experience Improvement Program ("CEIP") provides Additional information regarding the data collected through CEIP and the purposes for which it is used by VMware is set forth in the Trust & Assurance Center at http://www.vmware.com/trustvmware/ceip.html. You may use the cell management tool to join or leave VMware's CEIP for this product at any time. See "Cell Management Tool Reference" in vCloud Director Administrator's Guide.
--installer-path Full pathname to the vCloud Director installation file. The installation file and the directory in which it is stored must be readable by the user vcloud.vcloud.

This product participates in VMware’s Customer Experience Improvement Program (“CEIP”). Details regarding the data collected through CEIP and the purposes for which it is used by VMware are set forth in the Trust & Assurance Center at http://www.vmware.com/trustvmware/ceip.html. You can use the cell management tool to join or leave VMware's CEIP for this product at any time. See the "Cell Management Tool Reference" in the vCloud Director Administrator's Guide.

Requires --private-key-path option.
--maintenance-cell IP address The IP address of a cell for the upgrade utility to run in maintenance mode during the upgrade. This cell enters maintenance mode before the other cells are shut down and stays in maintenance mode while the other cells are upgraded. After the other cells are upgraded and at least one of them has re-started, this cell is shut down and upgraded. Requires --private-key-path option.
--multisite-user The username for the Multi-Site system account. This account is used by the vCloud Director Multi-Site feature. Upgrade will fail if a user with this username already exists in the System organization. Default: multisite-system-account.
--private-key-path pathname The full pathname to the cell's private key. When you use this option, all cells in the server group will be gracefully shut down, upgraded, and re-started after the database has been upgraded. See Perform an Orchestrated Upgrade of a vCloud Director Installation for more information about this upgrade workflow.
--unattended-upgrade None Specifies unattended upgrade
If you use the --private-key-path option, all cells must be configured to permit ssh connections from the superuser without a password. You can use a Linux command line like the one shown here to verify this. This example sets your identity to vcloud, then makes an ssh connection to the cell at cell-ip as root but does not supply the root password.
sudo -u vcloud ssh -i private-key-path root@cell-ip
If the private key in private-key-path on the local cell is readable by user vcloud.vcloud and the corresponding public key has been added to the authorized-keys file for the root user at cell-ip the command succeeds.
Note:

The vcloud user, vcloud group, and vcloud.vcloud account are created by the vCloud Director installer for use as an identity with which vCloud Director processes run. The vcloud user has no password.