Synnefo

The Synnefo package needs to be installed on nodes of type :ref:`APISERVER_NODE`, 

:ref:`LOGIC_NODE` and :ref:`WEBAPP_NODE` nodes with properly configured  

:ref:`settings <configuration>`. 

This guide also covers in some detail instructions on how to set up additional

additional software required by Synnefo to run properly.

:ref:`GANETI-MASTER <GANETI_NODES>` and a number of :ref:`GANETI-NODEs <GANETI_NODES>`.

``virtualenv`` python installation and the following commands should be 

available from the command line::

    $ synnefo-manage

    $ synnefo-dispatcher

    $ synnefo-admin

Notice that Synnefo installation does not handle the creation of

``/etc/synnefo/`` directory which is the place where custom configuration 

files are loaded from. You are encouraged to create this directory and place a 

file named ``settings.conf`` containing the following:

.. code-block:: python

    # database configuration

    DATABASES = {

        'default': {

            'ENGINE': 'django.db.backends.', # Add 'postgresql_psycopg2', 'mysql', 'sqlite3' or 'oracle'.

            'NAME': '',                      # Or path to database file if using sqlite3.

            'USER': '',                      # Not used with sqlite3.

            'PASSWORD': '',                  # Not used with sqlite3.

            'HOST': '',                      # Set to empty string for localhost. Not used with sqlite3.

            'PORT': '',                      # Set to empty string for default. Not used with sqlite3.

        }

    }

    # where synnefo static files exist

    MEDIA_ROOT = '/var/lib/synnefo/static/'

    # rabitmq configuration

    RABBIT_HOST = ""

    RABBIT_USERNAME = ""

    RABBIT_PASSWORD = ""

    RABBIT_VHOST = "/"

    GANETI_MASTER_IP = ""

    GANETI_CLUSTER_INFO = (GANETI_MASTER_IP, 5080, "<username>", "<password>")

    # This prefix gets used when determining the instance names

    # of Synnefo VMs at the Ganeti backend.

    # The dash must always appear in the name!

    BACKEND_PREFIX_ID = "<prefix>-"

this is just to get you started on how to configure your Synnefo installation.

From this point you can continue your read to the `Initial configuration`_ section 

in this document which contains quickstart instructions for some of the initial

configuration required for Synnefo to get up and running.

For additional instructions about Synnefo settings files and what the available 

options are, you can refer to the :ref:`configuration` guide.

Synnefo comes with most of the required settings predefined with values that 

would cover many of the most common installation scenarios. However some basic

settings must be set be set before running Synnefo for the first time.

See :ref:`database-configuration`