README.upgrade 4.18 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

Giorgos Verigakis's avatar
Giorgos Verigakis committed
7
v0.6.1 -> v0.6.2
8
ADMIN INTERFACE
Giorgos Verigakis's avatar
Giorgos Verigakis committed
9
10
11
12
13
    * 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.

14
15
16
17
COMPONENTS
    * Only the Django webapp is affected, must restart the logic dispatcher
      due to DB migration taking place.

Giorgos Verigakis's avatar
Giorgos Verigakis committed
18

19
20
21
22
23
24
25
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.

26
27
RECONCILIATION
    * Implemented new reconciliation management command, please see
28
      ./manage.py reconcile --help and README.admin for more info.
29
30
31
      Recommended to run ./manage.py reconcile --detect-all periodically,
      via cron.

32
33
34
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:
35
      https://code.grnet.gr/projects/gnt-instance-image/files
36

37
38
39
40
COMPONENTS
    * snf-ganeti-tools must be rebuilt, see snf-ganeti-tools/debian/
      for Debian packaging.

41
42
NEW SETTINGS
    * 30-ui.conf:SUGGESTED_FLAVORS
Kostas Papadimitriou's avatar
Kostas Papadimitriou committed
43
    * 30-ui.conf:VM_IMAGE_COMMON_METADATA
44

45

46
47
48
49
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
50

Georgios Gousios's avatar
Georgios Gousios committed
51
52
53
54
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
55

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

61
62
63
64
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/)
65

Vangelis Koukis's avatar
Vangelis Koukis committed
66
67
68
COMPONENTS
    * snf-ganeti-tools must be rebuilt, see snf-ganeti-tools/debian/
      for Debian packaging.
69

Vangelis Koukis's avatar
Vangelis Koukis committed
70

71
v0.5.3 -> v0.5.4
72
REPOSITORY
73
    * Split Synnefo Ganeti tools to snf-ganeti-tools, with Debian packaging
74
75
76
77
78

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

79
DJANGO SETTINGS
80
81
    * snf-ganeti-tools is configured independently from Django,
      need to add proper /etc/synnefo/settings.conf
82
83
84
85
    * 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
86
    * ~okeanos intro: OKEANOS_VIDEO_FLOWPLAYER_URL: New setting
87
88
89
90

DB MIGRATIONS
    * 0018_auto__add_field_virtualmachine_buildpercentage

91
PACKAGING
92
93
    * Split Synnefo Ganeti tools to separate snf-ganeti-tools Debian package

94
NEW DEPENDENCIES
95
96
    * python-prctl: Needed by the snf-progress-monitor,
      specified as a dependency of the snf-ganeti-tools Debian package.
97

98
99
100
101
EXTERNAL COMPONENTS
    * Ganeti Instance Image must be upgraded to support progress monitoring,
      please see README.deploy.

102

Georgios Gousios's avatar
Georgios Gousios committed
103
104
105
106
107
108
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

109
REMOVED SETTINGS
Georgios Gousios's avatar
Georgios Gousios committed
110
111
112
    * 00-admins.conf:SYSTEM_EMAIL_ADDR
    * 90-okeanos.conf.sample:APP_INSTALL_URL

Georgios Gousios's avatar
Georgios Gousios committed
113

114
115
116
117
v0.5.1 -> v0.5.2
NEW SETTINGS
    * 10-backend.py:GANETI_CREATEINSTANCE_KWARGS

118
REMOVED SETTINGS
Georgios Gousios's avatar
Georgios Gousios committed
119
120
    * 10-backend.conf:GANETI_OS_PROVIDER
    * 20-api.conf:GANETI_DISK_TEMPLATE
121
122
123
124
125
126

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