Merge "[install-guide-rst] add horizon chapter"

doc/install-guide-rst/source/dashboard-install.rst

@@ -0,0 +1,4 @@
+Install and configure
+~~~~~~~~~~~~~~~~~~~~~
+
+.. TODO

doc/install-guide-rst/source/dashboard-verify.rst

@@ -0,0 +1,4 @@
+Verify operation
+~~~~~~~~~~~~~~~~
+
+.. TODO

doc/install-guide-rst/source/horizon.rst

@@ -1,3 +1,66 @@
 =================
 Add the dashboard
 =================
+
+The OpenStack dashboard, also known as
+`Horizon <https://git.openstack.org/cgit/openstack/horizon>`__
+is a Web interface that enables cloud administrators
+and users to manage various OpenStack resources and services.
+
+The dashboard enables web-based interactions with the
+OpenStack Compute cloud controller through the OpenStack APIs.
+
+Horizon enables you to customize the brand of the dashboard.
+
+Horizon provides a set of core classes and reusable templates and tools.
+
+This example deployment uses an Apache web server.
+
+.. include:: dashboard-install.rst
+.. include:: dashboard-verify.rst
+
+.. toctree::
+   :hidden:
+
+   dashboard-install.rst
+   dashboard-verify.rst
+
+Next steps
+~~~~~~~~~~
+Your OpenStack environment now includes the dashboard. You can
+launch an instance or add
+more services to your environment in the following chapters.
+
+After you install and configure the dashboard, you can
+complete the following tasks:
+
+.. TODO: add link to "launch an instance" after creation.
+
+* Provide users with a public IP address, a username, and a password
+  so they can access the dashboard through a web browser. In case of
+  any SSL certificate connection problems, point the server
+  IP address to a domain name, and give users access.
+
+* Customize your dashboard. See section
+  `Customize the dashboad <http://docs.openstack.org/admin-guide-cloud/
+  content/ch_install-dashboard.html#dashboard-custom-brand>`__
+  in the `OpenStack Cloud Administrator Guide
+  <http://docs.openstack.org/admin-guide-cloud/content/>`__
+  for information on setting up colors, logos, and site titles.
+
+* Set up session storage. See section
+  `Set up session storage for the dashboard
+  <http://docs.openstack.org/admin-guide-cloud/content/
+  dashboard-sessions.html#dashboard-sessions>`__
+  in the `OpenStack Cloud Administrator Guide
+  <http://docs.openstack.org/admin-guide-cloud/content>`__
+  for information on user session data.
+
+* To use the VNC client with the dashboard, the browser
+  must support HTML5 Canvas and HTML5 WebSockets.
+
+  For details about browsers that support noVNC, see
+  `README
+  <https://github.com/kanaka/noVNC/blob/master/README.md>`__
+  and `browser support
+  <https://github.com/kanaka/noVNC/wiki/Browser-support>`__.