Install and configure for Ubuntu¶

Install and configure components¶

1. Install the packages:

   # apt install openstack-dashboard
   

2. 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": 3,
     }
     

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

3. Add the following line to /etc/apache2/conf-available/openstack-dashboard.conf if not included.

   WSGIApplicationGroup %{GLOBAL}
   

Finalize installation¶

• Reload the web server configuration:

  # service apache2 reload