Deprecated: Installation

Warning

This document is deprecated as of Ganeti Web Manager version 0.11.

We 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 Deprecated: Dependencies installed.

Installing

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

  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:

Existing Database:

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

New Database:

./manage.py syncdb --all
./manage.py migrate --fake
  1. 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 Development Server.