root / docs / upgrade / upgrade-0.16.rst @ fd050112
History | View | Annotate | Download (3.4 kB)
| 1 |
Upgrade to Synnefo v0.16 |
|---|---|
| 2 |
^^^^^^^^^^^^^^^^^^^^^^^^ |
| 3 |
|
| 4 |
|
| 5 |
Upgrade Steps |
| 6 |
============= |
| 7 |
|
| 8 |
The upgrade to v0.16 consists in the following steps: |
| 9 |
|
| 10 |
1. Bring down services and backup databases. |
| 11 |
|
| 12 |
2. Upgrade packages, migrate the databases and configure settings. |
| 13 |
|
| 14 |
3. __placeholder__ |
| 15 |
|
| 16 |
4. Bring up all services. |
| 17 |
|
| 18 |
.. warning:: |
| 19 |
|
| 20 |
It is strongly suggested that you keep separate database backups |
| 21 |
for each service after the completion of each step. |
| 22 |
|
| 23 |
1. Bring web services down, backup databases |
| 24 |
============================================ |
| 25 |
|
| 26 |
1. All web services must be brought down so that the database maintains a |
| 27 |
predictable and consistent state during the migration process:: |
| 28 |
|
| 29 |
$ service gunicorn stop |
| 30 |
$ service snf-dispatcher stop |
| 31 |
$ service snf-ganeti-eventd stop |
| 32 |
|
| 33 |
2. Backup databases for recovery to a pre-migration state. |
| 34 |
|
| 35 |
3. Keep the database servers running during the migration process. |
| 36 |
|
| 37 |
|
| 38 |
2. Upgrade Synnefo and configure settings |
| 39 |
========================================= |
| 40 |
|
| 41 |
2.1 Install the new versions of packages |
| 42 |
---------------------------------------- |
| 43 |
|
| 44 |
:: |
| 45 |
|
| 46 |
astakos.host$ apt-get install \ |
| 47 |
python-objpool \ |
| 48 |
snf-common \ |
| 49 |
python-astakosclient \ |
| 50 |
snf-django-lib \ |
| 51 |
snf-webproject \ |
| 52 |
snf-branding \ |
| 53 |
snf-astakos-app |
| 54 |
|
| 55 |
cyclades.host$ apt-get install \ |
| 56 |
python-objpool \ |
| 57 |
snf-common \ |
| 58 |
python-astakosclient \ |
| 59 |
snf-django-lib \ |
| 60 |
snf-webproject \ |
| 61 |
snf-branding \ |
| 62 |
snf-pithos-backend \ |
| 63 |
snf-cyclades-app |
| 64 |
|
| 65 |
pithos.host$ apt-get install \ |
| 66 |
python-objpool \ |
| 67 |
snf-common \ |
| 68 |
python-astakosclient \ |
| 69 |
snf-django-lib \ |
| 70 |
snf-webproject \ |
| 71 |
snf-branding \ |
| 72 |
snf-pithos-backend \ |
| 73 |
snf-pithos-app \ |
| 74 |
snf-pithos-webclient |
| 75 |
|
| 76 |
ganeti.node$ apt-get install \ |
| 77 |
python-objpool \ |
| 78 |
snf-common \ |
| 79 |
snf-cyclades-gtools \ |
| 80 |
snf-pithos-backend \ |
| 81 |
snf-network |
| 82 |
|
| 83 |
.. note:: |
| 84 |
|
| 85 |
Make sure `snf-webproject' has the same version with snf-common |
| 86 |
|
| 87 |
.. note:: |
| 88 |
|
| 89 |
Installing the packages will cause services to start. Make sure you bring |
| 90 |
them down again (at least ``gunicorn``, ``snf-dispatcher``) |
| 91 |
|
| 92 |
2.2 Sync and migrate the database |
| 93 |
--------------------------------- |
| 94 |
|
| 95 |
.. note:: |
| 96 |
|
| 97 |
If you are asked about stale content types during the migration process, |
| 98 |
answer 'no' and let the migration finish. |
| 99 |
|
| 100 |
:: |
| 101 |
|
| 102 |
astakos-host$ snf-manage syncdb |
| 103 |
astakos-host$ snf-manage migrate |
| 104 |
|
| 105 |
cyclades-host$ snf-manage syncdb |
| 106 |
cyclades-host$ snf-manage migrate |
| 107 |
|
| 108 |
pithos-host$ pithos-migrate upgrade head |
| 109 |
|
| 110 |
|
| 111 |
3. __placeholder__ |
| 112 |
================== |
| 113 |
|
| 114 |
|
| 115 |
4. Bring all services up |
| 116 |
======================== |
| 117 |
|
| 118 |
After the upgrade is finished, we bring up all services: |
| 119 |
|
| 120 |
.. code-block:: console |
| 121 |
|
| 122 |
astakos.host # service gunicorn start |
| 123 |
cyclades.host # service gunicorn start |
| 124 |
pithos.host # service gunicorn start |
| 125 |
|
| 126 |
cyclades.host # service snf-dispatcher start |