Synnefo

README.Upgrade

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

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

For more information, please see README.deploy.

v0.6.2 -> TBD

NEW DEPENDENCIES

    * python-unittest2, python-paramiko needed by the new integration

      test suite snf-tools/snf-test. Paramiko shipped with Squeeze uses

      broken RandomPool, produces warnings, see #576697.

NEW SETTINGS

    * EMAIL_SUBJECT_PREFIX:

      Prepended to automated emails, set to someting that uniquely identifies

      the deployment.

    * MAX_PERSONALITY and MAX_PERSONALITY_SIZE in 20-api.conf:

      Maximum number of files to be injected in newly created servers,

      maximum total size of encoded file contents.

DB MIGRATION

    * Uniqueness constraints have been added to the metadata models.

      A database migration is needed.

v0.6.1 -> v0.6.2

ADMIN INTERFACE

    * The models were changed so that Flavors and SynnefoUsers now have

      a deleted state. The admin tools were updated so that models are

      now marked as deleted instead of actually being deleted from the DB.

      A database migration is needed.

COMPONENTS

    * Only the Django webapp is affected, must restart the logic dispatcher

      due to DB migration taking place.

v0.5.5 -> v0.6

ADMIN INTERFACE

    * A new Web-based admin interface is available under /admin.

      It is accessible by users of type 'ADMIN' in the DB, with

      their authentication token. "snf-admin user modify" may be used

      to change the type of a specific user.

RECONCILIATION

    * Implemented new reconciliation management command, please see

      ./manage.py reconcile --help and README.admin for more info.

      Recommended to run ./manage.py reconcile --detect-all periodically,

      via cron.

GANETI-INSTANCE-IMAGE

    * A new version of ganeti-instance-image is required (v0.5.1-1-snf1).

      The new version is available for download as a debian package:

      https://code.grnet.gr/projects/gnt-instance-image/files

COMPONENTS

    * snf-ganeti-tools must be rebuilt, see snf-ganeti-tools/debian/

      for Debian packaging.

NEW SETTINGS

    * 30-ui.conf:SUGGESTED_FLAVORS

    * 30-ui.conf:VM_IMAGE_COMMON_METADATA

v0.5.4 -> v0.5.5

LOGGING

    * Changed the default logging settings for the dispatcher to also log

      to /var/log/synnefo/dispatcher.log, redirecting stderr and stdout there

QUEUES

    * Changed default routing key naming for queues. Queues must be redeclared.

      The suggested upgrade path is to delete ALL (even obsolete) existing

      queues and restart the dispatcher. To do so, download amqp-utils from

          https://github.com/dougbarth/amqp-utils

      and run the amqp-deleteq tool for each declared queue. Alternatively,

      amqp-utils can be installed with: sudo gem install amqp-utils.

UI

    * Feedback form now uses django native send_mail for sending emails.

      Proper django settings should be set for feedback mails to work

      (https://docs.djangoproject.com/en/dev/topics/email/)

COMPONENTS

    * snf-ganeti-tools must be rebuilt, see snf-ganeti-tools/debian/

      for Debian packaging.

v0.5.3 -> v0.5.4

REPOSITORY

    * Split Synnefo Ganeti tools to snf-ganeti-tools, with Debian packaging

REMOVED APPS

    * The ganeti/ app has been removed from the Django project completely.

      Any explicit references to it in Django settings must be removed.

DJANGO SETTINGS

    * snf-ganeti-tools is configured independently from Django,

      need to add proper /etc/synnefo/settings.conf

    * Removed 15-queues.conf: fix_amqp_settings (no need to call it anywhere)

    * Removed settings.d/98-ganeti-* due to split of snf-ganeti-tools

    * ~okeanos intro: OKEANOS_VIDEO_URL: Changed from string to dict

    * ~okeanos intro: OKEANOS_VIDEO_POSTER_IMAGE_URL: New setting

    * ~okeanos intro: OKEANOS_VIDEO_FLOWPLAYER_URL: New setting

DB MIGRATIONS

    * 0018_auto__add_field_virtualmachine_buildpercentage

PACKAGING

    * Split Synnefo Ganeti tools to separate snf-ganeti-tools Debian package

NEW DEPENDENCIES

    * python-prctl: Needed by the snf-progress-monitor,

      specified as a dependency of the snf-ganeti-tools Debian package.

EXTERNAL COMPONENTS

    * Ganeti Instance Image must be upgraded to support progress monitoring,

      please see README.deploy.

v0.5.2 -> v0.5.3

NEW SETTINGS

    * 30-ui.conf:LOGOUT_URL

    * 00-admins.conf:DEFAULT_FROM_EMAIL

    * 90-okeanos.conf.sample:LOGOUT_URL

REMOVED SETTINGS

    * 00-admins.conf:SYSTEM_EMAIL_ADDR

    * 90-okeanos.conf.sample:APP_INSTALL_URL

v0.5.1 -> v0.5.2

NEW SETTINGS

    * 10-backend.py:GANETI_CREATEINSTANCE_KWARGS

REMOVED SETTINGS

    * 10-backend.conf:GANETI_OS_PROVIDER

    * 20-api.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