Installation

Prerequisites

Make sure you have the following packages installed:

• Python 2.6+
• Django 1.2+
• libcloud
• Paramiko (python ssh library)
• rabbitMQ-server (on ubuntu: sudo apt-get install rabbitmq-server)
• celery
• django-celery
• django-piston (optional — for the REST API)
• IPy (optional — IP address validation for the “Dedicated Hardware” plugin)

Create ssh keypair

• use ssh-keygen to create an ssh keypair
  • make sure you specify RSA as the key type, because Amazon EC2 doesn’t import DSA keys
  • you can accept the default name, or give the public key a name like overmind.pub
• if you want to use Overmind with Amazon EC2, you need to import the public key into Amazon EC2 for example via ec2-import-keypair
  • Overmind will support key import natively as soon as it will be added to libcloud

Install Overmind

• download the .tar.gz. / .zip archive, or git clone from source if you’re adventurous
• change directories into overmind/overmind
• if the name of the public key generated above is different from id_rsa.pub, modify settings.py and set PUBLIC_KEY_FILE to the correct value (for example “overmind.pub”)
• run python manage.py syncdb to create the initial database
  • you will be prompted for a user name, email and password — make sure you don’t skip this step, because that user name will be the initial administrator-type user for the Overmind application
• run python manage.py runserver OVERMIND_IP:OVERMIND_PORT to launch the Overmind Django application (or you can skip OVERMIND_IP:OVERMIND_PORT, in which case Overmind will run on 127.0.0.1:8000)

Using Overmind

• hit http://OVERMIND_IP:OVERMIND_PORT/overview
• log in using the username/password you specified during the syncdb step

The rest should be self-explanatory. Once you log in, you will be able to create providers and nodes. You will also be able to manage users if you click on the Settings menu option.