From 4c6f8e87198a39161aa3d4611807e82df921bfb0 Mon Sep 17 00:00:00 2001 From: kwadronaut Date: Thu, 18 Feb 2016 10:33:36 +0100 Subject: move upgrading platform doc, add it to menu --- README.md | 3 +- amber/menu.txt | 5 +- pages/docs/platform/details/upgrading.md | 90 ------------------------------ pages/docs/platform/tutorials/upgrading.md | 90 ++++++++++++++++++++++++++++++ 4 files changed, 95 insertions(+), 93 deletions(-) delete mode 100644 pages/docs/platform/details/upgrading.md create mode 100644 pages/docs/platform/tutorials/upgrading.md diff --git a/README.md b/README.md index 278f4f6..3ca30c0 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,8 @@ language negotiation. A static website generator called `amber` is used to render the source files into html files. To submit changes, please fork this repo and issue pull requests on github. -Content and color changes are in Pages, layout and menu in the Amber subdirectory. +Menu changes are in the Amber subdirectory, Content and color changes are in +Pages. For more information how to use `amber`, see: https://github.com/leapcode/amber. diff --git a/amber/menu.txt b/amber/menu.txt index 89d8550..8acf059 100644 --- a/amber/menu.txt +++ b/amber/menu.txt @@ -44,6 +44,7 @@ docs quick-start single-node-vpn single-node-email + upgrading vagrant services couchdb @@ -55,13 +56,13 @@ docs webapp troubleshooting tests - where-to-look known-issues vagrant + where-to-look details faq - ports development + ports under-the-hood client user-install diff --git a/pages/docs/platform/details/upgrading.md b/pages/docs/platform/details/upgrading.md deleted file mode 100644 index 8b0dd20..0000000 --- a/pages/docs/platform/details/upgrading.md +++ /dev/null @@ -1,90 +0,0 @@ -@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/ start'. - -Just ignore it, it should be fixed on reboot/deploy. - 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/ start'. + +Just ignore it, it should be fixed on reboot/deploy. + -- cgit v1.2.3