documentfs
TRANSCRIPT
3.1 FastStart Guide
2012-07-11 Eucalyptus Systems
Contents
Welcome............................................................................................................................................3
Install CentOS..................................................................................................................................4
Install the Node Controller.............................................................................................................5
Install the Frontend Components...................................................................................................6
Try Out Your Eucalyptus FastStart Installation...........................................................................8Install and Connect to the Default FastStart Image...............................................................................................8
Finding More Information............................................................................................................10
Eucalyptus | Contents | 2
Welcome
Welcome to the FastStart Guide. This guide provides instructions for installing Eucalyptus on two machines, thoughyou 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 NCis 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 100GBof 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 athttp://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 | Welcome | 3
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, clickthe 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 CentOS | 4
Install the Node Controller
The Eucalyptus Node Controller controls virtual machine activities, including the running, verification, and terminationof 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 runfastinstall.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 theactual 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 Node Controller | 5
Install the Frontend Components
In FastStart, all Eucalyptus components other than the Node Controller are installed on one machine. This machine isknown 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 theactual 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. At the prompt for the public ethernet interface, press Enter.
4. At the prompt for the private ethernet interface, press Enter.
5. At the prompt for the dedicated subnet, enter the subnet address for the Frontend.
6. At the prompt for the subnet netmask, enter the netmask for the Frontend's subnet.
7. At the prompt for the range of IPs, enter a range of available IP addresses that Eucalyptus can choose from to assignto virtual machine instances. Use a hyphen to separate the lower and upper range (forexample,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 askedto 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 | 6
Tip: Normally, you would download a credentials file and use it to configure the client tools. As part of theFastStart 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 | Install the Frontend Components | 7
Try Out Your Eucalyptus FastStart Installation
Your FastStart installation includes a default CentOS 5 image. This section describes how to launch an instance fromthis 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 theeucarc file. On the Frontend enter the following command: source /root/creds/eucarc.
Install and Connect to the Default FastStart ImageEucalyptus 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 thisexample, 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 keypair and keep it available for your Eucalyptus cloud instances, and will output the private half of the key pair. Savethis 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 nameof 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 r-CCE33FC0 449455269925 defaultINSTANCE i-68A24092 emi-72613A2E 0.0.0.0 0.0.0.0 pending
CC-BY-SA, Eucalyptus Systems, Inc.
Eucalyptus | Try Out Your Eucalyptus FastStart Installation | 8
euca-demo 0 m1.small 2012-05-17T10:36:46.232Z PARTI00 eki-D313397A eri-F9A83F12monitoring-disabled 0.0.0.0 0.0.0.0 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 theeuca-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 defaultINSTANCE i-68A24092 emi-72613A2E 192.168.9.91 10.93.7.76 running euca-demo 0m1.small 2012-05-17T10:36:46.232Z PARTI00 eki-D313397A eri-F9A83F12monitoring-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. Youcan 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. Forexample:
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 | Try Out Your Eucalyptus FastStart Installation | 9
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 moreabout 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 learnmore 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 requiredand 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 withEucalyptus development.
• The Eucalyptus IRC channel is #eucalyptus on Freenode. This channel is used for real-time communication amongusers 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 athttp://lists.eucalyptus.com/cgi-bin/mailman/listinfo/community
CC-BY-SA, Eucalyptus Systems, Inc.
Eucalyptus | Finding More Information | 10