Install the dashboard

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:
```
# zypper install memcached python-python-memcached apache2-mod_wsgi openstack-dashboard
```

Modify the value of CACHES['default']['LOCATION'] in /srv/www/openstack-dashboard/openstack_dashboard/local/local_settings.py to match the ones set in /etc/sysconfig/memcached.

Open and look for this line:

CACHES = {
'default': {
'BACKEND' : 'django.core.cache.backends.memcached.MemcachedCache',
'LOCATION' : '127.0.0.1:11211'
}
}

Notes

	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 `/srv/www/openstack-dashboard/openstack_dashboard/local/local_settings.py` file. Change the following parameter: `TIME_ZONE = "UTC"`

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 /srv/www/openstack-dashboard/openstack_dashboard/local/local_settings.py file.
Change the following parameter: TIME_ZONE = "UTC"

Update the ALLOWED_HOSTS in local_settings.py to include the addresses you wish to access the dashboard from.
Edit /srv/www/openstack-dashboard/openstack_dashboard/local/local_settings.py:
```
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 /srv/www/openstack-dashboard/openstack_dashboard/local/local_settings.py and change OPENSTACK_HOST to the hostname of your Identity Service:
```
OPENSTACK_HOST = "controller"
    
```

Setup Apache configuration:

# cp /etc/apache2/conf.d/openstack-dashboard.conf.sample \
   /etc/apache2/conf.d/openstack-dashboard.conf
# a2enmod rewrite;a2enmod ssl;a2enmod wsgi

By default, the openstack-dashboard package enables a database as session store. Before you continue, either change the session store set up as described in the section called “Set up session storage for the dashboard” or finish the setup of the database session store as explained in the section called “Initialize and configure the database”.

Start the Apache web server and memcached:

# service apache2 start
# service memcached start
# chkconfig apache2 on
# chkconfig memcached on

You can now access the dashboard at http://controller.
Login with credentials for any user that you created with the OpenStack Identity Service.

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page

Legal notices