9876fe99af
These changes allow sharing the code of Fedora with openSUSE and also SLES. Also, tag some openSUSE changes with sles as well, more to come. Change-Id: I6b7fb9fb271e4ddbf267a09b2f10c4c968ef7092
155 lines
7.6 KiB
XML
155 lines
7.6 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;sles"><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;sles"
|
|
>/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;sles"
|
|
>/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="python" 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;sles"
|
|
>/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;sles"
|
|
>/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;sles"
|
|
>/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="python" linenumbering="unnumbered"><?db-font-size 75%?>OPENSTACK_HOST = "controller"
|
|
</programlisting>
|
|
</step>
|
|
<step os="opensuse;sles">
|
|
<para>Setup Apache configuration:
|
|
<screen><prompt>#</prompt> <userinput>cp /etc/apache2/conf.d/openstack-dashboard.conf.sample \
|
|
/etc/apache2/conf.d/openstack-dashboard.conf</userinput>
|
|
<prompt>#</prompt> <userinput>a2enmod rewrite;a2enmod ssl;a2enmod wsgi</userinput></screen>
|
|
</para>
|
|
</step>
|
|
<step os="opensuse;sles">
|
|
<para>By default, the
|
|
<systemitem>openstack-dashboard</systemitem> package enables
|
|
a database as session store. Before you continue, either
|
|
change the session store setup as described in <xref
|
|
linkend="dashboard-sessions"/> or finish the setup of the
|
|
database session store as explained in <xref
|
|
linkend="dashboard-session-database"/>.
|
|
</para>
|
|
</step>
|
|
<step os="opensuse;sles">
|
|
<para>
|
|
Start the Apache web server and memcached:
|
|
</para>
|
|
<screen><prompt>#</prompt> <userinput>service apache2 start</userinput>
|
|
<prompt>#</prompt> <userinput>service memcached start</userinput>
|
|
<prompt>#</prompt> <userinput>chckconfig apache2 on</userinput>
|
|
<prompt>#</prompt> <userinput>chckconfig memcached on</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>You can now access the dashboard at
|
|
<uri os="centos;fedora;rhel;debian;ubuntu">http://controller/horizon</uri>
|
|
<uri os="opensuse;sles">http://controller</uri>.</para>
|
|
<para>Login with credentials for any user that you created
|
|
with the OpenStack Identity Service.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|