Installation

Currently we have use Fabric, a tool for streamlining administration tasks, to deploy Ganeti Web Manager.

Before installing Ganeti Web Manager, make sure you have all the required Dependencies installed.

Installing

1. Download and unpack the latest release, currently this is 0.10.2.

2. Change to the project directory.

   cd ganeti_webmgr

3. Run Fabric to automatically create a python virtual environment and install required dependencies. This may take a few minutes.

   # Deploy a production environment
   fab deploy

   Changed in version 0.10: fab prod deploy is now fab deploy. fab dev deploy is still the same.

   Note

   If you would like a more noisy output, adding v, as in fab v deploy, will provide more verbosity.

4. While in the project root, copy the default settings file settings.py.dist to settings.py:

   cp settings.py.dist settings.py

Minimum Configuration

Getting Ganeti Web Manager up and running requires a minimum configuration of a database server. If you don’t have a database server available, and are fine using SQLite, you can skip this step.

1. Edit settings.py and change the database backend to your preferred database along with filling any any relevant details relating to your database setup.

   'default': {
       # Add 'postgresql_psycopg2', 'postgresql', 'mysql',
       # 'sqlite3' or 'oracle'.
       'ENGINE': 'django.db.backends.',
   
       # Or path to database file if using sqlite3.
       'NAME': 'ganeti.db',
   
       # Not used with sqlite3.
       'USER':     '',
   
       # Not used with sqlite3.
       'PASSWORD': '',
   
       # Set to empty string for localhost. Not used with sqlite3.
       'HOST':     '',
   
       # Set to empty string for default. Not used with sqlite3.
       'PORT':     '',
   }

Initializing

1. Activate the Python Virtualenv:

   source venv/bin/activate

2. Initialize Database:

   MySQL/SQLite:

   # Create new tables and migrate all apps using southdb
   ./manage.py syncdb --migrate

   Postgres:

   Note

   This assumes your doing a fresh install of Ganeti Web Manager on a new Postgres database.

   ./manage.py syncdb --all
   ./manage.py migrate --fake

3. Build the search indexes

   ./manage.py rebuild_index

   Note

   Running ./manage.py update_index on a regular basis ensures that the search indexes stay up-to-date when models change in Ganeti Web Manager.

Next Steps

Congradulations! Ganeti Web Manager is now installed and initialized. Next, you’ll want to look into Configuring and Deployment, if you are going to be setting up a production instance. Otherwise, if you just want to play around with Ganeti Web Manager, or are developing, take a look at Testing.