Adding general component descriptions and information.

Change-Id: Ie9824ac9c706f730c929a5ca0ed34ee85314719e
Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
(cherry picked from commit 58a2bb9407285dbf2bac8e32bd55582379c49a6a)

1 files changed, 42 insertions, 8 deletions

diff --git a/docs/userguide/openstack.rst b/docs/userguide/openstack.rst
index 09b482e7c..00267321c 100644
--- a/docs/userguide/openstack.rst
+++ b/docs/userguide/openstack.rst
@@ -2,14 +2,48 @@
 .. http://creativecommons.org/licenses/by/4.0
 .. (c) Christopher Price (Ericsson AB)
 
-OpenStack User Guide
-====================
+Brahmaputra OpenStack User Guide
+================================
 
-Add openstack specific user guide information here.
-Needs to include OPNFV default ports and addresses and
-references to upstream documentation applicable for an
-OPNFV deployment.
+OpenStack is a cloud operating system developed and released by the
+`OpenStack project <https://www.openstack.org>`_.  OpenStack is used in OPNFV for
+controlling pools of compute, storage, and networking resources in a Pharos
+compliant infrastructure.
 
-From the Jumphost VIP:80
-admin/admin
+OpenStack is used in Brahmaputra to manage tenants (known in OpenStack as projects),
+users, services, images, flavours, and quotas across the Pharos infrastructure.
+The OpenStack interface provides the primary interface for an operational Brahmaputra
+deployment and it is from the "horizon console" that an OPNFV user will perform the
+majority of administrative and operational activities on the deployment.
 
+OpenStack references
+--------------------
+
+The `OpenStack user guide <http://docs.openstack.org/user-guide>`_ provides details
+and descriptions of how to configure and interact with the OpenStack deployment.  This
+guide can be used by lab engineers and operators to tune the OpenStack deployment to
+your liking.
+
+Once you have configured OpenStack to your purposes, or the Brahmaputra deployment meets
+your needs as deployed, an operator, or administrator, will find the best guidance for
+working with OpenStack in the
+`OpenStack administration guide <http://docs.openstack.org/user-guide-admin>`_.
+
+Connecting to the OpenStack instance
+------------------------------------
+
+Once familiar with the basic of working with OpenStack you will want to connect to the
+OpenStack instance via the Horizon Console.  The Horizon console provide a Web based GUI
+that will allow you operate the deployment.
+To do this you should open a browser on the JumpHost to the following address
+and enter the username and password:
+
+
+  http://{Controller-VIP}:80/index.html>
+  username: admin
+  password: admin
+
+Other methods of interacting with and configuring OpenStack,, like the REST API
+and CLI are also available in the Brahmaputra deployment, see the
+`OpenStack administration guide <http://docs.openstack.org/user-guide-admin>`_
+for more information on using those interfaces.