From 76a710a2ae91dac2f090db3d0e70cd814ac9598f Mon Sep 17 00:00:00 2001 From: Brian Rosmaita Date: Wed, 12 Feb 2025 12:23:55 -0500 Subject: [PATCH] docs: add supported db info Change-Id: I77d73f91fe3497076c08e4e05d99a2da8569e1f3 Closes-bug: #1968746 --- doc/source/admin/upgrades.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/source/admin/upgrades.rst b/doc/source/admin/upgrades.rst index cb1ec3fb1e3..7be73ce77c3 100644 --- a/doc/source/admin/upgrades.rst +++ b/doc/source/admin/upgrades.rst @@ -75,6 +75,23 @@ data migrations. For information on developing your own schema or data migrations as part of a feature or bugfix, refer to :doc:`/contributor/database-migrations`. +.. note:: + Occasionally we receive reports of database issues during upgrades + due to an old version of database software being used (see, for example, + `Bug #1968746 `_). + + Upgrades are tested in the gate using the mysql or mariadb version + packaged with any of the Linux distributions supported for that release. + Thus, if you are using an earlier version of mysql or mariadb, you may + want to do additional research before upgrading to make sure you won't + run into an issue caused by us using a newer feature than your database + version supports. + + To assist you in this, the OpenStack Technical Committee maintains a list + of the Linux distributions supported for each release on the + `Release based Runtimes + `_ page. + API load balancer draining ~~~~~~~~~~~~~~~~~~~~~~~~~~