Install and configure for Debian¶

Install and configure components¶

1. Install the packages:

   # apt install openstack-dashboard-apache
   

2. Respond to prompts for web server configuration.

   Note

   The automatic configuration process generates a self-signed SSL certificate. Consider obtaining an official certificate for production environments.

   Note

   There are two modes of installation. One using /horizon as the URL, keeping your default vhost and only adding an Alias directive: this is the default. The other mode will remove the default Apache vhost and install the dashboard on the webroot. It was the only available option before the Liberty release. If you prefer to set the Apache configuration manually, install the openstack-dashboard package instead of openstack-dashboard-apache.

3. Edit the /etc/openstack-dashboard/local_settings.py file and complete the following actions:

   • Configure the dashboard to use OpenStack services on the controller node:

     OPENSTACK_HOST = "controller"
     

   • In the Dashboard configuration section, allow your hosts to access Dashboard:

     ALLOWED_HOSTS = ['one.example.com', 'two.example.com']
     

     Note

     • Do not edit the ALLOWED_HOSTS parameter under the Ubuntu configuration section.
     • ALLOWED_HOSTS can also be ['*'] to accept all hosts. This may be useful for development work, but is potentially insecure and should not be used in production. See the Django documentation for further information.

   • Configure the memcached session storage service:

     SESSION_ENGINE = 'django.contrib.sessions.backends.cache'
     
     CACHES = {
         'default': {
              'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
              'LOCATION': 'controller:11211',
         }
     }
     

     Note

     Comment out any other session storage configuration.

   • Enable the Identity API version 3:

     OPENSTACK_KEYSTONE_URL = "http://%s:5000/v3" % OPENSTACK_HOST
     

   • Enable support for domains:

     OPENSTACK_KEYSTONE_MULTIDOMAIN_SUPPORT = True
     

   • Configure API versions:

     OPENSTACK_API_VERSIONS = {
         "identity": 3,
         "image": 2,
         "volume": 2,
     }
     

   • Configure Default as the default domain for users that you create via the dashboard:

     OPENSTACK_KEYSTONE_DEFAULT_DOMAIN = "Default"
     

   • Configure user as the default role for users that you create via the dashboard:

     OPENSTACK_KEYSTONE_DEFAULT_ROLE = "user"
     

   • If you chose networking option 1, disable support for layer-3 networking services:

     OPENSTACK_NEUTRON_NETWORK = {
         ...
         'enable_router': False,
         'enable_quotas': False,
         'enable_ipv6': False,
         'enable_distributed_router': False,
         'enable_ha_router': False,
         'enable_lb': False,
         'enable_firewall': False,
         'enable_vpn': False,
         'enable_fip_topology_check': False,
     }
     

   • 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.

Finalize installation¶

• Reload the web server configuration:

  # service apache2 reload