README.upgrade 2.68 KB
Newer Older
1
2
3
4
README.Upgrade
===============

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

7
8
9
10
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
Georgios Gousios's avatar
Georgios Gousios committed
11
12
13
14
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
15

Georgios Gousios's avatar
Georgios Gousios committed
16
17
18
19
          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.
20
21
22
23
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/)
24

25
v0.5.3 -> v0.5.4
26
REPOSITORY
27
    * Split Synnefo Ganeti tools to snf-ganeti-tools, with Debian packaging
28
29
30
31
32

REMOVED APPS
    * The ganeti/ app has been removed from the Django project completely.
      Any explicit references to it in Django settings must be removed.

33
DJANGO SETTINGS
34
35
    * snf-ganeti-tools is configured independently from Django,
      need to add proper /etc/synnefo/settings.conf
36
37
38
39
    * 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
40
41
42
43

DB MIGRATIONS
    * 0018_auto__add_field_virtualmachine_buildpercentage

44
PACKAGING
45
46
    * Split Synnefo Ganeti tools to separate snf-ganeti-tools Debian package

47
NEW DEPENDENCIES
48
49
    * python-prctl: Needed by the snf-progress-monitor,
      specified as a dependency of the snf-ganeti-tools Debian package.
50

51
52
53
54
EXTERNAL COMPONENTS
    * Ganeti Instance Image must be upgraded to support progress monitoring,
      please see README.deploy.

55

Georgios Gousios's avatar
Georgios Gousios committed
56
57
58
59
60
61
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

62
REMOVED SETTINGS
Georgios Gousios's avatar
Georgios Gousios committed
63
64
65
    * 00-admins.conf:SYSTEM_EMAIL_ADDR
    * 90-okeanos.conf.sample:APP_INSTALL_URL

Georgios Gousios's avatar
Georgios Gousios committed
66

67
68
69
70
v0.5.1 -> v0.5.2
NEW SETTINGS
    * 10-backend.py:GANETI_CREATEINSTANCE_KWARGS

71
REMOVED SETTINGS
Georgios Gousios's avatar
Georgios Gousios committed
72
73
    * 10-backend.conf:GANETI_OS_PROVIDER
    * 20-api.conf:GANETI_DISK_TEMPLATE
74
75
76
77
78
79

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