openstack/keystone
Code Issues Proposed changes

Merge "Updated the doc for MySQL > 5.7"

Browse Source
This commit is contained in:
Zuul
2025-07-01 14:34:51 +00:00
committed by Gerrit Code Review
parent 84a30d5607 b02ed6c9f6
commit 4e4cd0dcdc
1 changed files with 23 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
doc/source/install/keystone-install-ubuntu.rst
View File

@@ -19,7 +19,7 @@ Prerequisites
Before you install and configure the Identity service, you must
create a database.
#. Use the database access client to connect to the database
1. Use the database access client to connect to the database
server as the ``root`` user:
.. code-block:: console
@@ -36,7 +36,24 @@ create a database.
.. end
#. Grant proper access to the ``keystone`` database:
3. Grant proper access to the ``keystone`` database:
.. note::
Replace ``KEYSTONE_DBPASS`` with a suitable password.
On MySQL 8 and 9, the user must be created first:
.. code-block:: console
MariaDB [(none)]> CREATE USER 'keystone'@'localhost' IDENTIFIED BY 'KEYSTONE-DBPASS';
MariaDB [(none)]> GRANT ALL PRIVILEGES ON keystone.* TO 'keystone'@'localhost';
MariaDB [(none)]> CREATE USER 'keystone'@'%' IDENTIFIED BY 'KEYSTONE-DBPASS';
MariaDB [(none)]> GRANT ALL PRIVILEGES ON keystone.* TO 'keystone'@'%';
.. end
On MySQL 5.7, the following commands will create the user on the same line:
.. code-block:: console
@@ -47,9 +64,7 @@ create a database.
.. end
Replace ``KEYSTONE_DBPASS`` with a suitable password.
#. Exit the database access client.
4. Exit the database access client.
.. _keystone-install-configure-ubuntu:
@@ -66,7 +81,7 @@ Install and configure components
for you (including the activation of the ``mod_wsgi`` apache2 module and
keystone configuration in Apache).
#. Run the following command to install the packages:
1. Run the following command to install the packages:
.. code-block:: console
@@ -156,7 +171,7 @@ Install and configure components
Configure the Apache HTTP server
--------------------------------
#. Edit the ``/etc/apache2/apache2.conf`` file and configure the
1. Edit the ``/etc/apache2/apache2.conf`` file and configure the
``ServerName`` option to reference the controller node:
.. path /etc/apache2/apache2.conf
@@ -177,7 +192,7 @@ behind an SSL terminator.
Finalize the installation
-------------------------
#. Restart the Apache service:
1. Restart the Apache service:
.. code-block:: console