Installing Eucalyptus 2.0.3 on Fedora

Need help? Ask on our forums, mailing list, or IRC channel.

Eucalyptus can be installed on Fedora 12 from source or by using binary RPM packages. This document details the steps required to install Eucalyptus from RPMs. In what follows, the value of $VERSION must be set to the version of Eucalyptus you wish to install. For example:

export VERSION=2.0.3

Notice: Before you begin, please ensure that you have an up-to-date Fedora 12 installation on your target machine(s).

Prerequisites

If you start with a standard Fedora installation, you will satisfy all prerequisites with the following steps:

• Front-end, node and client machine system clocks are synchronized (e.g., using NTP).

  yum install -y ntp
  ntpdate pool.ntp.org
  

• Front-end needs java to manipulate a bridge and the binaries for dhcp server (do not configure or run dhcp server on the CC):

  yum install -y java-1.6.0-openjdk java-devel ant \
             ant-nodeps dhcp httpd boto
  yum install -y aoetools vblade vtun bridge-utils
  

• Install KVM and other related tools for the nodes

  yum install -y qemu-kvm libvirt aoetools vblade
  

• Firewall rules must permit the Eucalyptus components to communicate with one another, and clients to communicate with Eucalyptus. On the front-end, ports 8443, 8773, 8774 and 9001 must be open; on the node, port 8775 must be open. If you are planning on using Elastic IPs and/or Security Groups, you may want to consider disabling the firewall and use Eucalyptus facilities for enabling custom firewall rules (see Network configuration for more information). On both the front-end and the nodes:

  For example, from a text console:

  • run system-config-firewall-tui
  • select Firewall to be Disabled
  • select OK

• Disable SELINUX by editing /etc/selinux/config. Make sure that that SELINUX="disabled".

Download and Install RPMs

Eucalyptus binary installation is broken up into several packages: one for each of the components (CLC, Walrus, CC, etc.), as well as a couple of common packages.

There are two options for downloading and installing the packages:

Yum option:

Packages are available from our yum repository. To use this option, create '/etc/yum.repos.d/euca.repo' file with the following four lines:

[euca]
name=Eucalyptus
baseurl=http://www.eucalyptussoftware.com/downloads/repo/eucalyptus/{{VERSION}}/yum/centos/{{BASEARCH}}
gpgcheck=0

Replace {{VERSION}} and {{BASEARCH}} in the baseurl= line above.

Now install Eucalyptus on the front-end:

yum install eucalyptus-cloud eucalyptus-cc \
        eucalyptus-walrus eucalyptus-sc

and on the node:

yum install eucalyptus-nc

Tarball option

Download an archive that includes the Eucalyptus software as well as third party dependencies:

• 64-bit
• 32-bit

Untar the bundle in a temporary location:

tar zxvf eucalyptus-$VERSION-\*.tar.gz
cd eucalyptus-$VERSION-\*

In the examples below we use x86_64 for the architecture (replace with i386 or i586 if you are installing a 32-bit version) .

Install RPMs on the Front End

Install third-party dependency RPMs:

yum install -y perl-Crypt-OpenSSL-RSA perl-Crypt-OpenSSL-Random \
           scsi-target-utils wget

cd eucalyptus-$VERSION*-rpm-deps-x86_64 
rpm -Uvh euca-axis2c-1.6.0-1.x86_64.rpm \
         euca-rampartc-1.3.0-1.x86_64.rpm  
cd ..

then install the Eucalyptus RPMs:

rpm -Uvh eucalyptus-$VERSION-\*.x86_64.rpm \
     eucalyptus-common-java-$VERSION-\*.x86_64.rpm \
     eucalyptus-cloud-$VERSION-\*.x86_64.rpm \
     eucalyptus-sc-$VERSION-\*.x86_64.rpm \
     eucalyptus-walrus-$VERSION-\*.x86_64.rpm \
     eucalyptus-cc-$VERSION-\*.x86_64.rpm \
     eucalyptus-gl-$VERSION-\*.x86_64.rpm

Install RPMs on the nodes

Install the dependency packages (on each node) :

yum install -y perl-Crypt-OpenSSL-RSA \
               perl-Crypt-OpenSSL-Random wget
cd eucalyptus-$VERSION*-rpm-deps-x86_64 
rpm -Uvh euca-axis2c-1.6.0-1.x86_64.rpm \
         euca-rampartc-1.3.0-1.x86_64.rpm
cd ..

then install the Eucalyptus RPMs:

rpm -Uvh eucalyptus-$VERSION-\*.x86_64.rpm \
         eucalyptus-gl-$VERSION-\*.x86_64.rpm \
         eucalyptus-nc-$VERSION-\*.x86_64.rpm

Post-Install Steps

Modify libvirtd.conf file

The last step in the installation is to make sure that the user eucalyptus, which is created at RPM installation time, is configured to interact with the hypervisor through libvirt on all of your compute nodes. On each node, access the libvirtd configuration, /etc/libvirt/libvirtd.conf, and confirm that the following lines are uncommented:

unix_sock_group = "libvirt"
unix_sock_ro_perms = "0777"
unix_sock_rw_perms = "0770"
auth_unix_ro = "none"
auth_unix_rw = "none"

Restart libvirt, and make sure the sockets belong to the correct group:

/etc/init.d/libvirtd stop
/etc/init.d/libvirtd start
chown root:kvm /var/run/libvirt/libvirt-sock
chown root:kvm /var/run/libvirt/libvirt-sock-ro

Start up your Eucalyptus services.

On the front-end:

/etc/init.d/eucalyptus-cloud start
/etc/init.d/eucalyptus-cc start

On the node:

/etc/init.d/eucalyptus-nc start

At this point you should be ready to proceed with first-time configuration.