Matthew Kassawara 05346e4bef [install] Horizon updates for Mitaka

Update horizon configuration for Mitaka.

1) Change memcached endpoint from '127.0.0.1' to
   'controller' because memcached listens on the
   controller management interface.

Change-Id: I29908dbe0782873860ecbb9297006c54bcc3845a
Implements: bp installguide-mitaka

2016-03-24 16:43:42 -06:00

11 KiB

Raw Blame History

Install and configure

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

The dashboard relies on functional core services including Identity, Image service, Compute, and either Networking (neutron) or legacy networking (nova-network). Environments with stand-alone services such as Object Storage cannot use the dashboard. For more information, see the developer documentation <http://docs.openstack.org/developer/ horizon/topics/deployment.html>__.

Note

This section assumes proper installation, configuration, and operation of the Identity service using the Apache HTTP server and Memcached service as described in the Install and configure the Identity service <keystone-install> section.

Install and configure components

obs or rdo or ubuntu

obs

Install the packages:
```
# zypper install openstack-dashboard
```

rdo

Install the packages:
```
# yum install openstack-dashboard
```

ubuntu

Install the packages:
```
# apt-get install openstack-dashboard
```

debian

Install the packages:

# apt-get install openstack-dashboard-apache

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.

obs

Configure the web server:

# cp /etc/apache2/conf.d/openstack-dashboard.conf.sample \
  /etc/apache2/conf.d/openstack-dashboard.conf
# a2enmod rewrite

Edit the /srv/www/openstack-dashboard/openstack_dashboard/local/local_settings.py file and complete the following actions:

Configure the dashboard to use OpenStack services on the controller node:
```
OPENSTACK_HOST = "controller"
```
Allow all hosts to access the dashboard:
```
ALLOWED_HOSTS = ['*', ]
```

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

rdo

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 all hosts to access the dashboard:
```
ALLOWED_HOSTS = ['*', ]
```

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

ubuntu

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"
```
Allow all hosts to access the dashboard:
```
ALLOWED_HOSTS = ['*', ]
```

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_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

ubuntu or debian

Reload the web server configuration:
```
# service apache2 reload
```

obs

Restart the web server and session storage service:
```
# systemctl restart apache2.service memcached.service
```
Note

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

rdo

Restart the web server and session storage service:
```
# systemctl restart httpd.service memcached.service
```
Note

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

11 KiB Raw Blame History

Install and configure

Install and configure components

Finalize installation

11 KiB

Raw Blame History