=============================================================
Install and configure for Red Hat Enterprise Linux and CentOS
=============================================================

This section describes how to install and configure the dashboard
on the controller node.

The only core service required by the dashboard is the Identity service.
You can use the dashboard in combination with other services, such as
Image service, Compute, and Networking. You can also use the dashboard
in environments with stand-alone services such as Object Storage.

.. note::

   This section assumes proper installation, configuration, and operation
   of the Identity service using the Apache HTTP server and Memcached
   service.

Install and configure components
--------------------------------

.. include:: note_configuration_vary_by_distribution.txt



1. Install the packages:

   .. code-block:: console

      # yum install openstack-dashboard

   .. end






2. Edit the
   ``/etc/openstack-dashboard/local_settings``
   file and complete the following actions:

   * Configure the dashboard to use OpenStack services on the
     ``controller`` node:

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

        OPENSTACK_HOST = "controller"

     .. end

   * Allow your hosts to access the dashboard:

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

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

     .. end

     .. note::

        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
        https://docs.djangoproject.com/en/dev/ref/settings/#allowed-hosts
        for further information.

   * Configure the ``memcached`` session storage service:

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

        SESSION_ENGINE = 'django.contrib.sessions.backends.cache'

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

     .. end

     .. note::

        Comment out any other session storage configuration.

   * Enable the Identity API version 3:

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

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

     .. end

   * Enable support for domains:

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

        OPENSTACK_KEYSTONE_MULTIDOMAIN_SUPPORT = True

     .. end

   * Configure API versions:

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

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

     .. end

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

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

        OPENSTACK_KEYSTONE_DEFAULT_DOMAIN = "Default"

     .. end

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

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

        OPENSTACK_KEYSTONE_DEFAULT_ROLE = "user"

     .. end

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

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

        OPENSTACK_NEUTRON_NETWORK = {
            ...
            'enable_router': False,
            'enable_quotas': False,
            'enable_distributed_router': False,
            'enable_ha_router': False,
            'enable_fip_topology_check': False,
        }

     .. end

   * Optionally, configure the time zone:

     .. path /etc/openstack-dashboard/local_settings
     .. code-block:: python

        TIME_ZONE = "TIME_ZONE"

     .. end

     Replace ``TIME_ZONE`` with an appropriate time zone identifier.
     For more information, see the `list of time zones
     <https://en.wikipedia.org/wiki/List_of_tz_database_time_zones>`__.

3. Add the following line to
   ``/etc/httpd/conf.d/openstack-dashboard.conf`` if not included.

   .. code-block:: none

      WSGIApplicationGroup %{GLOBAL}

Finalize installation
---------------------




* Restart the web server and session storage service:

  .. code-block:: console

     # systemctl restart httpd.service memcached.service

  .. end

  .. note::

     The ``systemctl restart`` command starts each service if
     not currently running.

