12. Install Dashboard (horizon) on controller

This page is based on the following OpenStack Installation Guide pages:

http://docs.openstack.org/liberty/install-guide-rdo/horizon-install.html

http://docs.openstack.org/liberty/install-guide-rdo/horizon-verify.html

Step 3 has specific changes for the use of XenServer.

1. Install horizon packages:

   # yum install openstack-dashboard
   

2. Configure horizon. Replace *TIME_ZONE* with your own (for example “America/Chicago”):

   # vim /etc/openstack-dashboard/local_settings
   
     OPENSTACK_CONTROLLER = "controller"
     ALLOWED_HOSTS = ['*', ]
     CACHES = {
         'default': {
              'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
              'LOCATION': '127.0.0.1:11211',
         }
     }
     OPENSTACK_KEYSTONE_DEFAULT_ROLE = "user"
     OPENSTACK_NEUTRON_NETWORK = {
         'enable_router': False,
         'enable_quotas': False,
         'enable_distributed_router': False,
         'enable_ha_router': False,
         'enable_lb': False,
         'enable_firewall': False,
         'enable_vpn': False,
         'enable_fip_topology_check': False,
     }
     TIME_ZONE = "*TIME_ZONE*"
     OPENSTACK_API_VERSIONS = {
         "data-processing": 1.1,
         "identity": 3,
         "volume": 2,
     }
   

• Note 1: There are many options already present in the file. These should be left as-is.
• Note 2: For the openstack_neutron_network block, modify the settings listed above, rather than replacing the entire block.

3. There is a bug in Horizon which is breaking image metadata when editing XenServer images. This has been reported in https://bugs.launchpad.net/horizon/+bug/1539722. Until the bug is fixed, here is a quick and dirty patch to avoid the problem:

   1. Open the forms.py file:

      # vim /usr/share/openstack-dashboard/openstack_dashboard/dashboards/project/images/images/forms.py
      

   2. Locate the following lines (should be lines 60 and 61):

      else:
            container_format = 'bare'
      

   3. Add the following two lines above those lines:

      elif disk_format == 'vhd':
            container_format = 'ovf'
      

   4. The whole section should now read:

      elif disk_format == 'vhd':
            container_format = 'ovf'
      else:
            container_format = 'bare'
      

4. Enable and restart the Apahce and memcached services:

   # systemctl enable httpd.service memcached.service
   # systemctl restart httpd.service memcached.service
   

5. From a web browser, access http://*CONTROLLER_ADDRESS*/dashboard:

6. Log in using the admin credentials.
7. In the left-hand menu, under “Admin” and then “System”, click on “System Information”. This will display a list of compute services and network agents: