From 60be2f94145c28e9e5aa5770d992b372d978b32d Mon Sep 17 00:00:00 2001
From: KATO Tomoyuki <kato.tomoyuki@jp.fujitsu.com>
Date: Wed, 1 Jul 2015 00:10:22 +0900
Subject: [PATCH] [install-guide-rst] add horizon chapter

just a conversion to rst files.
ch_horizon.xml

Change-Id: Icb572a84be680a450efddbf1e5ebd7d5f3b89aba
Implements: blueprint installguide-liberty
---
 .../source/dashboard-install.rst              |  4 ++
 .../source/dashboard-verify.rst               |  4 ++
 doc/install-guide-rst/source/horizon.rst      | 63 +++++++++++++++++++
 3 files changed, 71 insertions(+)
 create mode 100644 doc/install-guide-rst/source/dashboard-install.rst
 create mode 100644 doc/install-guide-rst/source/dashboard-verify.rst

diff --git a/doc/install-guide-rst/source/dashboard-install.rst b/doc/install-guide-rst/source/dashboard-install.rst
new file mode 100644
index 0000000000..f381b9e056
--- /dev/null
+++ b/doc/install-guide-rst/source/dashboard-install.rst
@@ -0,0 +1,4 @@
+Install and configure
+~~~~~~~~~~~~~~~~~~~~~
+
+.. TODO
diff --git a/doc/install-guide-rst/source/dashboard-verify.rst b/doc/install-guide-rst/source/dashboard-verify.rst
new file mode 100644
index 0000000000..486fe83257
--- /dev/null
+++ b/doc/install-guide-rst/source/dashboard-verify.rst
@@ -0,0 +1,4 @@
+Verify operation
+~~~~~~~~~~~~~~~~
+
+.. TODO
diff --git a/doc/install-guide-rst/source/horizon.rst b/doc/install-guide-rst/source/horizon.rst
index 1ff7548be4..6f04974c15 100644
--- a/doc/install-guide-rst/source/horizon.rst
+++ b/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>`__.