Cloud Director Installation and Configuration Guide Cloud Director 1.0.0 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
Cloud Director Installation and Configuration Guide You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com Copyright © 2010, 2011 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents About This Book 5 1 Overview of VMware Cloud Director Installation and Configuration 7 Cloud Director Architecture 7 Configuration Planning 8 About the Cloud Director Database 9 Cloud Director Hardware and Software Requirements 10 2 Creating a VMware Cloud Director Cluster 21 Install Cloud Director Software on the First Server Host 22 Configure Network and Database Connections 23 Start Cloud Director Services 25 Install Cloud Director Software on Additional Server Hosts 26 Create a Microsoft Sy
Cloud Director Installation and Configuration Guide 4 VMware, Inc.
About This Book ® The VMware Cloud Director Installation and Configuration Guide provides information about installing VMware Cloud Director software and configuring it to work with vCenter to provide VMware-ready Cloud services. Intended Audience This book is intended for anyone who wants to install and configure VMware Cloud Director software. The information in this book is written for experienced system administrators who are familiar with Linux, Windows, IP networks, and VMware vSphere.
Cloud Director Installation and Configuration Guide Services provides offerings to help you assess, plan, build, and manage your virtual environment. To access information about education classes, certification programs, and consulting services, go to http://www.vmware.com/services. 6 VMware, Inc.
Overview of VMware Cloud Director Installation and Configuration 1 ® A VMware Cloud Director cluster combines Cloud Director servers with the vSphere platform. You create a Cloud Director cluster by installing and configuring Cloud Director software on one or more server hosts, and then integrating the cluster with one or more installations of vSphere.
Cloud Director Installation and Configuration Guide Figure 1-1.
Chapter 1 Overview of VMware Cloud Director Installation and Configuration About the Cloud Director Database Cells in a Cloud Director cluster use a database to store shared information. This database must exist before you can complete installation and configuration of Cloud Director software. Database Configuration Parameters The database must be configured to allow at least 75 connections per Cloud Director cell plus about 50 for Oracle's own use.
Cloud Director Installation and Configuration Guide National Character Set The database must be configured to use the AL16UTF16 character set. Database Server Configuration A database server configured with 16GB of memory, 100GB storage, and 4 CPUs should be adequate for most Cloud Director clusters. Cloud Director Hardware and Software Requirements Each server host in a Cloud Director cluster must meet certain software and hardware requirements.
Chapter 1 Overview of VMware Cloud Director Installation and Configuration Table 1-5. Supported VMware Cloud Director Server Host Platforms Operating System Red Hat Enterprise Linux 5 (64 bit), Update 4 Red Hat Enterprise Linux 5 (64 bit), Update 5 Table 1-6 lists additional software that must be installed on each Cloud Director server host. These packages are typically installed by default with the operating system software. If any are missing, the installer fails with a diagnostic message. Table 1-6.
Cloud Director Installation and Configuration Guide Network Requirements The network that connects Cloud Director server hosts, the database server host, vCenter servers, and vShield Manager hosts, must meet several requirements: IP addresses Each Cloud Director server host requires two IP addresses, so that it can support two different SSL connections: one for the HTTP service and another for the console proxy service.
Chapter 1 Overview of VMware Cloud Director Installation and Configuration Table 1-8. Ports That Must Allow Incoming Packets From Cloud Director Hosts (Continued) Port Protocol Comments 61611 TCP ActiveMQ 61616 TCP ActiveMQ Table 1-9 lists the ports used for outgoing connections. Do not connect these ports to the public network. Table 1-9.
Cloud Director Installation and Configuration Guide Table 1-10. Browser Support on Microsoft Windows Platforms Platform Internet Explorer 7.* Internet Explorer 8.* Firefox 3.
Chapter 1 Overview of VMware Cloud Director Installation and Configuration Installing and Configuring vShield Manager Each Cloud Director cluster requires access to a vShield Manager host, which provides network services to the Cloud. Install and configure vShield Manager before you begin installing Cloud Director. You must have a unique instance of vShield Manager for each vCenter Server you add to Cloud Director.
Cloud Director Installation and Configuration Guide Table 1-13. SSL Certificate Information 4 Service Name IP Address Hostname (FQDN) HTTP 10.100.101.19 foo.example.com Console Proxy 10.100.101.20 bar.example.com Create the certificates. You can use signed certificates (signed by a trusted certification authority) or self-signed certificates. Signed certificates provide the highest level of trust. n To create signed certificates, see “Create and Import a Signed SSL Certificate,” on page 16.
Chapter 1 Overview of VMware Cloud Director Installation and Configuration What is the two-letter country code for this unit? [Unknown]:US Is CN=mycloud.example.com, OU=Engineering, O="Example Corporation", L="Palo Alto", ST=California, C=US correct?[no]: yes Enter key password for (RETURN if same as keystore password): 2 Create a certificate signing request for the HTTP service. This command creates a certificate signing request in the file http.csr. keytool -keystore certificates.
Cloud Director Installation and Configuration Guide 7 To verify that all the certificates have been imported, list the contents of the keystore file. keytool -storetype JCEKS -storepass passwd -keystore certificates.ks -list 8 Repeat this procedure to create certificates for each additional Cloud Director host. What to do next If you created the keystore file (certificates.
Chapter 1 Overview of VMware Cloud Director Installation and Configuration What is the two-letter country code for this unit? [Unknown]:US Is CN=mycloud.example.com, OU=Engineering, O="Example Corporation", L="Palo Alto", ST=California, C=US correct?[no]: yes Enter key password for (RETURN if same as keystore password): 2 Create an untrusted certificate for the console proxy service host. This command adds an untrusted certificate to the keystore file created in Step 1.
Cloud Director Installation and Configuration Guide 20 VMware, Inc.
Creating a VMware Cloud Director Cluster 2 A Cloud Director cluster consists of one or more server hosts. Each host in the cluster runs a group of services called a Cloud Director cell. To create a cluster, you install Cloud Director software on each server host and connect the host to a shared database.
Cloud Director Installation and Configuration Guide 7 If you plan to import users or groups from an LDAP service, the LDAP server host must be accessible to each Cloud Director server host. 8 Firewall ports must be opened as shown on Table 1-8 and Table 1-9. It is especially important that port 443 be open between Cloud Director and vCenter servers.
Chapter 2 Creating a VMware Cloud Director Cluster What to do next After the software is installed, the installer prompts you to run the configuration script. n To run the configuration script now, type y and press Enter. n To run the configuration script later, type n and press Enter to exit to the shell. For more information about running the configuration script, see “Configure Network and Database Connections,” on page 23.
Cloud Director Installation and Configuration Guide 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]:1 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.
Chapter 2 Creating a VMware Cloud Director Cluster The script validates the information you supplied, then continues with three more steps. 1 It initializes the database and connects this host to it. 2 It offers to start Cloud Director services on this host. 3 It displays a URL at which you can connect to the Cloud Director Setup wizard after Cloud Director service have started. This fragment shows a typical completion of the script. Connecting to the database: jdbc:oracle:thin:vcloud/vcloud@10.150.
Cloud Director Installation and Configuration Guide Procedure 1 Log in to the target host as root. 2 Open a console, shell, or terminal window and run the service command. service vmware-vcd start Install Cloud Director Software on Additional Server Hosts After you install and configure Cloud Director software on the first server host, you can add more server hosts to the cluster. All server hosts in a cluster must be configured with the same database connection details.
Chapter 2 Creating a VMware Cloud Director Cluster Create a Microsoft Sysprep Deployment Package Before vCloud Director can perform guest customization on virtual machines with certain Windows guest operating systems, you must create a Microsoft Sysprep deployment package on each cloud cell in your installation. During installation, vCloud Director places some files in the sysprep folder on the vCloud Director server host. Do not overwrite these files when you create the Sysprep package.
Cloud Director Installation and Configuration Guide 3 Open a console, shell, or terminal window and run the rpm utility. rpm -e vmware-cloud-director 28 VMware, Inc.
Cloud Director Setup 3 After all hosts in the Cloud Director cluster are installed and connected to the database, you can use the Cloud Director Setup wizard to initialize the cluster's database with a license key, system administrator account, and related information. After this wizard completes, you can use the Cloud Director Web Console to complete the initial provisioning of your Cloud. The Cloud Director Web Console provides a comprehensive set of tools for provisioning and managing a Cloud.
Cloud Director Installation and Configuration Guide Review the License Agreement Before you can configure this Cloud Director cluster, you must review and accept the end user license agreement. Procedure 1 Review the license agreement. 2 Accept or reject the agreement. n To accept the license agreement, click Yes, I accept the terms in the license agreement. n To reject the license agreement, click No, I do not accept the terms in the license agreement.
Chapter 3 Cloud Director Setup Specify System Settings Specify the system settings that control how this Cloud Director installation interacts with vSphere and vShield Manager. During the configuration process, the wizard creates a folder in vCenter for Cloud Director to use and specifies an installation ID for the supporting vShield Manager to use when creating MAC addresses for virtual NICs. Procedure 1 Enter a name for this Cloud Director installation vCenter folder in the System name field.
Cloud Director Installation and Configuration Guide 32 VMware, Inc.
Index B browsers, supported 13 C certificate self-signed 18 signed 16 cluster, to create 21 configuration, confirm settings and complete 31 System Name, to specify 31 T Technical Support, to obtain 5 V vCenter, supported releases 10 vShield Manager installing and configuring 15 supported releases 10 D database about 9 connection details 23 supported platforms 10 G guest customization, preparing 27 I installation of first host 22 of more hosts 26 to configure 29 uninstalling 27 Installation and capac
Cloud Director Installation and Configuration Guide 34 VMware, Inc.