64b6c9261e
Current folder name New folder name Book title ---------------------------------------------------------- basic-install DELETE cli-guide DELETE common common NEW admin-guide-cloud Cloud Administrators Guide docbkx-example DELETE openstack-block-storage-admin DELETE openstack-compute-admin DELETE openstack-config config-reference OpenStack Configuration Reference openstack-ha high-availability-guide OpenStack High Availabilty Guide openstack-image image-guide OpenStack Virtual Machine Image Guide openstack-install install-guide OpenStack Installation Guide openstack-network-connectivity-admin admin-guide-network OpenStack Networking Administration Guide openstack-object-storage-admin DELETE openstack-security security-guide OpenStack Security Guide openstack-training training-guide OpenStack Training Guide openstack-user user-guide OpenStack End User Guide openstack-user-admin user-guide-admin OpenStack Admin User Guide glossary NEW OpenStack Glossary bug: #1220407 Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7 author: diane fleming
75 lines
3.4 KiB
XML
75 lines
3.4 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section 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"
|
|
xml:id="basic-install_controller-dashboard">
|
|
<title>OpenStack Dashboard</title>
|
|
<para>The OpenStack Dashboard service provides users of the cloud environment with a web-accessible GUI as an alternative
|
|
to using the command-line tools.</para>
|
|
<para>To enable it, install the OpenStack Dashboard package and its
|
|
dependencies: <screen os="ubuntu;debian"><prompt>#</prompt> <userinput>apt-get install openstack-dashboard memcached python-memcache</userinput></screen><screen os="centos;rhel;fedora"><prompt>#</prompt> <userinput>yum install httpd memcached
|
|
( cat | sudo tee -a /etc/openstack-dashboard/local_settings ) <<EOF
|
|
DATABASES = {
|
|
'default': {
|
|
'ENGINE': 'django.db.backends.mysql',
|
|
'NAME': 'horizon',
|
|
'USER': 'horizon',
|
|
'PASSWORD': 'password',
|
|
'HOST': '$MY_IP',
|
|
'PORT': '',
|
|
}
|
|
}
|
|
EOF</userinput></screen>
|
|
<screen os="opensuse"><prompt>#</prompt> <userinput>zypper install openstack-dashboard memcached python-python-memcached
|
|
|
|
( cat | sudo tee -a /usr/share/openstack-dashboard/openstack_dashboard/\
|
|
local/local_settings.py ) <<EOF
|
|
DATABASES = {
|
|
'default': {
|
|
'ENGINE': 'django.db.backends.mysql',
|
|
'NAME': 'horizon',
|
|
'USER': 'horizon',
|
|
'PASSWORD': 'password',
|
|
'HOST': '$MY_IP',
|
|
'PORT': '',
|
|
}
|
|
}
|
|
EOF</userinput></screen>
|
|
<note os="opensuse">
|
|
<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>
|
|
<para>Start the service:
|
|
<screen os="opensuse"><prompt>#</prompt> <userinput>systemctl restart apache2.service</userinput>
|
|
<prompt>#</prompt> <userinput>systemctl enable apache2.service</userinput></screen>
|
|
</para>
|
|
</note>
|
|
<note os="ubuntu">
|
|
|
|
<para>If you are running Ubuntu, it is optional, but
|
|
recommended to remove the
|
|
<literal>openstack-dashboard-ubuntu-theme</literal>
|
|
package. This theme prevents 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>OpenStack Dashboard is now available at
|
|
<uri>http://10.10.10.10/horizon</uri>. We can login
|
|
with the <emphasis role="bold">admin</emphasis> / <emphasis
|
|
role="bold">password</emphasis> credentials or <emphasis
|
|
role="bold">demo</emphasis> / <emphasis role="bold"
|
|
>password</emphasis>. <note>
|
|
<para>Check the
|
|
<filename os="ubuntu;debian">/var/log/apache2/error.log</filename>
|
|
<filename os="centos;rhel;fedora">/var/log/httpd/error_log</filename>
|
|
<filename os="opensuse">/var/log/apache2/error.log</filename>
|
|
file for errors that wold prevent either the Apache service
|
|
or the Dashboard service from successfully
|
|
starting.</para>
|
|
</note>
|
|
</para>
|
|
|
|
</section>
|