Install and configureThis section describes how to install and configure the dashboard
on the controller node.Before you proceed, verify that your system meets the requirements
in . Also, the dashboard
relies on functional core services including Identity, Image Service,
Compute, and either Networking (neutron) or legacy networking
(nova-network). Environments with stand-alone services such as Object
Storage cannot use the dashboard. For more information, see the
developer documentation.To install the dashboard componentsInstall the packages:#apt-get install openstack-dashboard apache2 libapache2-mod-wsgi memcached python-memcache#yum install openstack-dashboard httpd mod_wsgi memcached python-memcached#zypper install openstack-dashboard apache2-mod_wsgi memcached python-python-memcached \
openstack-dashboard-testUbuntu installs the
openstack-dashboard-ubuntu-theme package
as a dependency. Some users reported issues with this theme in
previous releases. If you encounter issues, remove this package
to restore the original OpenStack theme.To install the dashboard componentsInstall the packages:#apt-get install openstack-dashboard-apacheRespond to prompts for web server configuration.The automatic configuration process generates a self-signed
SSL certificate. Consider obtaining an official certificate for
production environments.To configure the dashboardConfigure the web server:#cp /etc/apache2/conf.d/openstack-dashboard.conf.sample \
/etc/apache2/conf.d/openstack-dashboard.conf#a2enmod rewrite;a2enmod ssl;a2enmod wsgiEdit the
/etc/openstack-dashboard/local_settings.py
file and complete the following actions:Edit the
/etc/openstack-dashboard/local_settings
file and complete the following actions:Edit the
/srv/www/openstack-dashboard/openstack_dashboard/local/local_settings.py
file and complete the following actions:Configure the dashboard to use OpenStack services on the
controller node:OPENSTACK_HOST = "controller"Allow all hosts to access the dashboard:ALLOWED_HOSTS = ['*']Configure the memcached session
storage service:CACHES = {
'default': {
'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
'LOCATION': '127.0.0.1:11211',
}
}Comment out any other session storage configuration.By default, SLES and openSUSE use a SQL database for session
storage. For simplicity, we recommend changing the configuration
to use memcached for session
storage.Optionally, configure the time zone:TIME_ZONE = "TIME_ZONE"Replace TIME_ZONE with an
appropriate time zone identifier. For more information, see the
list of time zones.To finalize installationOn RHEL and CentOS, configure SELinux to permit the web server
to connect to OpenStack services:#setsebool -P httpd_can_network_connect onDue to a packaging bug, the dashboard CSS fails to load properly.
Run the following command to resolve this issue:#chown -R apache:apache /usr/share/openstack-dashboard/staticFor more information, see the
bug report.Restart the web server and session storage service:#service apache2 restart#service memcached restartStart the web server and session storage service and configure
them to start when the system boots:#systemctl enable httpd.service memcached.service#systemctl start httpd.service memcached.serviceOn SLES:#service apache2 start#service memcached start#chkconfig apache2 on#chkconfig memcached onOn openSUSE:#systemctl enable apache2.service memcached.service#systemctl start apache2.service memcached.service