summaryrefslogtreecommitdiffstats
path: root/docs/userguide/openstack.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/userguide/openstack.rst')
-rw-r--r--docs/userguide/openstack.rst50
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.