Merge pull request #2397 from bacongobbler/patch-7

docs(troubleshooting): added instructions on manually updating CoreOS

Author: Matthew Fisher

docs/managing_deis/upgrading-deis.rst

@@ -147,3 +147,34 @@ new cluster, you would create a DNS record that looks like the following:
 Retire the old cluster
 ^^^^^^^^^^^^^^^^^^^^^^
 Once all applications have been validated, the old cluster can be retired.
+
+
+Upgrading CoreOS
+----------------
+
+Sometimes you may need to update CoreOS manually in order to get Deis to work. For example, Deis
+requires a minimum of CoreOS v471.1.0 for Ceph FS support. To update CoreOS, run the following
+commands:
+
+.. code-block:: console
+
+    $ ssh core@<server ip>
+    $ sudo su
+    $ systemctl unmask update-engine.service
+    $ systemctl start update-engine.service
+    $ update_engine_client -update
+    $ systemctl stop update-engine.service
+    $ systemctl mask update-engine.service
+    $ reboot
+
+You can check the CoreOS version by running the following command on the CoreOS machine:
+
+.. code-block:: console
+
+    $ cat /etc/os-release
+
+Or from your local machine:
+
+.. code-block:: console
+
+    $ ssh core@<server ip> 'cat /etc/os-release'