Installation Guide - Changes for Kilo
https://blueprints.launchpad.net/openstack-manuals/+spec/installguide-kilo
Implement mandatory changes and optional enhancements to the Installation
Guide for Kilo.
Problem description
The installation guide requires certain changes to make it work for the
Kilo release of OpenStack.
Proposed change
- Implement mandatory changes and potentially one or more optional
enhancements.
Implementation
Assignee(s)
- Primary assignee:
- Matt Kassawara (ionosphere80)
- Other contributors:
- Anyone with installation experience
Work Items
- Mandatory changes
- Overall
- As necessary, make changes to successfully install OpenStack on
Ubuntu 14.04, RHEL 7, CentOS 7, Fedora 21, SLES 12, and openSUSE
13.2 using native methods.
- For RabbitMQ, create and use “openstack” account instead of the
guest account.
- As necessary, note that stock configuration files might require
adding configuration stanzas/options rather than editing them.
- As necessary, change any defaults in stock configuration files
that generate deprecation warnings.
- As necessary, replace “tenant” with “project” to align with
Identity v3 API terminology.
- As necessary, replace “message broker” with “message queue” to
improve wording.
- Identity
- Enable version 3 API.
- Replace deprecated eventlet (default web server) with Apache using
configuration in upstream keystone repository.
- Replace SQL token storage driver with Memcached to improve
performance.
- Replace deprecated python-keystoneclient commands with
python-openstackclient commands.
- Image Service
- Block Storage
- Replace deprecated v1 API with v2 API.
- Optional changes
- Overall
- Where available, use the /etc/mysql/conf.d directory for additional
database configuration.
- Install upstream RabbitMQ package if distribution includes an old
version.
- Replace python-serviceclient commands with generic
python-openstackclient commands.
- Networking
- Standardize location for Open vSwitch agent configuration.
- Add content for Linux Bridge agent.
- Object Storage
- Add content for standalone (keystone + swift) deployment.
Note: To simplify patches and shrink the review cycle, patches can
address one distribution rather than all distributions. Use separate
patches to address the same content for additional distributions.
Reviewers should take this into account so that one distribution
can complete patches, tests, and publication independent of other
distributions.
Dependencies
- Kilo milestone or RC packages for each distribution supported by the
installation guide.
Testing
- All distributions supported by the installation guide must complete
testing of at least core services (Identity, Image Service, Compute,
and Networking) and successfully launch an instance using both legacy
networking (nova-network) and Networking (neutron). Distributions that
do not meet these criteria risk temporary removal from publication.
References
- Discussion can occur using any official medium including IRC in
#openstack-doc, the openstack-docs mailing list with [install-guide]
in the subject, weekly installation guide specialty team meeting,
weekly documentation team meeting, and potentially etherpads.