Synnefo

infrastructure and the dependencies among them. This document applies

to Synnefo v0.3.

- Node types

  Nodes in a Synnefo deployment belong in one of the following types:

      Any WEBSERVER can issue commands to the GANETI-MASTER, over RAPI, to effect

      changes in the state of the VMs. The GANETI-MASTER runs the Ganeti request

      queue.

        the Synnefo Ganeti monitoring daemon [/ganeti/ganeti-eventd],

        and the Synnefo Ganeti hook [/ganeti/snf-ganeti-hook.py].

    of type WEBSERVER, LOGIC and on the GANETI-MASTER, with a properly configured

    settings.py. In later revisions, the specific parts of the Django project

    which need to run on each node type will be identified.

    settings.py.dist file contained in the Synnefo distribution with a file

    containing custom modifications. This is recommended to minimize the load

    of reconstructing settings.py from scratch, since each release currently

    This section describes each of the required service dependencies.

    * RabbitMQ

      RabbitMQ is used as a generic message broker for the system. It should

      hooks in Ganeti.  It resides in the ganeti/ directory of the Synnefo

      project root.

      root@ganeti-master:/etc/ganeti/hooks/instance-start-post.d# ls -l

      lrwxrwxrwx 1 root root 45 May   3 13:45 00-snf-ganeti-hook -> /home/devel/synnefo/ganeti/snf-ganeti-hook.py*

      repository, at https://code.grnet.gr/git/gnt-instance-image

      After installing gnt-instance-image do the following:

      Your Custom Images should be stored in a dump format under /var/cache/ganeti-instance-image

      and their filenames should have the following format:

      e.g. debian-6.0.1a-x86_64-root.dump (backend_id = "debian-6.0.1a")

    * Reconciliation process: On certain occasions, such as a Ganeti or

      RabbitMQ failure, the VM state in the system's database may differ from

      that in the Ganeti installation. The reconciliation process is designed

      On each invocation of the reconcile command, the system will trigger a

      reconciliation for ((num_all_vms/RECONCILIATION_MIN) * interval)

- OS Specific instructions

if the invitations application is deployed, the following

dependencies should be installed

to run the user interface tests, selenium must be installed

- selenium [?]

Preparing the development environment

-------------------------------------

2. Checkout the code and install the Python prerequisites. This assumes

that python is already installed on the host.

3. At this point you should have all required dependencies installed. Now you

have to select a database engine. The choices are: postgres, mysql and sqlite.

The python sqlite driver is available by default with Python so no additional 

configuration is required. Also, most self-respecting systems have the sqlite 

library installed by default.   

MySQL must be installed first

	$sudo port install mysql5

Install the MySQL python library

	mysql> show databases;

	mysql> GRANT ALL on synnefo.* TO username IDENTIFIED BY 'password';

	$ sudo apt-get install postgresql-8.4 libpq-dev

	$ sudo port install postgresql84

Install the postgres Python library

and then copy/edit according to the database used:  

	PROJECT_PATH = os.path.dirname(os.path.abspath(__file__)) + '/'

	    }

	}

	DATABASES = {

	    'default': {

		'ENGINE': 'django.db.backends.mysql', 

	    }

	}

    DATABASES = {

	    'default': {

	$ ./bin/python manage.py sql db

	$ ./bin/python manage.py syncdb

	$ ./bin/python manage.py migrate db

10. (Hopefully) Done

South Database Migrations

------------------------

    $ ./bin/python manage.py syncdb       # Create / update the database with the south tables

    $ ./bin/python manage.py migrate db   # Perform migration in the database

For example:

All starred migrations are applied.

Do not use the syncdb management command. It can only be used

See "Initial Migration" section.

    $ ./bin/python manage.py schemamigration db --auto

    $ ./bin/python migrate db

    Installing json fixture 'initial_data' from '/home/bkarak/devel/synnefo/../synnefo/db/fixtures'.

    Installed 1 object(s) from 1 fixture(s)

    $ ./bin/python manage.py schemamigration db --auto

     ? The field 'SynnefoUser.new_south_field_2' does not have a default specified, yet is NOT NULL.

     ?  2. Specify a one-off value to use for existing columns now

     ? Please select a choice: 1

    1. Introduce the changes in the code and fixtures (initial data).

    2. Execute:

    $ ./bin/python manage.py datamigration db rename_credit_wallet

    Created 0003_rename_credit_wallet.py.

    class Migration(DataMigration):

http://south.aeracode.org/

UI Testing

----------

The functional ui tests require the Selenium server and the synnefo app to 

    $ ./bin/python manage.py runserver &

    $ ./bin/python manage.py test ui

Test coverage

-------------