Revision 61c39121 docs/upgrade/upgrade-0.14.rst
| b/docs/upgrade/upgrade-0.14.rst | ||
|---|---|---|
| 1 | 1 |
Upgrade to Synnefo v0.14 |
| 2 | 2 |
^^^^^^^^^^^^^^^^^^^^^^^^ |
| 3 | 3 |
|
| 4 |
The bulk of the upgrade to v0.14 is about resource and quota migrations.
|
|
| 4 |
The upgrade to v0.14 consists in three steps:
|
|
| 5 | 5 |
|
| 6 |
1. Bring down services and backup databases. |
|
| 7 |
|
|
| 8 |
2. Upgrade packages, migrate the databases and configure settings. |
|
| 9 |
|
|
| 10 |
3. Register services to astakos and perform a quota-related data migration. |
|
| 6 | 11 |
|
| 7 | 12 |
.. warning:: |
| 8 | 13 |
|
| 9 | 14 |
It is strongly suggested that you keep separate database backups |
| 10 |
for each service after the completion of each of step.
|
|
| 15 |
for each service after the completion of each step. |
|
| 11 | 16 |
|
| 12 | 17 |
1. Bring web services down, backup databases |
| 13 | 18 |
============================================ |
| ... | ... | |
| 15 | 20 |
1. All web services must be brought down so that the database maintains a |
| 16 | 21 |
predictable and consistent state during the migration process:: |
| 17 | 22 |
|
| 18 |
# service gunicorn stop
|
|
| 19 |
# service snf-dispatcher stop
|
|
| 20 |
# etc.
|
|
| 23 |
$ service gunicorn stop
|
|
| 24 |
$ service snf-dispatcher stop
|
|
| 25 |
etc. |
|
| 21 | 26 |
|
| 22 | 27 |
2. Backup databases for recovery to a pre-migration state. |
| 23 | 28 |
|
| ... | ... | |
| 27 | 32 |
2. Upgrade Synnefo and configure settings |
| 28 | 33 |
========================================= |
| 29 | 34 |
|
| 30 |
2.2 Sync and migrate Django DB |
|
| 31 |
------------------------------ |
|
| 35 |
2.1 Install the new versions of packages |
|
| 36 |
---------------------------------------- |
|
| 37 |
|
|
| 38 |
:: |
|
| 39 |
|
|
| 40 |
astakos.host$ apt-get install \ |
|
| 41 |
snf-common \ |
|
| 42 |
astakosclient \ |
|
| 43 |
snf-django-lib \ |
|
| 44 |
snf-webproject \ |
|
| 45 |
snf-branding \ |
|
| 46 |
snf-astakos-app |
|
| 47 |
|
|
| 48 |
cyclades.host$ apt-get install \ |
|
| 49 |
snf-common \ |
|
| 50 |
astakosclient \ |
|
| 51 |
snf-django-lib \ |
|
| 52 |
snf-webproject \ |
|
| 53 |
snf-branding \ |
|
| 54 |
snf-pithos-backend \ |
|
| 55 |
snf-vncauthproxy \ |
|
| 56 |
snf-cyclades-app |
|
| 57 |
|
|
| 58 |
pithos.host$ apt-get install \ |
|
| 59 |
snf-common \ |
|
| 60 |
astakosclient \ |
|
| 61 |
snf-django-lib \ |
|
| 62 |
snf-webproject \ |
|
| 63 |
snf-branding \ |
|
| 64 |
snf-pithos-backend \ |
|
| 65 |
snf-pithos-app \ |
|
| 66 |
snf-pithos-webclient |
|
| 67 |
|
|
| 68 |
ganeti.node$ apt-get install \ |
|
| 69 |
snf-common \ |
|
| 70 |
snf-network \ |
|
| 71 |
snf-cyclades-gtools \ |
|
| 72 |
snf-pithos-backend |
|
| 73 |
|
|
| 74 |
.. note:: |
|
| 75 |
|
|
| 76 |
Installing the packages will cause services to start. Make sure you bring |
|
| 77 |
them down again (at least ``gunicorn``, ``snf-dispatcher``) |
|
| 78 |
|
|
| 79 |
|
|
| 80 |
2.2 Sync and migrate the database |
|
| 81 |
--------------------------------- |
|
| 32 | 82 |
|
| 33 | 83 |
.. note:: |
| 34 | 84 |
|
| ... | ... | |
| 45 | 95 |
cyclades-host$ snf-manage syncdb |
| 46 | 96 |
cyclades-host$ snf-manage migrate |
| 47 | 97 |
|
| 98 |
pithos-host$ pithos-migrate upgrade head |
|
| 48 | 99 |
|
| 49 | 100 |
2.3 Configure Base URL settings for all services |
| 50 | 101 |
------------------------------------------------ |
Also available in: Unified diff