Install: Environment updates for Mitaka

Update environment configuration for Mitaka.

1) Change SQL database configuration file name to
   something less clunky.
2) Improve consistency of SQL database configuration
   among distributions.
3) Change RDO to use the PyMySQL library.
4) Add pre-release package repositories for testing
   purposes. Remove after release of Mitaka packages.
5) Move Memcached content from keystone because all
   services use it, but in a different way than in
   Liberty.

Implements: bp installguide-mitaka
Change-Id: Ie904f9b4f745ac287d9aef12e3348e1582766229
This commit is contained in:
Matthew Kassawara 2016-02-12 09:46:04 -07:00
parent 03fb8fbfa3
commit 6c185febf6
4 changed files with 110 additions and 33 deletions

View File

@ -0,0 +1,64 @@
Memcached
~~~~~~~~~
The Identity service authentication mechanism for services uses Memcached
to cache tokens. For production deployments, we recommend enabling a
combination of firewalling, authentication, and encryption to secure it.
Install and configure components
--------------------------------
#. Install the packages:
.. only:: ubuntu
.. code-block:: console
# apt-get install memcached python-memcache
.. only:: rdo
.. code-block:: console
# yum install memcached python-memcached
.. only:: obs
.. code-block:: console
# zypper install memcached python-python-memcached
.. only:: ubuntu
2. Edit the ``/etc/memcache/memcached.conf`` file and configure the
service to use the management IP address of the controller node
to enable access by other nodes via the management network:
.. code-block:: ini
-l 10.0.0.11
.. note::
Change the existing line with ``-l 127.0.0.1``.
Finalize installation
---------------------
.. only:: ubuntu or debian
* Restart the Memcached service:
.. code-block:: console
# service memcache restart
.. only:: rdo or obs
* Start the Memcached service and configure it to start when the system
boots:
.. code-block:: console
# systemctl enable memcached.service
# systemctl start memcached.service

View File

@ -23,7 +23,15 @@ these procedures on all nodes.
.. code-block:: console
# apt-get install software-properties-common
# add-apt-repository cloud-archive:liberty
# add-apt-repository cloud-archive:mitaka
.. note::
For pre-release testing, use the staging repository:
.. code-block:: console
# add-apt-repository cloud-archive:mitaka-proposed
.. only:: rdo
@ -60,14 +68,24 @@ these procedures on all nodes.
.. code-block:: console
# yum install centos-release-openstack-liberty
# yum install centos-release-openstack-mitaka
* On RHEL, download and install the RDO repository RPM to enable the
OpenStack repository.
.. code-block:: console
# yum install https://rdoproject.org/repos/openstack-liberty/rdo-release-liberty.rpm
# yum install https://rdoproject.org/repos/openstack-liberty/rdo-release-mitaka.rpm
.. note::
For pre-release testing on CentOS or RHEL, use the delorean repositories:
.. code-block:: console
# yum install yum-plugin-priorities
# wget http://trunk.rdoproject.org/centos7/delorean-deps.repo
# wget http://trunk.rdoproject.org/centos7/current-passed-ci/delorean.repo
.. only:: obs

View File

@ -28,7 +28,7 @@ Install and configure components
.. code-block:: console
# yum install mariadb mariadb-server MySQL-python
# yum install mariadb mariadb-server python2-PyMySQL
.. only:: obs
@ -38,9 +38,9 @@ Install and configure components
.. only:: ubuntu or debian
2. Choose a suitable password for the database root account.
2. Choose a suitable password for the database ``root`` account.
3. Create and edit the ``/etc/mysql/conf.d/mysqld_openstack.cnf`` file
3. Create and edit the ``/etc/mysql/conf.d/openstack.cnf`` file
and complete the following actions:
- In the ``[mysqld]`` section, set the
@ -64,13 +64,11 @@ Install and configure components
default-storage-engine = innodb
innodb_file_per_table
collation-server = utf8_general_ci
init-connect = 'SET NAMES utf8'
character-set-server = utf8
.. only:: obs or rdo
2. Create and edit the ``/etc/my.cnf.d/mariadb_openstack.cnf`` file
2. Create and edit the ``/etc/my.cnf.d/openstack.cnf`` file
and complete the following actions:
- In the ``[mysqld]`` section, set the
@ -87,28 +85,14 @@ Install and configure components
- In the ``[mysqld]`` section, set the following keys to enable
useful options and the UTF-8 character set:
.. only:: rdo
.. code-block:: ini
.. code-block:: ini
[mysqld]
...
default-storage-engine = innodb
innodb_file_per_table
collation-server = utf8_general_ci
init-connect = 'SET NAMES utf8'
character-set-server = utf8
.. only:: obs
.. code-block:: ini
[mysqld]
...
default-storage-engine = innodb
innodb_file_per_table
collation-server = utf8_general_ci
character-set-server = utf8
[mysqld]
...
default-storage-engine = innodb
innodb_file_per_table
collation-server = utf8_general_ci
character-set-server = utf8
Finalize installation
---------------------
@ -140,10 +124,20 @@ Finalize installation
# systemctl enable mysql.service
# systemctl start mysql.service
.. only:: ubuntu or rdo or obs
.. only:: ubuntu
2. Secure the database service by running the
``mysql_secure_installation`` script.
2. Secure the database service by running the ``mysql_secure_installation``
script.
.. code-block:: console
# mysql_secure_installation
.. only:: rdo or obs
2. Secure the database service by running the ``mysql_secure_installation``
script. In particular, choose a suitable password for the database
``root`` account.
.. code-block:: console

View File

@ -80,3 +80,4 @@ Operations Guide <http://docs.openstack.org/ops/>`_.
environment-sql-database.rst
environment-nosql-database.rst
environment-messaging.rst
environment-memcached.rst