After vCloud Director software is installed on the server, the installer prompts you to run a script that configures the server's network and database connections.

About this task

You must install vCloud Director software on the server before you can run the configuration script. The installer prompts you to run the script after installation is finished, but you can choose to run it later.

To run the script after the vCloud Director software is installed, log in as root, open a console, shell, or terminal window, and enter the configure command:

/opt/vmware/vcloud-director/bin/configure

The configuration script creates network and database connections for a single vCloud Director server. The script also creates a response file that preserves database connection information for use in subsequent server installations.

Important:

After you run the configuration script to configure the first member of the server group, you must use the -r option and specify the response file pathname when configuring additional members of the group. See Protecting and Reusing the Response File.

You can run the configuration script in either an interactive mode or an unattended mode. This procedure describes interactive configuration. For an example of unattended configuration, see Unattended Configuration.

Prerequisites

Procedure

  1. Specify the IP addresses to use for the HTTP and console proxy services running on this host.

    Each member of a server group must support two SSL endpoints: one for the HTTP service and another for the console proxy service. To begin the configuration process, choose which of the IP addresses discovered by the script to use as the endpoint for each service.

    Please indicate which IP address available on this machine should be used 
    for the HTTP service and which IP address should be used for the remote console proxy.
    
    The HTTP service IP address is used for accessing the user interface and the REST API.
    The remote console proxy IP address is used for all remote console (VMRC) connections
    and traffic.
    Please enter your choice for the HTTP service IP address:
        1: 10.17.118.158
        2: 10.17.118.159
    Choice [default=1]:2
    Please enter your choice for the remote console proxy IP address
        1: 10.17.118.158
        Choice [default=1]:
    Note:

    If you need to use a single IP address with a port for each service, you must run configure in unattended mode. See Unattended Installation Specifying a Single IP Address.

  2. Specify the full path to the Java keystore file.
    Please enter the path to the Java keystore containing your SSL certificates and
    private keys:/opt/keystore/certificates.ks
  3. Enter the keystore and certificate passwords.
    Please enter the password for the keystore:
    Please enter the private key password for the 'http' SSL certificate:
    Please enter the private key password for the 'consoleproxy' SSL certificate:
    
  4. Configure audit message handling options.

    Services in each vCloud Director cell log audit messages to the vCloud Director database, where they are preserved for 90 days. To preserve audit messages longer, you can configure vCloud Director services to send audit messages to the syslog utility in addition to the vCloud Director database.

    Option

    Action

    To log audit messages to both syslog and the vCloud Director database

    Enter the syslog host name or IP address.

    To log audit messages only to the vCloud Director database

    Press Enter.

    If you would like to enable remote audit logging to a syslog
    host please enter the hostname or IP address of the syslog server. Audit logs are stored by
    vCloud Director for 90 days. Exporting logs via syslog will enable you to
    preserve them for as long as necessary.
     
    Syslog host name or IP address [press Enter to skip]:10.150.10.10
  5. Specify the port on which the syslog process monitors the specified server.

    The default is port 514.

    What UDP port is the remote syslog server listening on? The
    standard syslog port is 514. [default=514]:
    Using default value "514" for syslog port.
  6. Specify the database type, or press Enter to accept the default value.
    The following database types are supported:
           1. Oracle
           2. Microsoft SQL Server
           3. PostgreSQL
    Enter the database type [default=1]:
    Using default value "1" for database type.
  7. Specify database connection information.
    1. Enter the host name or IP address of the database server.
      Enter the host (or IP address) for the database:10.150.10.78
    2. Provide database-specific information.

      Some of the information that the script requires depends on your choice of database type.

      • Oracle database:

        1. Enter the database port, or press Enter to accept the default value.

          Enter the database port [default=1521]:
          Using default value "1521" for port.
        2. Enter the database service name.

          Enter the database service name [default=oracle]:orcl.example.com

          If you press Enter, the configuration script uses a default value, which might not be correct for some installations. For information about how to find the database service name for an Oracle database, see Configure an Oracle Database.

      • Microsoft SQL Server database:

        1. Enter the database port, or press Enter to accept the default value.

          Enter the database port [default=1433]:
          Using default value "1433" for port.
        2. Enter the database name.

          Enter the database name [default=vcloud]:
        3. Enter the database instance, or press Enter to use the server's default instance.

          Enter the database instance [Press enter to use the server's default instance]:
          Using the default instance.
    3. Enter the database user name and password.
      Enter the database username:vcloud
      Enter the database password:
    4. (Optional) : Specify whether to enable SSL for PostgreSQL database connections.

      You can require the system to use SSL when connecting to a PostgreSQL database type. Connections that use SSL are more secure than those that do not.

      Enable SSL for database connections? [y/N] y
    5. (Optional) : If you have enabled SSL for PostgreSQL database connections, you can enter the pathname of a PEM-encoded certificate for the system to use when authenticating those connections.

      If you have a signed certificate from the database host and would like to import it now, enter the pathname. Otherwise, press Enter to use the cell's default Java truststore.

      Enter path to a PEM file containing the database certificate: /tmp/server.crt
  8. Specify whether this installation participates in the VMware Customer Experience Improvement Program (CEIP).

    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.

    If you prefer not to join VMware's CEIP for this product, enter n in response to the prompt.

    VMware’s Customer Experience Improvement Program (“CEIP”) provides 
    VMware with information that enables VMware to improve its products and services ... 
    ...
    Join the VMware Customer Experience Improvement Program [y/n]:y

What to do next

The script validates the information that you supplied, then continues with three more steps.

  1. It initializes the database and connects the server to it.

  2. It offers to start the vCloud Director service (the cell).

  3. It displays a URL at which you can connect to the Setup wizard after vCloud Director service starts.

This fragment shows output from a typical completion of the script.

Connecting to the database: jdbc:oracle:thin:vcloud/vcloud@10.150.10.78:1521/vcloud
...........
Database configuration complete.
Once the vCloud Director server has been started you will be able to 
access the first-time setup wizard at this URL:

    https://vcloud.example.com

Would you like to start the vCloud Director service now? If you choose not
to start it now, you can manually start it at any time using this command:
    service vmware-vcd start
Start it now? [y/n]:y
Starting vmware-vcd-watchdog:                              [  OK  ]
Starting vmware-vcd-cell                                   [  OK  ]

The vCD service will be started automatically on boot.
To disable this, use the following command: chkconfig --del vmware-vcd"
Note:

Database connection information and other reusable responses that you supplied during configuration are preserved in a file at /opt/vmware/vcloud-director/etc/responses.properties on this server. This file contains sensitive information that you must reuse when you add servers to a server group. Preserve the file in a secure location, and make it available only when needed.

To add servers to this group, see Install vCloud Director Software on Additional Members of a Server Group.

After vCloud Director services are running on all servers, you must initialize the server group's database with a license key, system administrator account, and related information. You can initialize the database in one of the following ways:

  • Using a Web browser, open the Setup wizard at the URL displayed when the script finishes. See vCloud Director Setup.

  • Use the cell management tool system-setup subcommand. See "Cell Management Tool Reference" in vCloud Director Administrator's Guide.