416fb8b288
This patch contains fixes based on testing the install guide for ubuntu. The following chapters have been confirmed under Ubuntu 2 Basic Operating System Configuration 3 Configuring Identity Service 4 Configuring Image Service 6. Adding a dashboard Currently testing: 5 Configuring the Compute Services The following sections are verified OK: Installing the Nova Controller Services. It cannot verify the full chapter as the networking section does not exist. Change-Id: I6d1f1ae7e1ef78b56be3481c5a17ebed883cb7f1
126 lines
6.2 KiB
XML
126 lines
6.2 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE section [
|
|
<!-- Some useful entities borrowed from HTML -->
|
|
<!ENTITY ndash "–">
|
|
<!ENTITY mdash "—">
|
|
<!ENTITY hellip "…">
|
|
]>
|
|
<section xml:id="install_dashboard"
|
|
xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
|
<?dbhtml stop-chunking?>
|
|
<title>Install the dashboard</title>
|
|
<para>Before you can install and configure the dashboard, meet the
|
|
requirements in <xref linkend="dashboard-system-requirements"
|
|
/>.</para>
|
|
<note>
|
|
<para>When you install Object Storage and Identity only,
|
|
even if you install the Dashboard, it does not pull up
|
|
projects and is unusable.</para>
|
|
</note>
|
|
<para>For more information about how to deploy the dashboard, see
|
|
<link
|
|
xlink:href="http://docs.openstack.org/developer/horizon/topics/deployment.html"
|
|
>Deploying Horizon</link>.</para>
|
|
<procedure>
|
|
<step>
|
|
<para>Install the dashboard on the node that can contact
|
|
the Identity Service as root:</para>
|
|
<screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install memcached libapache2-mod-wsgi openstack-dashboard</userinput></screen>
|
|
<screen os="rhel;centos;fedora"><prompt>#</prompt> <userinput>yum install memcached python-memcached mod_wsgi openstack-dashboard</userinput></screen>
|
|
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install memcached python-python-memcached apache2-mod_wsgi openstack-dashboard</userinput></screen>
|
|
<note os="ubuntu">
|
|
|
|
<para>Remove the
|
|
<literal>openstack-dashboard-ubuntu-theme</literal>
|
|
package. This theme prevents translations, several menus
|
|
as well as the network map from rendering correctly:
|
|
<screen><prompt>#</prompt> <userinput>apt-get remove --purge openstack-dashboard-ubuntu-theme</userinput></screen>
|
|
</para>
|
|
</note>
|
|
</step>
|
|
<step>
|
|
<para>Modify the value of
|
|
<literal>CACHES['default']['LOCATION']</literal>
|
|
in <filename os="ubuntu;debian"
|
|
>/etc/openstack-dashboard/local_settings.py</filename><filename
|
|
os="centos;fedora;rhel"
|
|
>/etc/openstack-dashboard/local_settings</filename><filename
|
|
os="opensuse"
|
|
>/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
|
|
to match the ones set in <filename os="ubuntu;debian"
|
|
>/etc/memcached.conf</filename><filename
|
|
os="centos;fedora;rhel;opensuse"
|
|
>/etc/sysconfig/memcached.conf</filename>.</para>
|
|
<para>Open <filename os="ubuntu;debian"
|
|
>/etc/openstack-dashboard/local_settings.py</filename>
|
|
<filename os="centos;fedora;rhel"
|
|
>/etc/openstack-dashboard/local_settings</filename>
|
|
and look for this line:</para>
|
|
<programlisting language="bash" linenumbering="unnumbered"><?db-font-size 75%?>CACHES = {
|
|
'default': {
|
|
'BACKEND' : 'django.core.cache.backends.memcached.MemcachedCache',
|
|
'LOCATION' : '127.0.0.1:11211'
|
|
}
|
|
}</programlisting>
|
|
<note xlink:href="#installing-openstack-dashboard"
|
|
xlink:title="Notes">
|
|
<title>Notes</title>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>The address and port must match the ones
|
|
set in <filename os="ubuntu;debian"
|
|
>/etc/memcached.conf</filename><filename
|
|
os="centos;fedora;rhel;opensuse"
|
|
>/etc/sysconfig/memcached</filename>.</para>
|
|
<para>If you change the memcached settings,
|
|
you must restart the Apache web server for
|
|
the changes to take effect.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>You can use options other than memcached
|
|
option for session storage. Set the
|
|
session back-end through the
|
|
<parameter>SESSION_ENGINE</parameter>
|
|
option.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>To change the timezone, use the
|
|
dashboard or edit the <filename
|
|
os="centos;fedora;rhel"
|
|
>/etc/openstack-dashboard/local_settings</filename><filename
|
|
os="ubuntu;debian"
|
|
>/etc/openstack-dashboard/local_settings.py</filename><filename
|
|
os="opensuse"
|
|
>/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
|
|
file.</para>
|
|
<para>Change the following parameter:
|
|
<code>TIME_ZONE = "UTC"</code>
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</note>
|
|
</step>
|
|
<step>
|
|
<para>This guide assumes that you are running the Dashboard on the controller node.
|
|
You can easily run the dashboard on a separate server, by changing the appropriate settings in
|
|
<filename>local_settings.py</filename></para>
|
|
<para>Edit <filename
|
|
os="centos;fedora;rhel"
|
|
>/etc/openstack-dashboard/local_settings</filename><filename
|
|
os="ubuntu;debian"
|
|
>/etc/openstack-dashboard/local_settings.py</filename><filename
|
|
os="opensuse"
|
|
>/usr/share/openstack-dashboard/openstack_dashboard/local/local_settings.py</filename>
|
|
and change <literal>OPENSTACK_HOST</literal> to the hostname of your Identity Service.</para>
|
|
<programlisting language="bash" linenumbering="unnumbered"><?db-font-size 75%?>OPENSTACK_HOST = "controller"
|
|
</programlisting>
|
|
</step>
|
|
<step>
|
|
<para>You can now access the dashboard at <uri>http://controller/horizon</uri>.</para>
|
|
<para>Login with credentials for any user that you created with the OpenStack Identity Service.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|