Quick Installation Guide

Eucalyptus 2.0.3 on CentOS 5.7

David Kavanagh

This guide provides instructions for a single-cluster deployment of Eucalyptus Open Source release 2.0.3 on a two-machine system running CentOS 5.7. Only one network mode is supported for these scripts: MANAGED_NOVLAN (which gives the administrator more functionality with less network configuration requirements).

Prerequisites
Eucalyptus consists of the following distributed components: CLC: Cloud Controller (EC2 functionality) Walrus (S3 functionality) CC: Cluster Controller (middle-tier cluster management service) SC: Storage Controller (EBS functionality) NC: Node Controller (controls VM instances)

Hardware Requirements
You will need a minimum of two machines to host Eucalyptus components.
Machine Hosted Eucalyptus Components Minimum Disk Space Host Requirement Frontend CLC, Walrus, CC, SC Minimum 100GB Node NC Minimum 100GB Minimum Memory 4-8GB 4GB

Be sure that all machines are running the latest release of CentOS 5.7. Test that all systems allow ssh login, and that root access is available (sudo is OK).

Network Requirements
1. You must have a DHCP server available (installed but not running). 2. You must have a range of available public IP addresses. These will be assigned to Virtual

Machines (instances).
3. You must have a large range of available private IP addresses. These will be used by a

virtual subnet. They cannot overlap or contain any part of a physical network IP address space. The following diagram shows the Eucalyptus components as they will be installed on the physical machines. Eucalyptus CLC, Walrus, SC, and CC components are installed on a single front-end machine; NC components are installed on one or more node machines. Each machine has a single connection exposed to the public network.

Company Confidential 2

Software Requirements
You must have access to the following: CentOS 5.7 install CD #1. You can find the image on one of the mirrors here: http://isoredirect.centos.org/centos/5/isos/x86_64/. The file is labeled CentOS-5.7-x86_64bin-1of8.iso. Eucalyptus Fast Start media (request it here: http://www.eucalyptus.com/go/myCloud)

Install the Software

1. Install CentOS 5.7 on all machines. 2. At the boot: prompt, press ENTER for the graphical installer. You can skip the media

verification if you like, then accept the defaults, with the following exceptions: For network interface configuration, select Edit and manually configure i.IP address ii.netmask iii.hostname iv.gateway v.DNS 3. Package options: Deselect Desktop Gnome Select Customize Now Click next Select Applications Deselect Editors and Text-Based Internet Select Base System Deselect Base and Dialup Networking Support 4. Insert the Eucalyptus Fast Start media and run fastinstall.sh:
mkdir /media/usb mount -t vfat /dev/sdb1 /media/usb Company Confidential 3

cd /media/usb ./fastinstall.sh Note: the USB drive might appear as a device other than /dev/sdb1 depending on your hardware configuration (i.e. /dev/sdc1, etc.)

Tip: We recommend that you install your node controllers first so that you can register them with the frontend server as part of that install.
5. For NC, answer n to the first question (this is not the front-end server).

6.

7.

8. 9.

Note: After the install completes, the machine will reboot automatically and be ready to run. On the frontend, answer y to the first question (this IS the front-end server). When the installation is completed, you will be asked for; a. public and private network interfaces (defaults should be fine) b. private subnet (address used by instances internal to the cloud) c. private netmask d. DNS server address (used for name resolution in the cloud) e. available IP addresses for the instances (public addresss on your network that instances can use) Services will now start and the script will wait for the CLC to run. The script registers components (you will be asked about connecting to the server over ssh and to provide the root password). As the last step on the frontend, you need to enter the IP address of each NC (you can have more than one). Press ENTER (at the prompt) when you are done. In a web browser, go to the URL provided. It will be in this format:
https://<your_frontend_IP_address>:8443/

10. Login as admin/admin. 11. Enter a new admin password, your email address, and the frontend servers public IP

address. Note: Normally, you would download a credentials file and use it to configure the client tools. As part of the FastInstall process, credentials have been downloaded and pre-installed on an image for you. To get these credentials, copy /root/credentials.zip from the frontend server. For more information see the Eucalyptus Administrators Guide: http://open.eucalyptus.com/wiki/EucalyptusAdministratorGuide_v2.0

Company Confidential 4