Add MariaDB documentation for OpenStack

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