openstack-manuals/doc/install-guide-rst/source/basics-database.rst

SQL 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 or MySQL depending on the distribution. OpenStack services also support other SQL databases including PostgreSQL.

To install and configure the database server

1. Install the packages:

   rdo or ubuntu or obs

   Note

   The Python MySQL library is compatible with MariaDB.

   ubuntu

   # apt-get install mariadb-server python-mysqldb

   debian

   # apt-get install mysql-server python-mysqldb

   rdo

   # yum install mariadb mariadb-server MySQL-python

   obs

   # zypper install mariadb-client mariadb python-mysql

ubuntu or debian

2. Choose a suitable password for the database root account.
3. Create and edit the /etc/mysql/conf.d/mysqld_openstack.cnf file and complete the following actions:

   • In 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:

     [mysqld]
     ...
     bind-address = 10.0.0.11

   • In the [mysqld] section, set the following keys to enable useful options and the UTF-8 character set:

     [mysqld]
     ...
     default-storage-engine = innodb
     innodb_file_per_table
     collation-server = utf8_general_ci
     init-connect = 'SET NAMES utf8'
     character-set-server = utf8

obs or rdo

2. Create and edit the /etc/my.cnf.d/mariadb_openstack.cnf file and complete the following actions:

   • In 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:

     [mysqld]
     ...
     bind-address = 10.0.0.11

   • In the [mysqld] section, set the following keys to enable useful options and the UTF-8 character set:

     [mysqld]
     ...
     default-storage-engine = innodb
     innodb_file_per_table
     collation-server = utf8_general_ci
     init-connect = 'SET NAMES utf8'
     character-set-server = utf8

To finalize installation

ubuntu or debian

1. Restart the database service:

   # service mysql restart

rdo or obs

1. Start the database service and configure it to start when the system boots:

   rdo

   # systemctl enable mariadb.service
   # systemctl start mariadb.service

   obs

   # systemctl enable mysql.service
   # systemctl start mysql.service

ubuntu or debian

2. Secure the database service:

   mariadb_output.txt

rdo or obs

2. Secure the database service including choosing a suitable password for the root account:

   mariadb_output.txt