From 6a5044d190e91f9194d639dddf04f10ecc9084b1 Mon Sep 17 00:00:00 2001 From: Adam Monsen Date: Sun, 27 Apr 2025 14:25:57 -0700 Subject: [PATCH 1/3] explain v31 db row format warning Signed-off-by: Adam Monsen --- admin_manual/release_notes/upgrade_to_31.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/admin_manual/release_notes/upgrade_to_31.rst b/admin_manual/release_notes/upgrade_to_31.rst index 703426a12c0..38929f90d1f 100644 --- a/admin_manual/release_notes/upgrade_to_31.rst +++ b/admin_manual/release_notes/upgrade_to_31.rst @@ -8,6 +8,14 @@ System requirements * PHP 8.1 is now deprecated but still supported. * PHP 8.4 is now supported, but 8.3 is recommended. +Database configuration +---------------------- + +We have a new setup warning for MySQL and MariaDB databases if any tables are using a row format other than Dynamic. +This is likely true for older installations. +To resolve the warning, issue the proper ``ALTER TABLE`` DDL commands to change the row format during a maintenance window. +If you're not sure how to do this, you can `find some tips and tricks from the community `_. + PHP configuration ----------------- From de7c1eddc158cf32915bebd9d7df6dbbb1c69206 Mon Sep 17 00:00:00 2001 From: Adam Monsen Date: Mon, 28 Apr 2025 13:18:50 -0700 Subject: [PATCH 2/3] reword row format explanation Co-authored-by: Ferdinand Thiessen Signed-off-by: Adam Monsen --- admin_manual/release_notes/upgrade_to_31.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/admin_manual/release_notes/upgrade_to_31.rst b/admin_manual/release_notes/upgrade_to_31.rst index 38929f90d1f..3ecfd6e443c 100644 --- a/admin_manual/release_notes/upgrade_to_31.rst +++ b/admin_manual/release_notes/upgrade_to_31.rst @@ -11,9 +11,11 @@ System requirements Database configuration ---------------------- -We have a new setup warning for MySQL and MariaDB databases if any tables are using a row format other than Dynamic. -This is likely true for older installations. -To resolve the warning, issue the proper ``ALTER TABLE`` DDL commands to change the row format during a maintenance window. +Other row formats than ``DYNAMIC`` for MySQL and MariaDB databases will issue a warning since Nextcloud 24, +as they often cause performance issues. +With Nextcloud 31 a more prominent new setup warning for this was added. +To resolve the warning, in most cases running ``occ db:convert-mysql-charset`` will resolve the issue. +If some tables are not covered by the ``occ`` command, issuing the proper ``ALTER TABLE`` DDL commands to change the row format during a maintenance window is needed. If you're not sure how to do this, you can `find some tips and tricks from the community `_. PHP configuration From a8fe5b878a7be967fdba6ac644295a0c548eb4b2 Mon Sep 17 00:00:00 2001 From: Adam Monsen Date: Mon, 28 Apr 2025 13:27:34 -0700 Subject: [PATCH 3/3] link to relevant issue and PR Signed-off-by: Adam Monsen --- admin_manual/release_notes/upgrade_to_31.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/admin_manual/release_notes/upgrade_to_31.rst b/admin_manual/release_notes/upgrade_to_31.rst index 3ecfd6e443c..0921abce581 100644 --- a/admin_manual/release_notes/upgrade_to_31.rst +++ b/admin_manual/release_notes/upgrade_to_31.rst @@ -11,9 +11,9 @@ System requirements Database configuration ---------------------- -Other row formats than ``DYNAMIC`` for MySQL and MariaDB databases will issue a warning since Nextcloud 24, +Other row formats than ``DYNAMIC`` for MySQL and MariaDB databases will `issue a warning since Nextcloud 24 `_, as they often cause performance issues. -With Nextcloud 31 a more prominent new setup warning for this was added. +With Nextcloud 31 a `more prominent new setup warning `_ for this was added. To resolve the warning, in most cases running ``occ db:convert-mysql-charset`` will resolve the issue. If some tables are not covered by the ``occ`` command, issuing the proper ``ALTER TABLE`` DDL commands to change the row format during a maintenance window is needed. If you're not sure how to do this, you can `find some tips and tricks from the community `_.