chore: Update MySQL 4-byte support chapter for current defaults

Signed-off-by: Josh <[email protected]>

admin_manual/configuration_database/mysql_4byte_support.rst

@@ -6,25 +6,17 @@ Enabling MySQL 4-byte support
 
     Be sure to backup your database before performing this database upgrade.
 
-In order to use Emojis (textbased smilies) on your Nextcloud server with a MySQL database, the
-installation needs to be tweaked a bit.
+To be able to handle 4-byte characters with MySQL/MariaDB (like emojis in filenames or comments) 
+it is recommended to enable 4-byte support in MySQL. If you're not sure if you need this, you 
+should probably enable it. This is also the appropriate thing to do if you encounter errors such 
+as ``Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes``.
 
 .. warning::
 
-    This manual only covers MySQL 8 or newer and MariaDB 10.2 or newer.
-    If you use MariaDB 10.2, please check
-    `this older version <https://docs.nextcloud.com/server/20/admin_manual/configuration_database/mysql_4byte_support.html#mariadb-10-2-or-earlier>`_
-    of the documentation. If you use an older version of MySQL or MariaDB, please note that they are no longer supported
-    by the current Nextcloud version.
+    This manual only covers versions of MySQL and MariaDB that are officially supported by Nextcloud. 
+    See :doc:`../installation/system_requirements` for supported versions.
 
-1. Make sure the following InnoDB settings are set on your MySQL server::
-
-    [mysqld]
-    innodb_file_per_table=1
-
-2. Restart the MySQL server in case you changed the configuration in step 1.
-
-You can then verify that the change worked:
+1. The following InnoDB setting should already be set on current versions of MySQL/MariaDB server::
 
 .. code-block:: sql
 
@@ -40,35 +32,44 @@ The result should look like this::
     +-----------------------+-------+
     1 row in set (0.00 sec)
 
-3. Open a shell, change dir (adjust ``/var/www/nextcloud`` to your nextcloud location if needed), and put your nextcloud instance in maintenance mode, if it isn't already::
+If it does not, you can change the parameter permanently by setting the following::
+
+    [mysqld]
+    innodb_file_per_table=1
+
+Then restart the MySQL/MariaDB server to activate the changed configuration.
+
+You can then verify that the change worked by repeating the ``SHOW`` command above.
+
+2. Open a shell, change to your Nextcloud installation directory (adjust ``/var/www/nextcloud`` to your nextcloud location if needed), and put your nextcloud instance in maintenance mode, if it isn't already::
 
    $ cd /var/www/nextcloud
    $ sudo -u www-data php occ maintenance:mode --on
 
-4. Change your databases character set and collation:
+3. Change your databases character set and collation:
 
 .. code-block:: sql
 
     ALTER DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
 
-5. Set the ``mysql.utf8mb4`` config to true in your config.php::
+4. Set the ``mysql.utf8mb4`` config to true in your config.php::
 
     $ sudo -u www-data php occ config:system:set mysql.utf8mb4 --type boolean --value="true"
 
-6. Convert all existing tables to the new collation by running the repair step::
+5. Convert all existing tables to the new collation by running the repair step::
 
     $ sudo -u www-data php occ maintenance:repair
 
 .. note::
 
-    This will also change the `ROW_FORMAT` to `DYNAMIC` for your tables.
+    This will also take care of changing the `ROW_FORMAT` to `DYNAMIC` for your tables.
 
-7. Disable maintenance mode::
+6. Disable maintenance mode::
 
    $ sudo -u www-data php occ maintenance:mode --off
 
 Now you should be able to use Emojis in your file names, calendar events, comments and many more.
 
 .. note::
 
-    Also make sure your backup strategy still work. If you use ``mysqldump`` make sure to add the ``--default-character-set=utf8mb4`` option. Otherwise your backups are broken and restoring them will result in ``?`` instead of the emojis, making files inaccessible.
+    Also make sure to review your :doc:`../maintenance/backup` strategy. If you use ``mysqldump`` make sure to add the ``--default-character-set=utf8mb4`` option. Otherwise your backups are broken and restoring them will result in ``?`` instead of the emojis and files may become inaccessible.