From a4398a95b7d1bb32847d4df6019ec2827719b1ae Mon Sep 17 00:00:00 2001 From: Martin Nordsletten Date: Mon, 8 Oct 2018 13:50:55 +0200 Subject: [PATCH 1/3] Created migration section in release notes --- Release-notes.rst | 25 +++++++++++++++++++++---- 1 file changed, 21 insertions(+), 4 deletions(-) diff --git a/Release-notes.rst b/Release-notes.rst index 8c603f5..69e47a4 100644 --- a/Release-notes.rst +++ b/Release-notes.rst @@ -11,10 +11,7 @@ v0.14 September x 2018 .. warning:: All information stored in your Mothership today must be **DELETED** before starting this Mothership version for the first time. - If you need anything that is stored in your Mothership, take a backup of the ``runtime_files`` folder **BEFORE** starting the Mothership. - - When starting this Mothership version for the **FIRST TIME**, add the ``--clean`` flag to the ``mothership serve`` command. - This will delete all folders in the Mothership's ``runtime_files`` folder, which includes NaCls, images, instances data and more. + If you need anything that is stored in your Mothership, take a backup of the ``runtime_files`` folder **BEFORE** starting the Mothership. For more info about migrating to this new release see: :ref:`migrating_13_14` .. warning:: @@ -106,6 +103,26 @@ v0.14 September x 2018 - When searching through images, also search through the image's uplink information +.. _migrating_13_14: + +Migrating from old release +~~~~~~~~~~~~~~~~~~~~~~~~~~ +Due to a lot of internal changes to how files are stored in this release of Mothership it is highly recommended to perform a deletion of all old files. This will affect: + +- NaCls +- Images +- Uplinks +- Issues +- Instance logs and history + +In order to prevent the loss of this information a backup must be made. To upgrade from a previous Mothership version to v0.14 we recommend the following procedure: + +1. Perform a backup of all information that should be kept. Scripting this with the Mothership CLI is possible. Example shows how all the existing NaCls are pulled and stored: :: + + $ nacls=("$( nacls -o id)") + $ for i in ${nacls[@]}; do pull-nacl "$i"; done +2. Launch Mothership with the ``--clean`` option, this will erase all persistent information. +3. Upload any files from the backup that should be available on the new Mothership. v0.13 April 16 2018 ------------------- From 9139d6aad090e410a337d82fd1e3f93deb3dd788 Mon Sep 17 00:00:00 2001 From: Martin Nordsletten Date: Mon, 8 Oct 2018 13:52:18 +0200 Subject: [PATCH 2/3] Changed wording of some warning messages --- Release-notes.rst | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/Release-notes.rst b/Release-notes.rst index 69e47a4..4c1f7b1 100644 --- a/Release-notes.rst +++ b/Release-notes.rst @@ -9,16 +9,17 @@ v0.14 September x 2018 ---------------------- .. warning:: - - All information stored in your Mothership today must be **DELETED** before starting this Mothership version for the first time. - If you need anything that is stored in your Mothership, take a backup of the ``runtime_files`` folder **BEFORE** starting the Mothership. For more info about migrating to this new release see: :ref:`migrating_13_14` + It is recommended to **DELETE** all existing files before starting this Mothership version for the first time. + For more info about migrating to this new release see: :ref:`migrating_13_14` .. warning:: - This Mothership release contains **BREAKING CHANGES** and will only work with IncludeOS version v0.12.0-645-g51f6fb3 or newer. If you need to build with a previous IncludeOS version, you need to checkout the previous release of Mothership. All running instances **MUST** be rebuilt and relaunched to be able to receive updates from this Mothership. +.. warning:: + With the release of IncludeOS version v0.13.0-rc.1 a change to Liveupdate means that all existing Starbases **MUST** be changed. Any attempt to deploy a new image to an instance running an old IncludeOS version is not guaranteed to work correctly. + - TLS on uplink TLS on uplink is now default and all uplink URLs **MUST** start with either ``https://`` (secure / TLS) or ``http://`` (not secure / no TLS). @@ -107,7 +108,7 @@ v0.14 September x 2018 Migrating from old release ~~~~~~~~~~~~~~~~~~~~~~~~~~ -Due to a lot of internal changes to how files are stored in this release of Mothership it is highly recommended to perform a deletion of all old files. This will affect: +Due to internal changes to how files are stored in this release of Mothership it is highly recommended to perform a deletion of all old files. This will affect: - NaCls - Images @@ -115,7 +116,7 @@ Due to a lot of internal changes to how files are stored in this release of Moth - Issues - Instance logs and history -In order to prevent the loss of this information a backup must be made. To upgrade from a previous Mothership version to v0.14 we recommend the following procedure: +If you need anything that is stored in your Mothership, take a backup of the ``runtime_files`` folder **BEFORE** starting the Mothership. To upgrade from a previous Mothership version to v0.14 we recommend the following procedure: 1. Perform a backup of all information that should be kept. Scripting this with the Mothership CLI is possible. Example shows how all the existing NaCls are pulled and stored: :: From 92c50d2c8ed81b622cb15d13b9167082b6fb6f4f Mon Sep 17 00:00:00 2001 From: Martin Nordsletten Date: Mon, 8 Oct 2018 13:53:53 +0200 Subject: [PATCH 3/3] Date of v0.14 release: October 8 2018 --- Release-notes.rst | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/Release-notes.rst b/Release-notes.rst index 4c1f7b1..c105b3d 100644 --- a/Release-notes.rst +++ b/Release-notes.rst @@ -3,9 +3,7 @@ Release notes ============= -.. todo Replace x with correct date - -v0.14 September x 2018 +v0.14 October 8 2018 ---------------------- .. warning::