Update Openstack Dashboard section :
# Fixes bug 813072 # Update formatting Change-Id: Iab02fe98f13e43516a441fc27fd57a2d76aa2005
This commit is contained in:
razique
annegentle
parent
d2ac9d72f2
commit
19cab8ad01
|
|
@ -9,9 +9,14 @@
|
|||
<para>OpenStack has components that provide a view of the OpenStack installation such as a Django-built website that serves as a dashboard and the ability to connect to running instances using a VNC connection via a VNC Proxy.</para>
|
||||
<section xml:id="about-the-dashboard">
|
||||
<title>About the Dashboard</title><para>You can use a dashboard interface with an OpenStack Compute installation with a web-based
|
||||
console provided by the Openstack-Dashboard project. It provides a reference implementation of a Django site that provides web-based interactions with the OpenStack Compute cloud controller. For more information about the Openstack-Dashboard project,
|
||||
please visit: <link xlink:href="http://launchpad.net/openstack-dashboard"
|
||||
>http://launchpad.net/openstack-dashboard</link>. These instructions are for a test deployment of an OpenStack Dashboard. They configure your dashboard to use the default Django server. To create a more robust, production-ready installation, you would configure this with an Apache web server. </para>
|
||||
console provided by the Openstack-Dashboard project. It provides a reference
|
||||
implementation of a Django site that provides web-based interactions with the OpenStack
|
||||
Compute cloud controller. For more information about the Openstack-Dashboard project,
|
||||
please visit: <link xlink:href="https://github.com/4P/horizon/tree/master/openstack-dashboard"
|
||||
>https://github.com/4P/horizon/</link>. These instructions are for a test deployment
|
||||
of an OpenStack Dashboard. They configure your dashboard to use the default Django
|
||||
server. To create a more robust, production-ready installation, you would configure this
|
||||
with an Apache web server. </para>
|
||||
|
||||
|
||||
<section xml:id="dashboard-system-requirements">
|
||||
|
|
@ -29,10 +34,16 @@
|
|||
should run on any system with Python 2.6 or 2.7 that is capable of running Django
|
||||
including Mac OS X (installing prerequisites may differ depending on platform). </para>
|
||||
<para>Optional components:</para>
|
||||
<para>an Image Store (Glance) endpoint </para>
|
||||
<para>an Object Store (Swift) endpoint </para>
|
||||
<para>a <link xlink:href="http://wiki.openstack.org/Quantum">Quantum</link> (networking)
|
||||
endpoint</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem><para>An Image Store (<emphasis role="italic">Glance</emphasis>) endpoint.</para></listitem>
|
||||
<listitem><para>An Object Store (<emphasis role="italic">Swift</emphasis>) endpoint.</para></listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
A <link xlink:href="http://wiki.openstack.org/Quantum">Quantum</link> (networking) endpoint.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</section>
|
||||
<section xml:id="installing-openstack-dashboard">
|
||||
|
||||
|
|
@ -57,13 +68,15 @@
|
|||
<para>Before you begin, you must have git installed. </para>
|
||||
<para>Create a source directory to house the project:</para>
|
||||
|
||||
<literallayout class="monospaced">mkdir src
|
||||
cd src </literallayout>
|
||||
<literallayout class="monospaced">
|
||||
<code>mkdir src
|
||||
cd src</code>
|
||||
</literallayout>
|
||||
|
||||
<para>Next, get the openstack-dashboard project, which provides all the look and feel for the OpenStack Dashboard.</para>
|
||||
|
||||
<literallayout class="monospaced">
|
||||
git clone https://github.com/4P/horizon
|
||||
<code>git clone https://github.com/4P/horizon</code>
|
||||
</literallayout>
|
||||
<para>You should now have a directory called openstack-dashboard, which contains the OpenStack Dashboard application.</para>
|
||||
<section xml:id="build-and-configure-openstack-dashboard">
|
||||
|
|
@ -74,9 +87,9 @@ git clone https://github.com/4P/horizon
|
|||
</para>
|
||||
<para>
|
||||
<literallayout class="monospaced">
|
||||
cd openstack-dashboard/openstack-dashboard/local
|
||||
<code>cd openstack-dashboard/openstack-dashboard/local
|
||||
cp local_settings.py.example local_settings.py
|
||||
vi local_settings.py
|
||||
vi local_settings.py</code>
|
||||
</literallayout>
|
||||
</para>
|
||||
<para>In the new copy of the local_settings.py file, change these important options:</para>
|
||||
|
|
@ -93,7 +106,7 @@ vi local_settings.py
|
|||
|
||||
The admin token can be generated by executing something like the following using the keystone-manage command on the Keystone host:</para>
|
||||
|
||||
<literallayout class="monospaced"> keystone-manage token add 999888777666 admin admin 2015-02-05T00:00</literallayout>
|
||||
<literallayout class="monospaced"><code>keystone-manage token add 999888777666 admin admin 2015-02-05T00:00</code></literallayout>
|
||||
|
||||
<para>To use this token you would add the following to local_settings.py:</para>
|
||||
|
||||
|
|
@ -121,13 +134,19 @@ QUANTUM_CLIENT_VERSION='0.1'
|
|||
<section xml:id="install-dashboard">
|
||||
<title>Install the Dashboard</title>
|
||||
<para>After Dashboard has been configured install the Dashboard virtual environment using the terminal commands below:</para>
|
||||
|
||||
<note><para>Note: the instructions below are for Ubuntu, however, setuptools can be installed on a wide variety of platforms: http://pypi.python.org/pypi/setuptools</para></note>
|
||||
|
||||
<literallayout class="monospaced">$ apt-get install -y python-setuptools
|
||||
$ sudo easy_install virtualenv
|
||||
$ python tools/install_venv.py</literallayout>
|
||||
|
||||
<note>
|
||||
<para>
|
||||
The instructions below are for Ubuntu, however, setuptools can be installed on a wide variety of platforms: <link xlink:href="http://pypi.python.org/pypi/setuptools">http://pypi.python.org/pypi/setuptools</link>
|
||||
</para>
|
||||
</note>
|
||||
<literallayout class="monospaced">
|
||||
<code>apt-get install -y python-setuptools
|
||||
sudo easy_install virtualenv
|
||||
python tools/install_venv.py</code>
|
||||
</literallayout>
|
||||
<para>On RedHat systems (eg CentOS, Fedora), you will also need to install
|
||||
python-devel
|
||||
<literallayout class="monospaced"><code>yum install python-devel</code> </literallayout></para>
|
||||
<para>Installing the virtual environment will take some time depending on download speeds. </para>
|
||||
</section>
|
||||
<section xml:id="run-the-server">
|
||||
|
|
@ -135,9 +154,9 @@ QUANTUM_CLIENT_VERSION='0.1'
|
|||
<para>Dashboard is run using the standard Django manage.py script from the context
|
||||
of the virtual environment. Be sure you synchronize the database with this
|
||||
command: </para>
|
||||
<literallayout class="monospaced">tools/with_venv.sh dashboard/manage.py syncdb</literallayout>
|
||||
<literallayout class="monospaced"><code>tools/with_venv.sh dashboard/manage.py syncdb</code></literallayout>
|
||||
<para>Run the server on a high port value so that you can validate the
|
||||
installation.</para><para><literallayout class="monospaced">tools/with_venv.sh dashboard/manage.py runserver 0.0.0.0:8000</literallayout></para><para>Make sure that your firewall isn't blocking TCP/8000 and just point your browser at this server on port 8000. If you are running the server on the same machine as your browser, this would be "http://localhost:8000". </para>
|
||||
installation.</para><para><literallayout class="monospaced"><code>tools/with_venv.sh dashboard/manage.py runserver 0.0.0.0:8000</code></literallayout></para><para>Make sure that your firewall isn't blocking TCP/8000 and just point your browser at this server on port 8000. If you are running the server on the same machine as your browser, this would be "http://localhost:8000". </para>
|
||||
<mediaobject>
|
||||
<imageobject role="fo">
|
||||
<imagedata fileref="figures/dashboard-overview.png"
|
||||
|
|
|
|||
Loading…
Reference in New Issue