UEC

Revision 42 as of 2009-10-20 21:01:31

Clear message

Note: Please see Eucalyptus-Jaunty for documentation covering UEC on Ubuntu 9.04.

Getting Started with Ubuntu Enterprise Cloud

Overview

The Ubuntu Enterprise Cloud (UEC), powered by Eucalyptus, is highly configurable and customizable to a variety of environments. This tutorial covers UEC installation from the Ubuntu 9.10 Server Edition CD, and assumes a basic network topology, with a single system serving as the "all-in-one controller", and one or more nodes attached.

Another tutorial exists describing how to deploy UEC on already installed Ubuntu servers, or if you want to deploy a more complex network topology, with multiple clusters, or running the required cloud services from separate physical machines.

Terminology

You should be familiar with the Glossary. These terms are used throughout the documentation.

Objective

From this Tutorial you will learn how to install, configure, register and perform several operations on a basic UEC setup that results in a cloud with a one controller "front-end" and one or several node(s) for running Virtual Machine (VM) instances. You will also use examples to help get you started using your own private compute cloud.

Tutorial

STEP 1: Prerequisites

To deploy a minimal cloud infrastructure, you’ll need at least two dedicated systems:

  • a front end
  • one or more node(s)

Refer to the System Requirements tables for the detailed hardware requirements of these physical systems.

STEP 2: Install the Cloud/Cluster controller

  1. Download the 9.10 Server ISO

  2. When you boot, select “Install Ubuntu Enterprise Cloud”.
    private1-cr.png

  3. When asked whether you want a “Cluster” or a “Node” install, select “Cluster”.
    cluster-node-cr.png

  4. It will ask two other cloud-specific questions during the course of the install:
    1. Name of your cluster

      • e.g. cluster1

    2. A range of public IP addresses on the LAN that the cloud can allocate to instances

      • e.g. 192.168.1.200-192.168.1.249

STEP 3: Install the Node controller(s)

The node controller install is even simpler. Just make sure that you are connected to the network on which the cloud/cluster controller is already running.

  1. Boot from the same ISO on the node(s)
  2. Select “Install Ubuntu Enterprise Cloud”
  3. It should detect the Cluster and preselect “Node” install for you
  4. Confirm the partitioning scheme
  5. The rest of the installation should proceed uninterrupted; complete the installation and reboot the node

STEP 4: Register the Node with the Cloud Controller

  1. After all nodes are installed, return to the cloud/cluster-controller and run the following command to have it discover and register your newly-installed nodes. 
    sudo euca_conf --no-rsync --discover-nodes
  2. Confirm each node it finds

STEP 5: Credentials setup

Retrieve your UEC credentials according to the instructions at:

STEP 6: Bundle a UEC Image

Next, register a new image with your Cloud Controller:

STEP 7: Running an Image

Finally, run an image in a virtual machine in your Cloud:

More Information

  • Log files: /var/log/eucalyptus

  • Configuration files: /etc/eucalyptus

  • Database: /var/lib/eucalyptus/db

  • Environment note: Don't forget to source your ~/.euca/eucarc before running the client tools.