Merge pull request #2369 from carmstrong/add_coreos_version

docs(*): specify required CoreOS version

Author: carmstrong

README.md

@@ -21,6 +21,7 @@ Trying out Deis? Continue following these instructions for a local installation
  * Due to its nature as a distributed system, we strongly recommend using Deis with a minimum of 3 nodes even for local development and testing
  * The Deis "control plane" containers will consume approximately 2 GB of RAM across the cluster. Please be sure you have sufficient free memory before proceeding.
  * Install [Vagrant v1.6.5+](http://www.vagrantup.com/downloads.html) and [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
+ * Deis requires CoreOS version 471.1.0 or more recent for Ceph FS support in the kernel. The Vagrantfile and cloud provider provision scripts will provision a recent CoreOS release, but manual installs need to ensure this version.
 
 Note for Ubuntu users: the VirtualBox package in Ubuntu (as of the last known release for 14.04) has some issues when running in RAM-constrained environments. Please install the latest version of VirtualBox from Oracle's website.
 

docs/installing_deis/baremetal.rst

@@ -10,6 +10,10 @@ Deis clusters can be provisioned anywhere `CoreOS`_ can, including on your own h
 CoreOS running on raw hardware, you can boot with `PXE`_ or `iPXE`_ - this will boot a CoreOS
 machine running entirely from RAM. Then, you can `install CoreOS to disk`_.
 
+.. important::
+
+    Deis requires CoreOS version 471.1.0 or more recent for Ceph FS support in the kernel.
+
 
 Generate SSH key
 ----------------
@@ -97,9 +101,8 @@ Start the installation
     coreos-install -C alpha -c /tmp/config -d /dev/sda
 
 
-This will install the current `CoreOS`_ release to disk. If you want to install the recommended
-`CoreOS`_ version, check the `Deis changelog`_ and specify that version by appending the ``-V``
-parameter to the install command, e.g. ``-V 472.0.0``.
+This will install the latest `CoreOS`_ alpha release to disk. To specify a specific CoreOS version,
+append the ``-V`` parameter to the install command, e.g. ``-V 472.0.0``.
 
 After the installation has finished, reboot your server. Once your machine is back up, you should
 be able to log in as the `core` user using the `deis` ssh key.
@@ -163,8 +166,7 @@ disk. Add the following block to the ``write_files`` section:
 
 .. _`cluster size`: https://github.com/coreos/etcd/blob/master/Documentation/optimal-cluster-size.md
 .. _`CoreOS`: https://coreos.com/
-.. _`Deis changelog`: https://github.com/deis/deis/blob/master/CHANGELOG.md
 .. _`etcd`: https://github.com/coreos/etcd
 .. _`install CoreOS to disk`: https://coreos.com/docs/running-coreos/bare-metal/installing-to-disk/
 .. _`iPXE`: https://coreos.com/docs/running-coreos/bare-metal/booting-with-ipxe/
-.. _`PXE`: https://coreos.com/docs/running-coreos/bare-metal/booting-with-pxe/
+.. _`PXE`: https://coreos.com/docs/running-coreos/bare-metal/booting-with-pxe/

docs/installing_deis/index.rst

@@ -7,10 +7,8 @@
 Installing Deis
 ================
 
-The `controller` is the brains of a Deis platform. Provisioning a Deis
-controller is a matter of creating one or more :ref:`concepts_coreos`
-machines and installing a few necessary *systemd* units to manage
-Docker containers.
+Provisioning Deis is a matter of creating one or more :ref:`concepts_coreos`
+machines and using :ref:`install_deisctl` to install and start Deis.
 
 Anywhere you can run CoreOS, you can run Deis, including most cloud
 providers, virtual machines, and bare metal. See the