README.upgrade 4.06 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
8
9
10
11
12
13
14
15
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.


16
17
18
19
20
21
22
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.

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

29
30
31
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:
32
      https://code.grnet.gr/projects/gnt-instance-image/files
33

34
35
36
37
COMPONENTS
    * snf-ganeti-tools must be rebuilt, see snf-ganeti-tools/debian/
      for Debian packaging.

38
39
NEW SETTINGS
    * 30-ui.conf:SUGGESTED_FLAVORS
Kostas Papadimitriou's avatar
Kostas Papadimitriou committed
40
    * 30-ui.conf:VM_IMAGE_COMMON_METADATA
41

42

43
44
45
46
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
47

Georgios Gousios's avatar
Georgios Gousios committed
48
49
50
51
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
52

Georgios Gousios's avatar
Georgios Gousios committed
53
54
55
56
          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.
57

58
59
60
61
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/)
62

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

Vangelis Koukis's avatar
Vangelis Koukis committed
67

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

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

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

DB MIGRATIONS
    * 0018_auto__add_field_virtualmachine_buildpercentage

88
PACKAGING
89
90
    * Split Synnefo Ganeti tools to separate snf-ganeti-tools Debian package

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

95
96
97
98
EXTERNAL COMPONENTS
    * Ganeti Instance Image must be upgraded to support progress monitoring,
      please see README.deploy.

99

Georgios Gousios's avatar
Georgios Gousios committed
100
101
102
103
104
105
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

106
REMOVED SETTINGS
Georgios Gousios's avatar
Georgios Gousios committed
107
108
109
    * 00-admins.conf:SYSTEM_EMAIL_ADDR
    * 90-okeanos.conf.sample:APP_INSTALL_URL

Georgios Gousios's avatar
Georgios Gousios committed
110

111
112
113
114
v0.5.1 -> v0.5.2
NEW SETTINGS
    * 10-backend.py:GANETI_CREATEINSTANCE_KWARGS

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

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