Merge pull request #23 from mnordsletten/master

Date, Warnings updated and added migrating subsection

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=("$(<mothership-bin> nacls -o id)")
+    $ for i in ${nacls[@]}; do <mothership-bin> 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
 -------------------