Installation from source

Euca2ools can be installed from source or as a binary package (DEB or RPM). The latest source tarball and binary packages can be found here:

http://open.eucalyptus.com/downloads

Please, download the correct package for your distribution or the tarball. Euca2ools are written in Python, relying on the Boto library and the M2Crypto cryptography and SSL toolkit. The acceptable versions for the dependencies are:

  • Python 2.5 (dev) or higher
  • Boto 1.8d or higher
  • M2Crypto 0.19.1 or higher

In what follows substitute the desired version (e.g., 1.2) for $VERSION either manually or by setting a shell variable. For example

export VERSION="1.2"

You will need to download euca2ools-$VERSION-src-deps.tar.gz, which contains boto-1.8d.tar.gz and M2Crypto-0.19.1.tar.gz.

Build the dependencies and install as follows.

You will need to install python-dev, swig, help2man, and libssl-dev to build the following libraries.

  • Download euca2ools-$VERSION.tar.gz and euca2ools-$VERSION-src-deps.tar.gz. Below, we will assume that these tarballs are located in the current directory.
  • Install Boto
tar zvxf euca2ools-$VERSION-src-deps.tar.gz
cd euca2ools-$VERSION-src-deps
tar zxvf boto-1.8d.tar.gz
cd boto-1.8d
sudo python setup.py install
cd ..
  • Install M2Crypto
tar zxvf M2Crypto-0.19.1.tar.gz
cd M2Crypto-0.19.1
sudo python setup.py install
cd ..

  • Install Euca2ools in /usr/local/bin, adding it to your $PATH, if necessary
cd ..
tar zxvf euca2ools-$VERSION.tar.gz
cd euca2ools-$VERSION
sudo make
export PATH=/usr/local/bin:$PATH  # not necessary on most installations
  • Uninstalling
sudo make uninstall

You may also wish to delete euca2ools, boto and M2Crypto from your python package installation directory.