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 `__ +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 `__ + in the `OpenStack Cloud Administrator Guide + `__ + for information on setting up colors, logos, and site titles. + +* Set up session storage. See section + `Set up session storage for the dashboard + `__ + in the `OpenStack Cloud Administrator Guide + `__ + 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 + `__ + and `browser support + `__.