[DOCS] Refactor of nova role docs

Update the role documentation to match the newly proposed format.  In
the new format, each role project should maintain the configuration
variations for the role project itself.

Change-Id: I165891189ffa67680980a70178fd55951cad293b

README.rst

@@ -1,31 +1,19 @@
-OpenStack-Ansible Nova
-######################
+======================
+OpenStack-Ansible nova
+======================
 
-Ansible role that installs and configures OpenStack Nova and all of its
+Ansible role that installs and configures OpenStack nova and all of its
 corresponding services.
 
-Default Variables
-=================
+This role will install the following:
+    * nova-api
+    * nova-conductor
+    * nova-scheduler
+    * nova-console
+    * nova-cert
+    * nova-compute
 
-.. literalinclude:: ../../defaults/main.yml
-   :language: yaml
-   :start-after: under the License.
+Documentation for the project can be found at:
+`<http://docs.openstack.org/developer/openstack-ansible-os_keystone/>`_
 
-
-Required Variables
-==================
-
-.. code-block:: yaml
-    # comma separated list of Glance internalUrls
-    glance_api_servers: "http://glance_host:9292"
-
-
-Example Playbook
-================
-
-.. code-block:: yaml
-    - name: Playbook for deploying nova
-      hosts: nova_all
-      user: root
-      roles:
-        - { role: "os_nova" }
+The project home is at: `<http://launchpad.net/openstack-ansible>`_

doc/source/app-powervm.rst

@@ -0,0 +1,36 @@
+`Home <index.html>`_ OpenStack-Ansible Neutron
+
+=====================================
+Scenario - Using PowerVM Nova plugin
+=====================================
+
+Prerequisites
+~~~~~~~~~~~~~
+
+In order to use the PowerVM OpenStack drivers with OpenStack-Ansible (OSA), the
+following pre-requisites must be fulfilled:
+
+ - At least one of the repo-build servers must be ppc64le. Can mix and match
+   repo-build servers between x86 and ppc64le.
+
+ - The compute nodes should be pre-configured for PowerVM with the NovaLink_
+   feature.
+
+ - The NovaLink Management VM needs at least one direct attach I/O card.
+   OpenStack Ansible is currently able to deploy the PowerVM drivers when
+   paired with the Linux Bridge or Open vSwitch agent. The traditional PowerVM
+   Shared Ethernet Adapter networking agent is not yet supported.
+
+ - The network topology on the NovaLink must match a supported OpenStack
+   Ansible network configuration.
+
+.. _NovaLink: http://www.ibm.com/support/knowledgecenter/POWER8/p8eig/p8eig_kickoff.htm?cp=POWER8
+
+
+PowerVM configuration
+~~~~~~~~~~~~~~~~~~~~~
+
+The Compute driver for OpenStack-Ansible should automatically detect that it
+is of type PowerVM. If the user has specified a specific compute type, that
+is applicable to the whole cloud. It is advised that the deployer allows
+OSA to detect the appropriate compute node type.

doc/source/index.rst

@@ -1 +1,38 @@
-.. include:: ../../README.rst
+===============================
+Nova role for OpenStack-Ansible
+===============================
+
+.. toctree::
+   :maxdepth: 2
+
+   overview.rst
+   app-powervm.rst
+
+:tags: openstack, nova, cloud, ansible
+:category: \*nix
+
+This role will install the following Upstart services:
+    * nova-server
+    * nova-compute
+
+Default Variables
+^^^^^^^^^^^^^^^^^
+
+.. literalinclude:: ../../defaults/main.yml
+   :language: yaml
+   :start-after: under the License.
+
+Example playbook
+~~~~~~~~~~~~~~~~
+
+.. literalinclude:: ../../examples/playbook.yml
+   :language: yaml
+
+Tags
+~~~~
+
+This role supports two tags: ``nova-install`` and ``nova-config``
+
+The ``nova-install`` tag can be used to install and upgrade.
+
+The ``nova-config`` tag can be used to manage configuration.

doc/source/overview.rst

@@ -0,0 +1,40 @@
+CPU Platform Compatibility
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This role supports multiple CPU architecture types.  At least one repo_build
+node must exist for each CPU type that is in use in the deployment.
+
+Currently supported CPU architectures:
+ - x86_64 / amd64
+ - ppc64le
+
+
+Compute Driver Compatibility
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This role supports multiple nova compute driver types.  The following
+compute drivers are supported:
+ - libvirt (default)
+ - ironic
+ - lxd (via nova-lxd)
+ - powervm (via nova-powervm)
+
+The driver type will automatically be detected by the OpenStack Ansible Nova
+role for the following compute driver types:
+ - libvirt
+ - ironic
+ - powervm
+
+Any mix and match of compute node types can be used for those platforms.
+
+If using the lxd driver, the compute type must be specified using the
+``nova_virt_type`` variable in the ``/etc/openstack_deploy/user_variables.yml``
+file.
+
+.. code-block:: shell-session
+
+   nova_virt_type: lxd
+
+It should be noted that if the ``nova_virt_type`` variable is set, then all
+nodes in the deployment will be set to that hypervisor type.  It is recommended
+to allow the automatic hypervisor detection.

examples/playbook.yml

@@ -0,0 +1,9 @@
+.. code-block:: yaml
+
+    - name: Installation and setup of Neutron
+      hosts: neutron_all
+      user: root
+      roles:
+        - { role: "os_neutron", tags: [ "os-neutron" ] }
+      vars:
+        neutron_galera_address: "{{ internal_lb_vip_address }}"