Before you can install and configure the dashboard, meet the requirements in the section called “System requirements”.
Note | |
---|---|
When you install only Object Storage and the Identity Service, even if you install the dashboard, it does not pull up projects and is unusable. |
For more information about how to deploy the dashboard, see deployment topics in the developer documentation.
Install the dashboard on the node that can contact the Identity Service as root:
# yum install memcached python-memcached mod_wsgi openstack-dashboard
Modify the value of
CACHES['default']['LOCATION']
in/etc/openstack-dashboard/local_settings
to match the ones set in/etc/sysconfig/memcached
.Open
/etc/openstack-dashboard/local_settings
and look for this line:CACHES = { 'default': { 'BACKEND' : 'django.core.cache.backends.memcached.MemcachedCache', 'LOCATION' : '127.0.0.1:11211' } }
Notes The address and port must match the ones set in
/etc/sysconfig/memcached
.If you change the memcached settings, you must restart the Apache web server for the changes to take effect.
You can use options other than memcached option for session storage. Set the session back-end through the
SESSION_ENGINE
option.To change the timezone, use the dashboard or edit the
/etc/openstack-dashboard/local_settings
file.Change the following parameter:
TIME_ZONE = "UTC"
Update the
ALLOWED_HOSTS
inlocal_settings.py
to include the addresses you wish to access the dashboard from.Edit
/etc/openstack-dashboard/local_settings
:ALLOWED_HOSTS = ['localhost', 'my-desktop']
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
local_settings.py
.Edit
/etc/openstack-dashboard/local_settings
and changeOPENSTACK_HOST
to the hostname of your Identity Service:OPENSTACK_HOST = "controller"
Ensure that the SELinux policy of the system is configured to allow network connections to the HTTP server.
# setsebool httpd_can_network_connect on
Start the Apache web server and memcached:
# service httpd start # service memcached start # chkconfig httpd on # chkconfig memcached on
You can now access the dashboard at
http://controller/dashboard
.Login with credentials for any user that you created with the OpenStack Identity Service.