Commit 29f915b1 authored by Giorgos Korfiatis's avatar Giorgos Korfiatis
Browse files

docs: Upgrade sketch for 0.15

parent 3023abfd
......@@ -1839,6 +1839,7 @@ Upgrade Notes
v0.13 -> v0.14 <upgrade/upgrade-0.14>
v0.14 -> v0.14.2 <upgrade/upgrade-0.14.2>
v0.14.5 -> v0.14.6 <upgrade/upgrade-0.14.6>
v0.14 -> v0.15 <upgrade/upgrade-0.15>
Changelog, NEWS
......
Upgrade to Synnefo v0.15
^^^^^^^^^^^^^^^^^^^^^^^^
The upgrade to v0.15 consists in the following steps:
1. Bring down services and backup databases.
2. Upgrade packages, migrate the databases and configure settings.
3. Bring up all services.
.. warning::
It is strongly suggested that you keep separate database backups
for each service after the completion of each step.
1. Bring web services down, backup databases
============================================
1. All web services must be brought down so that the database maintains a
predictable and consistent state during the migration process::
$ service gunicorn stop
$ service snf-dispatcher stop
$ service snf-ganeti-eventd stop
2. Backup databases for recovery to a pre-migration state.
3. Keep the database servers running during the migration process.
2. Upgrade Synnefo and configure settings
=========================================
2.1 Install the new versions of packages
----------------------------------------
::
astakos.host$ apt-get install \
python-objpool \
snf-common \
python-astakosclient \
snf-django-lib \
snf-webproject \
snf-branding \
snf-astakos-app
cyclades.host$ apt-get install \
python-objpool \
snf-common \
python-astakosclient \
snf-django-lib \
snf-webproject \
snf-branding \
snf-pithos-backend \
snf-cyclades-app
pithos.host$ apt-get install \
python-objpool \
snf-common \
python-astakosclient \
snf-django-lib \
snf-webproject \
snf-branding \
snf-pithos-backend \
snf-pithos-app \
snf-pithos-webclient
ganeti.node$ apt-get install \
python-objpool \
snf-common \
snf-cyclades-gtools \
snf-pithos-backend
.. note::
Make sure `snf-webproject' has the same version with snf-common
.. note::
Installing the packages will cause services to start. Make sure you bring
them down again (at least ``gunicorn``, ``snf-dispatcher``)
2.2 Sync and migrate the database
---------------------------------
.. note::
If you are asked about stale content types during the migration process,
answer 'no' and let the migration finish.
::
astakos-host$ snf-manage syncdb
astakos-host$ snf-manage migrate
cyclades-host$ snf-manage syncdb
cyclades-host$ snf-manage migrate
pithos-host$ pithos-migrate upgrade head
3. Bring all services up
========================
After the upgrade is finished, we bring up all services:
.. code-block:: console
astakos.host # service gunicorn start
cyclades.host # service gunicorn start
pithos.host # service gunicorn start
cyclades.host # service snf-dispatcher start
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment