Version 17 (modified by ibaldin, 9 years ago)


Setting up Euca 2.0


This document covers installation of Eucalyptus 2.0.0 from source in MANAGED-NOVLAN mode of operation. You must have several physical hosts at your disposal, one designated as a head node and the rest as worker nodes. Worker nodes will have to run either KVM or Xen to be able to create virtual machines. In the described setup the head node does not run Eucalyptus VM instances and therefore does not have to run Xen or KVM. Xen/KVM configuration is not covered in this document as it is heavily distribution and hardware dependent.

Eucalyptus does not have strong dependencies on the distribution. The selected distribution should have a kernel upstream of 2.6.22 to properly support tgt package for iSCSI configuration and should ideally offer 'out-of-the-box' use of Xen or KVM (depending on your hardware).


  • Make sure ssh keys for root user are shared across the hosts (i.e. that the root on master node can perform a passwordless login in any worker node).
    root@master$ ssh-keygen
    root@master$ cd .ssh/
    root@master$ cat id_dsa.put >> authorized_keys
    root@master$ scp authorized_keys root@worker1:~/.ssh/
    root@master$ scp authorized_keys root@worker2:~/.ssh/
  • These instructions presume the build is being done on the master node
  • Download source code packages for Eucalyptus:
    • Eucalyptus 2.0.0 source, offline version
    • Eycalyptus 2.0.0 source dependencies
    • Euca2ools 1.3.1 source
    • Euca2ools 1.3.1 source dependencies
  • Follow the installation instructions. Pay attention to the software prerequisites, particularly Java - don't use OpenJDK, install Sun's Java 1.6.x or above. It is handy to edit and dot this script prior to installation. Installation should be performed as root. In the script below the installation location is /opt/eucalyptus-2.0
    # DOT this file
    # Where is Java?
    export JAVA_HOME=/opt/java/jdk1.6.0_18
    export PATH=$JAVA_HOME/bin:$PATH
    # Where will Euca be installed?
    export EUCALYPTUS=/opt/eucalyptus-2.0
    # Where is Euca source?
    export EUCALYPTUS_SRC=/home/eucalyptus/eucalyptus-2.0.0
    # where are Apache include files?
    export APACHE_INCLUDES=/usr/include/apache2
    export APR_INCLUDES=/usr/include/apr-1.0
    # Where can Axis2C be found after installation? (note it goes under the Euca install tree)
    export AXIS2C_HOME=$EUCALYPTUS/packages/axis2c-1.6.0
  • Follow installation instructions through step 5, at which point you should have a built Eucalyptus 2.0 tree on the master node and each of the worker nodes. Be sure to place it in the same location on all nodes
    • If you don't have rsync installed, a combination of tar and ssh works just as well:
      root@master$ tar -cf - $EUCALYPTUS | ssh root@worker1 tar -xf - -C /


This setup assumes that a single NIC in each physical host is dedicated to Eucalyptus functions. Other NICs can be used for extra data-plane connectivity. The MANAGED-NOVLAN mode places no requirements for the supported network switches. To properly setup the network configuration it is important to know two things:

  • The name of the physical interface on master node that has access to worker nodes (and in this case also is public; it is named eth1)
  • The name of the bridge on worker nodes that KVM or XEN uses. In this case it is also eth1, because Xen is used as an example. In case of KVM it is typically br0.

Running and testing Eucalyptus


Where to look

Logfiles are typically located in the installation subtree (/opt/eucalyptus-2.0/var/log/eucalyptus). Look for error logs. Check this page.

Euca cloud controller

tgt won't start

  • Install a binary package if possible. On Debian/Ubuntu do
    $ aptitude search tgt
  • Download and install tgt software if it is missing. This software manages ISCSI volumes for Walrus.
    $ make ISCSI=1; make install