Install and configureThis section describes how to install and configure the dashboard
on the controller node.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.This section assumes proper installation, configuration, and
operation of the Identity service using the Apache HTTP server and
Memcached as described in .To install the dashboard componentsInstall the packages:#apt-get install openstack-dashboard#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.Configure user as the default role for
users that you create via the dashboard:OPENSTACK_KEYSTONE_DEFAULT_ROLE = "user"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.Reload the web server configuration:#service apache2 reloadStart 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.service#systemctl enable apache2.service memcached.service#systemctl start apache2.service memcached.service