[ English | 中文 (简体, 中国) | नेपाली | 한국어 (대한민국) | Esperanto | français | русский | português (Brasil) | English (United Kingdom) | español | Deutsch | Indonesia ]

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.

Примечание

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

Install and configure components

Примечание

Default configuration files vary by distribution. You might need to add these sections and options rather than modifying existing sections and options. Also, an ellipsis (...) in the configuration snippets indicates potential default configuration options that you should retain.

  1. Install the packages:

    # dnf install openstack-dashboard

  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:

      OPENSTACK_HOST = "controller"

    • Allow your hosts to access the dashboard:

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

      Примечание

      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:

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

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

      Примечание

      Comment out any other session storage configuration.

    • Enable the Identity API version 3:

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

      Примечание

      In case your keystone run at 5000 port then you would mentioned keystone port here as well i.e. OPENSTACK_KEYSTONE_URL = «http://%s:5000/identity/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"

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

      OPENSTACK_NEUTRON_NETWORK = {
    ...
    'enable_router': False,
    'enable_quotas': False,
    'enable_distributed_router': False,
    'enable_ha_router': 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.

    • Optionally, configure location where the access to the dashboard (if not included):

      WEBROOT = '/dashboard/'

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

    WSGIApplicationGroup %{GLOBAL}

Finalize installation

  • Restart the web server and session storage service:

    # systemctl restart httpd.service memcached.service

    Примечание

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