Synnefo

README.Upgrade

===============

This file documents the upgrade to newer versions of the Synnefo software.

v0.5.1 -> v0.5.2

NEW SETTINGS

    * 10-backend.py:GANETI_CREATEINSTANCE_KWARGS

REMOVE SETTINGS

    * 10-backend.conf/GANETI_OS_PROVIDER

    * 20-apo.conf/GANETI_DISK_TEMPLATE

BACKEND CHANGES

    * Need to patch Ganeti, file:

      lib/python2.6/site-packages/ganeti/rapi/rlib2.py

      to honor the wait_for_sync flag, see Synnefo #835.

      Patch provided under contrib/patches/ganeti-rlib2.py-v0.5.2

README.deploy -- Instructions for a basic Synnefo deployment

It is current as of Synnefo v0.5.2.

    recommended to use the win-support branch (known good commit for 0.5.2:

--- rlib2.py    2011-07-17 20:45:56.000000000 +0300

+++ rlib2.py.20110717   2011-07-17 20:45:51.000000000 +0300

@@ -785,7 +785,7 @@

     src_node=baserlib.CheckParameter(data, "src_node", default=None),

     src_path=baserlib.CheckParameter(data, "src_path", default=None),

     start=baserlib.CheckParameter(data, "start", default=True),

-    wait_for_sync=baserlib.CheckParameter(data, "wait_for_sync", default=True),

+    wait_for_sync=True,

     ip_check=baserlib.CheckParameter(data, "ip_check", default=True),

     name_check=baserlib.CheckParameter(data, "name_check", default=True),

     file_storage_dir=baserlib.CheckParameter(data, "file_storage_dir",

    # Handle arguments to CreateInstance() as a dictionary,

    # initialize it based on a deployment-specific value.

    # This enables the administrator to override deployment-specific

    # arguments, such as the disk templatei to use, name of os provider

    # and hypervisor-specific parameters at will (see Synnefo #785, #835).

    #

    kw = settings.GANETI_CREATEINSTANCE_KWARGS

    kw['mode'] = 'create'

    kw['name'] = vm.backend_id

    # Defined in settings.GANETI_CREATE_INSTANCE_KWARGS

    # kw['disk_template'] = settings.GANETI_DISK_TEMPLATE

    kw['disks'] = [{"size": sz}]

    kw['nics'] = [nic]

    # Defined in settings.GANETI_CREATE_INSTANCE_KWARGS

    # kw['os'] = settings.GANETI_OS_PROVIDER

    kw['ip_check'] = False

    kw['name_check'] = False

    # Do not specific a node explicitly, have

    # Ganeti use an iallocator instead

    #

    # kw['pnode']=rapi.GetNodes()[0]

    kw['dry_run'] = settings.TEST

    kw['beparams'] = dict(auto_balance=True, vcpus=flavor.cpu,

                          memory=flavor.ram)

    kw['osparams'] = dict(img_id=image.backend_id, img_passwd=password,

                         img_format=image.format)

    # Defined in settings.GANETI_CREATE_INSTANCE_KWARGS

    # kw['hvparams'] = dict(serial_console=False)

    return rapi.CreateInstance(**kw)

# The following dictionary defines deployment-specific

# arguments to the RAPI CreateInstance call.

# At a minimum it should contain the

# 'disk_template', 'os_provider', and 'hvparams' keys.

#

# More specifically:

# a) disk_template:

#    The disk template to use when creating the instance.

#    Suggested values: 'plain', or 'drbd'.

# b) os:

#    The OS provider to use (customized Ganeti Instance Image)

# c) hvparams:

#    Hypervisor-specific parameters (serial_console = False, see #785)

# d) If using the DRBD disk_template, you may want to include

#    wait_for_sync = False (see #835).

#

GANETI_CREATEINSTANCE_KWARGS = {

    'disk_template': 'drbd',

    'os': 'image+default',

    'hvparams': {'serial_console': False},

    'wait_for_sync': False}