Version 7 (modified by ibaldin, 9 years ago)

--

Setting up Eucalyptus 1.5.2 with ORCA 2.1

This page explains how to setup and test Euca 1.5.2 for ORCA. We will begin by setting up a stock distribution, testing it, then applying ORCA-specific patches.

The idea is the Eucalyptus will set up slivers consisting of one or more VMs hanging off vlans, whose IDs orca specified at creation time. Then these slivers with vlans can be dynamically stitched to other slivers into a complete slice. Using Eucalyptus simplifies substrate setup compared to Xen.

Setting up stock Eucalyptus 1.5.2

Hardware setup

You will need several hosts with dual interfaces - one interface on 'management' network and one on 'data plane' that will be stitched into ORCA slices. At RENCI this setup is implemented by having each host its eth1 on BEN management network (192.168.xx.xx address space) and eth0 connected into BEN with unassigned IP addresses.

Each host should support hardware virtualization and be able to run kvm. The cluster will consist of a single head node and multiple compute nodes. The head node requires substantial disk space to store all VM filesystem images (if you plan to support many options). The head node can also act as a compute node and instantiate VMs on itself. These instructions however presume that the head node is not performing this function.

The dataplane interfaces of the cluster should be plugged in into an ORCA-controllable switch (a Cisco 6509 in our case) to allow for the mapping of Euca-created vlans to other vlan segments.

Software pre-requisutes

  1. Ubuntu jaunty basic server install
  2. kvm and libvirt (including libvirt-bin)
  3. ntp (Euca instructions suggest using open-ntp, however there is no reason not to use the Ubuntu 9.04 stock ntpd3 server
  4. vconfig tools (to enable creating tagged interface)
  5. brctl tools (to enable creating bridges)

Testing software pre-requisites

The notes here are either for the head node [HN], the compute nodes [CN], or for all [ALL]

  1. [ALL] Test ntp. Run ntpdc and verify the output is sane. At RENCI the configuration is simply adding
    server clock3.unc.edu
    

line to /etc/ntp.conf and restarting ntpd

  1. [ALL] Test vconfig and brctl:
    $ vconfig add eth0 10
    $ ifconfig eth0.10
    $ vconfig rem eth0.10
    $ brctl show 
    
  2. [CN] Make sure kvm is OK:
    $ /etc/init.d/kvm restart
    
  3. [CN] Make sure libvirtd is running:
    $ /etc/init.d/libvirt-bin restart
    $ virsh list
    
  4. [CN] identify or create a default bridge for kvm/xen to use. Xen by default creates a bridge (xenbr0). KVM requires that a bridge is manually setup. On Ubuntu this means adding
auto br0
iface br0 inet manual
	bridge_ports eth0
	bridge_stp off
	bridge_maxwait 0
}}} to /etc/network/interfaces. NOTE: in this setup eth0 is the dataplane interface facing into BEN. It remains unconfigured. The management interface is eth1 and is not shown here - it has a static configuration. Restart networking and verify that br0 and eth0 are in the UP state. Verify that bridge br0 exists and eth0 is part of it:
{{{
$ brctl show
}}}




= Undoing an install =

When things don't seem to work, fear not, there is a way to start from scratch:

 1. Stop the euca daemons:
[HN]
{{{
$ /etc/init.d/eucalyptus-cc stop
$ /etc/init.d/eucalyptus-cloud stop
}}}
[CN]
{{{
$ /etc/init.d/eucalyptus-nc stop
}}}
 1. Remove eucalyptus packages (including config directories, if possible)
[HN]
{{{
$ dpkg --purge eucalyptus-cloud
$ dpkg --purge eucalyptus-cc
$ dpkg --purge eucalyptus-gl
$ dpkg --purge eucalyptus-common
$ dpkg --purge eucalyptus-javadeps
}}}
[CN]
{{{
$ dpkg --purge eucalyptus-cc
$ dpkg --purge eucalyptus-gl
$ dpkg --purge eucalyptus-common
}}}
 1. Remove user eucalyptus from the system
{{{
$ userdel -r eucalyptus
$ groupdel eucalyptus
}}}
 1. Remove remnants of config and log directories
{{{
$ rm -rf /etc/eucalyptus
$ rm -rf /var/log/eucalyptus
}}}
 1. Sometimes you may need to fix dpkg state
{{{ 
$ vi /var/lib/eucalyptus/statoverride
}}} 
and remove the line that mentions 'eucalyptus'
 1. Start over

Attachments