diff --git a/Release-notes.rst b/Release-notes.rst index 8c603f5..c105b3d 100644 --- a/Release-notes.rst +++ b/Release-notes.rst @@ -3,25 +3,21 @@ Release notes ============= -.. todo Replace x with correct date - -v0.14 September x 2018 +v0.14 October 8 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. + 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). @@ -106,6 +102,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 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 + +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: :: + + $ 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 -------------------