Add upgrade notes and update admin guide

Changelog

@@ -6,6 +6,18 @@ Unified Changelog file for Synnefo versions >= 0.13
 Since v0.13 most of the Synnefo components have been merged into a single
 repository and have aligned versions.
 
+.. _Changelog-0.14.2:
+
+v0.14.2
+=======
+
+Released: UNRELEASED
+
+Cyclades
+--------
+
+* Add new setting PITHOS_BACKEND_POOL_SIZE, which configures the size
+  of the pool of Pithos backends that are used by plankton.
 
 .. _Changelog-0.14:
 

NEWS

@@ -6,6 +6,13 @@ Unified NEWS file for Synnefo versions >= 0.13
 Since v0.13 all Synnefo components have been merged into a single repository.
 
 
+.. _NEWS-0.14.2:
+
+v0.14.2
+=======
+
+Released: UNRELEASED
+
 .. _NEWS-0.14:
 
 v0.14

docs/admin-guide.rst

@@ -1802,10 +1802,13 @@ Upgrade Notes
 
    v0.12 -> v0.13 <upgrade/upgrade-0.13>
    v0.13 -> v0.14 <upgrade/upgrade-0.14>
+   v0.14 -> v0.14.2 <upgrade/upgrade-0.14.2>
 
 
 Changelog, NEWS
 ===============
 
+
+* v0.14.2 :ref:`Changelog <Changelog-0.14.2>`, :ref:`NEWS <NEWS-0.14.2>`
 * v0.14 :ref:`Changelog <Changelog-0.14>`, :ref:`NEWS <NEWS-0.14>`
 * v0.13 :ref:`Changelog <Changelog-0.13>`, :ref:`NEWS <NEWS-0.13>`

docs/upgrade/upgrade-0.14.2.rst

+Upgrade to Synnefo v0.14.2
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The upgrade from v0.14 to v0.14.2 consists in three steps:
+
+1. Bring down services and backup databases.
+
+2. Upgrade packages and  migrate Pithos database.
+
+3. Bring up all services.
+
+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
+
+2.2 Sync and migrate the database
+---------------------------------
+
+::
+
+    pithos-host$ pithos-migrate upgrade head
+
+
+5. 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