From d9d63ea2b3707003b79cbd7e27599d118bc2607b Mon Sep 17 00:00:00 2001 From: James Elliott Date: Fri, 9 Dec 2022 22:38:56 +1100 Subject: [PATCH] docs: storage ref clarity (#4530) --- .../reference/integrations/database-integrations.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/content/en/reference/integrations/database-integrations.md b/docs/content/en/reference/integrations/database-integrations.md index b1a862bda..efe33915f 100644 --- a/docs/content/en/reference/integrations/database-integrations.md +++ b/docs/content/en/reference/integrations/database-integrations.md @@ -22,6 +22,9 @@ is updated. For example for database version `x.y.z` only the `z` should change, It is also generally recommended that you do not rely on automatic update tools to perform this action unless you are sure they shut down the container properly (i.e. with a graceful stop). +While this guide exists and it contains some guidance on managing the database being used, it is by no means exhaustive +or intended as such and users should refer to the database vendors documentation. + ## PostgreSQL The only current support criteria for [PostgreSQL] at present is that the version you're using is supported by the @@ -99,13 +102,15 @@ schema. The risk here is that the database may run for an extended period of time unnoticed and may be getting more and more corrupt with no visible signs until it's no longer recoverable. This makes it critically important users do not neglect -this operation or ensure it's happening. While a good [MySQL] or [MariaDB] container will ensure this occurs, it is up -to the individual to confirm these upgrades are occurring. +this operation or ensure it's happening. + +While some [MySQL] or [MariaDB] containers will do this automatically or give users an option to perform this +automatically, it is strongly recommended that this process is manually done and only done **_after_** doing a backup of +all databases on the server as is the recommendation from both [MySQL] and [MariaDB]. It is your responsibility to ensure these tables are upgraded as per the [mysql_upgrade](https://dev.mysql.com/doc/refman/8.0/en/mysql-upgrade.html) and -[mariadb_upgrade](https://mariadb.com/kb/en/mysql_upgrade/) documentation. Some containers or some versions of [MySQL] -and [MariaDB] may do this for you, but this is out of scope for us to support. +[mariadb_upgrade](https://mariadb.com/kb/en/mysql_upgrade/) documentation. ### Vendor Supported Versions