diff --git a/source/openstack_environment-database.rst b/source/openstack_environment-database.rst new file mode 100644 index 00000000..bc5a1e0d --- /dev/null +++ b/source/openstack_environment-database.rst @@ -0,0 +1,56 @@ +Database +~~~~~~~~ +Most OpenStack services use an SQL database to store information. The +database typically runs on the controller node. The procedures in this +guide use MariaDB. + +Install and configure the database server +----------------------------------------- + +#. Install MariaDB bundle: + + .. code-block:: console + + # clr_bundle_add database-mariadb + +#. Create the ``/etc/mariadb/`` folder and the ``/etc/mariadb/openstack.cnf`` file. + + .. code-block:: console + + # mkdir /etc/mariadb + # touch /etc/mariadb/openstack.cnf + +#. Add the ``[mysqld]`` section, set the bind-address key to the + management IP address of the controller node to enable access by + other nodes via the management network and enable useful options for + UTF-8 character set: + + .. code:: console + + [mysqld] + bind-address = 10.0.0.11 + default-storage-engine = innodb + innodb_file_per_table + collation-server = utf8_general_ci + init-connect = 'SET NAMES utf8' + character-set-server = utf8 + +Finalizing database installation +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Complete the following steps to finalize database installation: + +#. Start the database service and configure it to start when the system + boots: + + .. code:: console + + # systemctl enable mariadb.service + # systemctl start mariadb.service + +2. Secure the database service including choosing a suitable password + for the root account: + + .. code:: console + + # mysql_secure_installation