SQL database

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.

Install and configure components

  1. Install the packages:

    # apt-get install mariadb-server python-pymysql
  1. Choose a suitable password for the database root account.

  2. 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:

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

      default-storage-engine = innodb
      collation-server = utf8_general_ci
      init-connect = 'SET NAMES utf8'
      character-set-server = utf8

Finalize installation

  1. Restart the database service:

    # service mysql restart
  1. Secure the database service by running the mysql_secure_installation script.
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.