Table of Contents 3
Not for resale. Not for redistribution. Eucalyptus EE 2.0 User’s Guide (v.1.b)
Copyright © 2010 Eucalyptus Systems, Inc. Last Modified 2/24/11
Table of Contents
Introduction ................................................................................................................. 5
Who Should Read this Guide? ............................................................................................................................ 5
What’s in this Guide? ............................................................................................................................................. 5
What’s New for Users in Eucalyptus EE 2.0? ............................................................................................... 7
Conventions Used in this Guide ........................................................................................................................ 7
Contacting Eucalyptus .......................................................................................................................................... 8
Section 1: Getting Started ............................................................................................. 9
1.1 Overview of User Features .......................................................................................................................... 9
1.2 Signing up for an Account ......................................................................................................................... 10
1.3 Obtaining User Credentials ...................................................................................................................... 11
1.4 Interacting with Eucalyptus via Client Tools .................................................................................... 12
1.4.1 What is Euca2ools? ...................................................................................................................................... 12
1.4.2 Installing Euca2ools .................................................................................................................................... 12
1.4.3 Setting Environment Variables .............................................................................................................. 13
1.5 Getting Help .................................................................................................................................................... 14
Section 2: Euca2ools Quickstart .................................................................................. 15
2.1 Querying the System ................................................................................................................................... 15
2.2 Creating Keypairs ......................................................................................................................................... 16
2.3 Running a VM Instance .............................................................................................................................. 16
2.4 Authorizing a Security Group .................................................................................................................. 17
2.5 Logging into a VM Instance ...................................................................................................................... 18
2.6 Terminating VM Instances ....................................................................................................................... 21
Section 3: Managing VM Images ................................................................................. 22
3.1 Preparing a VM Image (bundle/upload/register) .......................................................................... 22
3.1.1 Bundling Images ........................................................................................................................................... 22
3.1.2 Uploading Images ......................................................................................................................................... 24
3.1.3 Registering Images ...................................................................................................................................... 25
3.2 Associating Kernels and Ramdisks with VM Instances ................................................................ 26
3.3 Deleting Images ............................................................................................................................................. 26
3.4 Downloading an Image .............................................................................................................................. 27
3.5 Deleting a Bundled Image ......................................................................................................................... 28
3.6 Unbundling an Image .................................................................................................................................. 29
3.7 Managing Windows VM Images (Eucalyptus EE only) ................................................................. 29
3.7.1 Preparing Windows VM Images ............................................................................................................ 30
3.7.2 Bundling Windows VM Instances .......................................................................................................... 30
Section 4: Working with VM Instances ....................................................................... 32
4.1 Querying Instances ...................................................................................................................................... 32
4.2 Running Instances ........................................................................................................................................ 32
4.3 Shutting Down Instances .......................................................................................................................... 33
4.4 Rebooting Instances .................................................................................................................................... 33
4.5 Logging into a Windows VM Instance (Eucalyptus EE only) ..................................................... 33
Section 5: VM Networking and Security ...................................................................... 35
5.1 Allocating and Associating IP Addresses ............................................................................................ 35
5.1.1 Disassociating and Releasing Addresses ............................................................................................ 35
5.2 Creating a Security Group ......................................................................................................................... 36