elasticluster is a Python program; Python version 2.6 is required to run it.

The easiest way to install elasticluster is using pip, this will install the latest stable release from the PyPI website. The following section: Installing from PyPI will explain you how to do it.

If you instead want to test the development version, go to the Installing from github section.

In both cases, it’s strongly suggested to install elasticluster in a python virtualenv, so that you can easily uninstall or upgrade elasticluster.

Installing from PyPI

It’s quite easy to install elasticluster using pip; the command below is all you need to install elasticluster on your system:

pip install elasticluster

If you want to run elasticluster from source you have to install Ansible first:

pip install ansible
python install

Installing from github

The source code of elasticluster is github, if you want to test the latest development version you can clone the github elasticluster repository.

You need the git command in order to be able to clone it, and we suggest you to use python virtualenv in order to create a controlled environment in which you can install elasticluster as normal user.

Assuming you already have virtualenv installed on your machine, you first need to create a virtualenv and install ansible, which is needed by elasticluster:

virtualenv elasticluster
. elasticluster/bin/activate
pip install ansible

Then you have to download the software. We suggest you to download it within the created virtualenv:

cd elasticluster
git clone git:// src
cd src
python install

Now the elasticluster should be available in your current environment.

Notes on MacOSX installation

When installing elasticluster on MacOSX operating systems you may get some errors while running python install, because pip is not always able to automatically resolve the dependencies.

In these cases, you need to find the package that is failing and install it manually using pip.

For instance, if during the installation you get something like:

Running requests-2.4.3/ -q bdist_egg --dist-dir /var/folders/tZ/tZ2B3RaeGVq7+ptdJIbdj++++TI/-Tmp-/easy_install-CrTFFL/requests-2.4.3/egg-dist-tmp-JZ2MOD
Adding requests 2.4.3 to easy-install.pth file
Traceback (most recent call last):
  File "", line 109, in <module>
    'elasticluster = elasticluster.main:main',
  File "/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/distutils/", line 152, in setup
  File "/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/distutils/", line 975, in run_commands
  File "/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/distutils/", line 995, in run_command
  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 65, in run
  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 115, in do_egg_install
  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 360, in run

  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 576, in easy_install

  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 627, in install_item

  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 682, in process_distribution

  File "/Users/michela/elasticluster/build/setuptools/", line 631, in resolve
    dist = best[req.key] = env.best_match(req, ws, installer)
  File "/Users/michela/elasticluster/build/setuptools/", line 871, in best_match
    return self.obtain(req, installer)
  File "/Users/michela/elasticluster/build/setuptools/", line 883, in obtain
    return installer(requirement)
  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 595, in easy_install

  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 627, in install_item

  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 659, in process_distribution

  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 532, in install_egg_scripts

  File "/Users/michela/elasticluster/build/setuptools/setuptools/command/", line 734, in install_wrapper_scripts

  File "/private/var/folders/tZ/tZ2B3RaeGVq7+ptdJIbdj++++TI/-Tmp-/easy_install-qch0dG/python-keystoneclient-0.11.1/pbr-0.10.0-py2.6.egg/pbr/", line 512, in override_get_script_args
AttributeError: 'NoneType' object has no attribute 'get_script_header'

you probably need to install pbr manually using:

pip install pbr

In some MacOSX version, even if the installation seems to succeed, you may get the following error the first time you run elasticluster:

Traceback (most recent call last):
  File "/Users/michela/el2/bin/elasticluster", line 9, in <module>
    load_entry_point('elasticluster==1.1-dev', 'console_scripts', 'elasticluster')()
  File "/Users/michela/el2/build/setuptools/", line 356, in load_entry_point
    return get_distribution(dist).load_entry_point(group, name)
  File "/Users/michela/el2/build/setuptools/", line 2431, in load_entry_point
    return ep.load()
  File "/Users/michela/el2/build/setuptools/", line 2147, in load
  File "build/bdist.macosx-10.6-universal/egg/elasticluster/", line 33, in <module>
  File "build/bdist.macosx-10.6-universal/egg/elasticluster/providers/", line 37, in <module>
  File "build/bdist.macosx-10.6-universal/egg/apiclient/", line 52, in <module>
  File "build/bdist.macosx-10.6-universal/egg/apiclient/", line 27, in <module>
ImportError: No module named anyjson

In this case, the issue is caused by google-api-python-client, and you should: 1) uninstall it using pip uninstall 2) reinstall it using pip install 3) re-run elasticluster installation

pip uninstall google-api-python-client
pip install google-api-python-client
python install