Use the system-setup command of the cell management tool to initialize the server group's database with a system administrator account and related information.

The system-setup command is a command-line alternative to the vCloud Director Setup wizard described in the vCloud Director Installation and Upgrade Guide. After you configure all servers in the vCloud Director server group and connect them to the database, you can create the initial system administrator account and initialize the vCloud Director database with related information with a command line of the following form:

cell-management-tool system-setup  options

You cannot run this command on a system that has already been set up. All options except --unattended and --password must be specified.

Table 1. Cell Management Tool Options and Arguments, system-setup Subcommand

Option

Argument

Description

--help (-h)

None

Provides a summary of available commands in this category.

--email

The e-mail address for the system administrator you are creating.

The system administrator's email address is stored in the vCloud Director database.

--full-name

The full name of the system administrator you are creating.

The system administrator's full name is stored in the vCloud Director database.

--installation-id

An integer in the range 1-63

The installation ID for this installation of vCloud Director. If a datacenter includes multiple installations of vCloud Director, each installation must specify a unique installation ID. The system uses the installation ID when generating MAC addresses for virtual NICs.

--password

The password for the system administrator you are creating. Required when you use the --unattended option. If you do not use the --unattended option, the command prompts you for this password if you do not supply it on the command line.

The system administrator supplies this password when authenticating to vCloud Director.

--serial-number

The serial number (license key) for this installation.

Optional. Must be a valid vCloud Director serial number if supplied.

--system-name

The name to use a name for the vCloud Director vCenter Server folder.

This vCloud Director installation is represented by a folder with this name in each vCenter Server with which it registers.

--unattended

None

Optional. The command does not prompt for further input when invoked with this option.

--user

The user name of the system administrator you are creating.

The system administrator supplies this user name when authenticating to vCloud Director.

Specify vCloud Director System Settings

A command like this one specifies all system settings for a new vCloud Director installation. Because --unattended and --password are not specified, the command prompts you to supply and confirm the password to create for the system administrator.

[root@cell1 /opt/vmware/vcloud-director/bin]# ./cell-management-tool system-setup \
--user admin --full-name "VCD System Administrator" --email vcd-admin@example.com --system-name VCD --installation-id 2
Please enter the new password for user admin (password must have more than 6 characters): 

Re-enter the password to confirm: 

Username: admin
Full name: VCD System Administrator
Email: vcd-admin@example.com
System name: VCD
Installation ID: 2
Are you sure you want to use these parameters? [Y/n]:y
Creating admin user.
Setting system details.
Completing system setup.
System setup is complete.