move upgrading platform doc, add it to menu

1 files changed, 90 insertions, 0 deletions

diff --git a/pages/docs/platform/tutorials/upgrading.md b/pages/docs/platform/tutorials/upgrading.md
new file mode 100644
index 0000000..8b0dd20
--- /dev/null
+++ b/pages/docs/platform/tutorials/upgrading.md
@@ -0,0 +1,90 @@
+@title = 'Upgrading'
+@nav_title = 'Upgrading'
+@summary = "Upgrading the platform and the OS"
+@toc = true
+
+
+Upgrading the platform
+======================
+
+From 0.7.1 to 0.8
+=================
+
+Next to other changesm 0.8 introduces several major changes that need do get taken into account while upgrading:
+
+- Dropping Debian Wheezy support. You need to upgrade your nodes to jessie before deploying a platform upgrade.
+- Dropping Bigcouch support. LEAP Platform now requires couchdb and therefore you need to migrate from bigcouch to couchdb.
+
+Here's how to upgrade from wheezy nodes running bigcouch to jessie nodes using couchdb:
+
+- Follow https://leap.se/en/docs/platform/services/couchdb#migrating-from-bigcouch-to-plain-couchdb, but only until the step where you removed bigouch.
+
+- Now upgrade to jessie (see the Howto below)
+
+- Continue with https://leap.se/en/docs/platform/services/couchdb#migrating-from-bigcouch-to-plain-couchdb at the point where you stopped for the first step, and deploy to the couchdb node.
+
+
+Upgrading the operating system
+==============================
+
+From Debian Wheezy to Jessie
+----------------------------
+
+There are the [Debian release notes on how to upgrade from wheezy to jessie](https://www.debian.org/releases/stable/amd64/release-notes/ch-upgrading.html).
+He're the steps that worked for us, but please keep in mind that this is not a bullet-prove documentation, so use it on your own risk:
+
+    screen
+    script -t 2>~/leap_upgrade-jessiestep.time -a ~/upgrade-jessiestep.script
+
+    apt-get autoremove
+    apt-get update
+    DEBIAN_FRONTEND=noninteractive apt-get -y -o DPkg::Options::=--force-confold dist-upgrade
+ 
+    dpkg --audit
+    dpkg --get-selections | grep 'hold$'
+    # if anything is held, you need to resolve it before continuing.
+
+    apt-get clean
+
+    # switch sources to jessie
+    sed -i 's/wheezy/jessie/g' /etc/apt/sources.list
+    echo "deb http://deb.leap.se/0.8 jessie main" > /etc/apt/sources.list.d/leap.list
+
+    # remove pinnings to wheezy
+    rm /etc/apt/preferences
+
+    apt-get update
+
+    # test there is enough space for the upgrade
+    apt-get -o APT::Get::Trivial-Only=true dist-upgrade
+
+    # do first stage upgrade
+    DEBIAN_FRONTEND=noninteractive apt-get -y -o DPkg::Options::=--force-confold upgrade
+
+    # repeat dist-upgrade until it makes no more changes:
+    DEBIAN_FRONTEND=noninteractive apt-get -y -o DPkg::Options::=--force-confold dist-upgrade
+
+    # resolve any apt issues if there are some
+    apt-get -f install
+
+    reboot
+
+
+
+
+
+
+
+
+### Issues
+
+- Failure restarting some services for OpenSSL upgrade
+
+If you get this warning:
+
+    The following services could not be restarted for the OpenSSL library upgrade:
+      postfix
+    You will need to start these manually by running '/etc/init.d/<service> start'.
+
+Just ignore it, it should be fixed on reboot/deploy.
+