Doug Hellmann c7bfdbb44f split install guide into separate files by OS

Provide a script for interpreting the "only" directives and splitting
the existing content up into standalone files for each OS to make it
easier for project teams to copy the parts they need into their own
project documentation trees without requiring separate platform builds.

The files have been hand-edited to pass the niceness check and to allow
the install guide to build.

The script for building the guide has been changed to not build separate
copies per OS.

Change-Id: Ib88f373190e2a4fbf14186418852d971b33dca85
Signed-off-by: Doug Hellmann <doug@doughellmann.com>

2017-06-19 11:29:52 -04:00

5.1 KiB

Raw Blame History

Install and configure

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 as described in the Install and configure the Identity service <keystone-install> section.

Install and configure components

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

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 your hosts to access the dashboard:
```
ALLOWED_HOSTS = ['one.example.com', 'two.example.com']
```
  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 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": 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

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.

5.1 KiB Raw Blame History

Install and configure

Install and configure components

Finalize installation

5.1 KiB

Raw Blame History