README.Upgrade
===============

This file documents the upgrade to newer versions of the Synnefo software.
For more information, please see README.deploy.

v0.6.2 -> v0.6.3

    * MAX_PERSONALITY and MAX_PERSONALITY_SIZE settings were added in
      20-api.conf.
    * Uniqueness constraints have been added to the metadata models.
      A database migration is needed.


v0.6.1 -> v0.6.2

API-CURRENT
    * 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.


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