Add documentation for Savanna

* Reference Architecture page has a short description of what Savanna is +
   current limitations
 * Post-Deployment Check has new section 'Platform Tests Description' which
   currently lists prerequsites for Savanna tests run

pages/install-guide/0050-supported-software.rst

@@ -38,6 +38,10 @@ components:
   
   * QEMU
 
+* Savanna
+
+  * 0.2.2
+
 * Open vSwitch
 
   * 1.10.0

pages/reference-architecture/0090-savanna.rst

@@ -0,0 +1,34 @@
+.. index:: Savanna Deployment
+
+.. _savanna-deployment-label:
+
+Savanna Deployment
+------------------
+
+Savanna is a service for launching Hadoop clusters on OpenStack. It is
+designed to be vendor-agnostic and currently supports two distributions:
+Vanilla Apache Hadoop and Hortonworks Data Platform. For Savanna usage
+guidelines consider reading User Guide section of the Savanna docs located
+here: http://savanna.readthedocs.org/en/0.2.2
+
+**Notes and Limitations**
+
+Currently Savanna does not configure security groups, and at the same
+time it requires access to the VMs. That means that the default
+security group must have 22 port open for Savanna to work properly.
+HDP plugin also requires 8080 port to be open. Also you might have
+to open some ports for your use, like 50030 and 50070 to access
+JobTracker and NameNode web interface, or 80 to access Ambari console
+if HDP plugin is used. Also any inter-VM communication must not be
+blocked. That is a requirement only for tenants where
+Savanna will be used.
+
+Note that Fuel configures Savanna to use floating IPs to access and
+configure VMs. If your installation does not have floating IP auto
+assignment enabled (for nova-network) or Neutron is used, then on
+each Hadoop cluster launch you will need to specify network from
+which Savanna should assign floating IPs to the cluster nodes.
+
+Hadoop requires at least 1G of memory to run. That means you must
+use flavors having not less than 1G of memory for Hadoop cluster
+nodes.

pages/user-guide/post-install-healthchecks.rst

@@ -429,3 +429,36 @@ negatives. The following is a description of each sanity test available:
   the dashboard - it may be unreachable for some reason and then you should 
   check your network configuration. For more information refer to nova cli 
   reference.
+
+Platform Tests Description
+--------------------------
+
+Platform tests verify basic functionality of Heat, Savanna and Murano services.
+It is required to perform a number of manual actions before Savanna tests
+could be run.
+
+Savanna Platform Tests Prerequisites
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The platform tests are run in the 'admin' tenant, so that is the
+tenant where changes are need to be performed.
+
+1. Configure security groups in the 'admin' tenant. See
+   :ref:`savanna-deployment-label` for the details.
+2. Get an image with Hadoop for Savanna and register it with Savanna.
+
+   * First download the following image:
+     http://savanna-files.mirantis.com/savanna-0.2-vanilla-1.1.2-ubuntu-12.10.qcow2
+   * Then upload the image into OpenStack Image Service (Glance) into
+     'admin' tenant and name it 'savanna'.
+   * In OpenStack Dashboard (Horizon) access 'Savanna' tab.
+   * Switch to 'admin' tenant if you are not in it already.
+   * Go to the ‘Image Registry’ menu. Here push ‘Register Image’ button.
+     Image registration window will open up.
+   * Select the image you’ve just uploaded.
+   * Set username to ‘ubuntu’
+   * For tags, pick ‘vanilla’ plugin and ‘1.2.1’ version and press
+     ‘Add all’ button.
+   * Finally push ‘Done’ button
+
+After the steps above are done, the Savanna is ready to be tested.

reference-architecture.rst

@@ -21,3 +21,4 @@ Reference Architectures
 .. include:: /pages/reference-architecture/0050-technical-considerations-overview.rst
 .. include:: /pages/reference-architecture/0060-quantum-vs-nova-network.rst
 .. include:: /pages/reference-architecture/0080-swift-notes.rst
+.. include:: /pages/reference-architecture/0090-savanna.rst