3.

1 FastStart Guide

2012-07-11 Eucalyptus Systems

Eucalyptus | Contents | 2

Contents
Welcome............................................................................................................................................3 Install CentOS..................................................................................................................................4 Install the Node Controller.............................................................................................................5 Install the Frontend Components...................................................................................................6 Try Out Your Eucalyptus FastStart Installation...........................................................................8
Install and Connect to the Default FastStart Image...............................................................................................8

Finding More Information............................................................................................................10

Eucalyptus | Welcome | 3

Welcome
Welcome to the FastStart Guide. This guide provides instructions for installing Eucalyptus on two machines, though you have the option to add more machines. Overview Eucalyptus consists of the following components: Cloud Controller (CLC): this component provides EC2 functionality Walrus: this component provides S3 functionality Cluster Controller (CC): this component provides management service for a cluster in your cloud Storage Controller (SC): this component provides EBS functionality Node Controller (NC): this component controls virtual machine instances

In FastStart, the CLC, Walrus, CC, and SC are installed on one machine. This machine is called the Frontend. The NC is installed on another machine, called the Node. In FastStart you can have one Frontend and one or more Nodes. Hardware Requirements Before installing FastStart, make sure you have at least two machines. Each machine must have a minimum of 100GB of disk space and 4GB of memory. Test that each machine allows SSH login and that root access is available (sudo is okay). Network Requirements You must have access to a DHCP server. You must have range of available public IP addresses. These will be assigned to VM instances. You must have large range of available private IP addresses. These will be used by a virtual subnet. They can't overlap or contain any part of a physical network IP address space.

Software Requirements You must have access to the following: CentOS 6.2 minimal install CD: You can get the image on one of the mirrors at http://isoredirect.centos.org/centos/6.2/isos/x86_64/. The file is labeled CentOS-6.2-x86_64-minimal.iso. Important: Only use this specified image for FastStart. Eucalyptus FastStart media: You can get Faststart at http://www.eucalyptus.com/download/faststart

CC-BY-SA, Eucalyptus Systems, Inc.

Eucalyptus | Install CentOS | 4

Install CentOS
1. Make sure the CentOS CD is in the CD drive and boot the computer from the CD drive. 2. At the boot prompt, press ENTER for the graphical installer. You can skip the media verification. 3. Accept the defaults, except for the network interface configuration. At the page where you set your hostname, click the Configure Network button. The Network Connections window displays. 4. In the Network Connections window, select the network interface and click Edit. The Editing System window for the connection displays. 5. In the Editing System window, click Connect automatically. 6. Click the IPv4 Settings tab and do the following: a) In the Address area, click Add and fill in the machine's IP address, netmask, and gateway. b) In the DNS servers field, enter a URL for a DNS server (for example, 8.8.8.8). 7. Click Apply and finish with the installation. 8. Repeat on each machine you will use for FastStart. You are now ready to install the FastStart Node.

CC-BY-SA, Eucalyptus Systems, Inc.

Eucalyptus | Install the Node Controller | 5

Install the Node Controller

The Eucalyptus Node Controller controls virtual machine activities, including the running, verification, and termination of virtual machine instances. To install the Node Controller: 1. On the machine you plan to use as the Node Controller, mount the Eucalyptus FastStart media and run fastinstall.sh. For example: mkdir /media/usb; mount -t vfat /dev/sdb1 /media/usb; cd /media/usb; ./fastinstall.sh Tip: In this example, we assume that the Fast Start media appears as /dev/sdb1. Please replace with the actual device name (check the output of dmesg). 2. At the prompt for the Frontend server, enter n. Will this be the front-end server in your cloud? [Y|n]n When the installation process is finished, the machine will reboot automatically and be ready to run. You are now ready to install the FastStart Frontend.

CC-BY-SA, Eucalyptus Systems, Inc.

Eucalyptus | Install the Frontend Components | 6

Install the Frontend Components

In FastStart, all Eucalyptus components other than the Node Controller are installed on one machine. This machine is known as the Frontend. The Frontend is the entry point to the cloud for both administrators and users. To install the Frontend components: 1. On the machine you plan to use as the Frontend, mount the Eucalyptus FastStart media and run fastinstall.sh. mkdir /media/usb; mount -t vfat /dev/sdb1 /media/usb; cd /media/usb; ./fastinstall.sh Tip: In this example, we assume that the Fast Start media appears as /dev/sdb1. Please replace with the actual device name (check the output of dmesg). 2. At the prompt for the front-end server, answer Y to the first question. Will this be the front-end server in your cloud? [Y|n]Y 3. 4. 5. 6. 7. At the prompt for the public ethernet interface, press Enter. At the prompt for the private ethernet interface, press Enter. At the prompt for the dedicated subnet, enter the subnet address for the Frontend. At the prompt for the subnet netmask, enter the netmask for the Frontend's subnet. At the prompt for the range of IPs, enter a range of available IP addresses that Eucalyptus can choose from to assign to virtual machine instances. Use a hyphen to separate the lower and upper range (for example,192.168.9.212-192.168.9.229). 8. The configuration process will start the services and then wait for the CLC to run. During this process you are asked to provide the root password for the machine running the Node Controller. Wed May 2 09:38:59 PDT 2012- InitializingInitializing Database.....Ready to register node controllers. Once they are installed, enter their IP addresses here, one by one (ENTER when done)Node IP :192.168.9.211The authenticity of host '192.168.9.211 (192.168.9.211)' can't be established.RSA key fingerprint is 84:34:b4:49:1e:54:40:c3:80:7d:b1:d4:0d:93:0a:32.Are you sure you want to continue connecting (yes/no)? [email protected]'s password: INFO: We expect all nodes to have eucalyptus installed in $EUCALYPTUS for key synchronization.Trying rsync to sync keys with 192.168.9.211done...done 9. At the prompt, enter the IP address of each machine running a Node Controller. Press ENTER when you are done. When the installation process is finished, the machine will reboot automatically. 10. After the reboot, configure the Eucalyptus Dashboard: a) Open a web browser and go to https://<your_frontend_IP_address>:8443/ b) Login as admin with the password admin. c) Enter a new admin password, your email address, and the server IP address. The installation is now complete.

CC-BY-SA, Eucalyptus Systems, Inc.

Eucalyptus | Install the Frontend Components | 7

Tip: Normally, you would download a credentials file and use it to configure the client tools. As part of the FastStart process, credentials are downloaded and pre-installed on an image for you. To get these credentials,copy /root/credentials.zip from the Frontend server.

CC-BY-SA, Eucalyptus Systems, Inc.

Eucalyptus | Try Out Your Eucalyptus FastStart Installation | 8

Try Out Your Eucalyptus FastStart Installation

Your FastStart installation includes a default CentOS 5 image. This section describes how to launch an instance from this image and connect to that instance. The tasks listed in the follow sections require a network connection. Important: Before you can use the commands that follow, set up your environment variables by sourcing the eucarc file. On the Frontend enter the following command: source /root/creds/eucarc.

Install and Connect to the Default FastStart Image

Eucalyptus provides a default image that you can use to launch an instance immediately. To install the default image included with FastStart: 1. Find the default image by typing the following command: euca-describe-images This command returns a list of images available. For new FastStart installations, a default image is provided - in this example, the image ID is emi-72613A2E: IMAGE eki-D313397A admin/vmlinuz-2.6.28-11-generic.manifest.xml 508678674223 available public i386 kernel instance-store IMAGE emi-72613A2E admin/euca-centos-5.8-2012.05.14-x86_64.manifest.xml 508678674223 available public i386 machine eki-D313397A eri-F9A83F12 instance-store IMAGE eri-F9A83F12 admin/initrd.img-2.6.28-11-generic.manifest.xml 508678674223 available public i386 ramdisk instance-store 2. Create a key pair using the euca-add-keypair command. This command will store the public half of the key pair and keep it available for your Eucalyptus cloud instances, and will output the private half of the key pair. Save this output to a file for future use, as in the following example: euca-add-keypair euca-demo > euca-demo.private Tip: If you've already added a keypair, you can skip this step. 3. Change permissions on the private keypair file so that only you can access and change it: chmod 0600 euca-demo.private 4. Run the instance with the euca-run-instances command, specifying the appropriate image ID and the name of the key pair you just created. For example: euca-run-instances -k euca-demo emi-72613A2E This will return output similar to the following: RESERVATION INSTANCE r-CCE33FC0 i-68A24092 449455269925 emi-72613A2E default 0.0.0.0 0.0.0.0

pending

CC-BY-SA, Eucalyptus Systems, Inc.

Eucalyptus | Try Out Your Eucalyptus FastStart Installation | 9

euca-demo 0 m1.small 2012-05-17T10:36:46.232Z PARTI00 eri-F9A83F12 monitoring-disabled 0.0.0.0 0.0.0.0

eki-D313397A instance-store

Note that the initial state of the instance is 'pending' while the instance is being created. 5. After a few moments, check to see if your instance is available for use yet by using the euca-describe-instances command: euca-describe-instances i-68A24092

When the instance is ready, this command will return output similar to the following: RESERVATION r-CCE33FC0 449455269925 default INSTANCE i-68A24092 emi-72613A2E 192.168.9.91 10.93.7.76 running euca-demo 0 m1.small 2012-05-17T10:36:46.232Z PARTI00 eki-D313397A eri-F9A83F12 monitoring-disabled 192.168.9.91 10.93.7.76 instance-store Note that the instance is now listed as 'running', and there's now an IP address - in this example, 192.168.9.91. You can use this IP address to connect to the instance. 6. Connect to the running instance using SSH, specifying the private key file and the IP address of the instance. For example: ssh -i euca-demo.private 192.168.9.91

This command returns output similar to the following: Warning: Permanently added '192.168.9.91' (RSA) to the list of known hosts. Last login: Thu May 17 03:39:58 2012 from eucahost-9-91.eucalyptus -bash-3.2#

Congratulations! You've now successfully launched and connected to the default FastStart image. Please see the Eucalyptus User Guide for more tutorials.

CC-BY-SA, Eucalyptus Systems, Inc.

Eucalyptus | Finding More Information | 10

Finding More Information

Read More Eucalyptus has the following guides to help you with more information: The Administration Guide details ways to manage your Eucalyptus deployment. Refer to this guide to learn more about managing your Eucalyptus components, managing access to Eucalyptus, and managing Eucalyptus resources, like instances and images. The User Guide details ways to use Eucalyptus for your computing and storage needs. Refer to this guide to learn more about getting and using euca2ools, creating images, running instances, and using dynamic block storage devices. The CLI Reference Guide describes the Euca2ools commands. Refer to this guide for more information about required and optional parameters for each command.

Get Involved The following resources can help you to learn more, connect with other Eucalyptus users, or get actively involved with Eucalyptus development. The Eucalyptus IRC channel is #eucalyptus on Freenode. This channel is used for real-time communication among users and developers. Information on how to use the network is available from Freenode. The Eucalyptus community mailing list is [email protected]. This list is used for user discussions, problem reports, and other communications. Information on how to subscribe is available at http://lists.eucalyptus.com/cgi-bin/mailman/listinfo/community

CC-BY-SA, Eucalyptus Systems, Inc.