khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2026-01-03 18:26:42 +07:00
Code Issues Packages Projects Releases Wiki Activity

Add a comment about the changed ROW_FORMAT

Browse Source 
Signed-off-by: Joas Schilling <coding@schilljs.com>
This commit is contained in:
Joas Schilling
2020-01-20 11:45:41 +01:00
parent 822b0d04b5
commit b1811b409d
1 changed files with 16 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
admin_manual/configuration_database/mysql_4byte_support.rst
View File

@@ -10,9 +10,9 @@ In order to use Emojis (textbased smilies) on your Nextcloud server with a MySQL
installation needs to be tweaked a bit.
1. Make sure your database is set to use the Barracuda InnoDB file format:
Login to your mysql database and run::
mysql> show variables like 'innodb_file_format';
+--------------------+-----------+
| Variable_name | Value |
@@ -20,13 +20,13 @@ installation needs to be tweaked a bit.
| innodb_file_format | Barracuda |
+--------------------+-----------+
1 row in set (0.00 sec)
If your `innodb_file_format` is set as 'Antelope' you must upgrade your file format using::
mysql> SET GLOBAL innodb_file_format=Barracuda;
.. note::
On some shared hosts, you may not have the permissions to upgrade the InnoDB file format, meaning you are unable to use utf8mb4
2. Make sure the following InnoDB settings are set on your MySQL server:
@@ -35,9 +35,9 @@ installation needs to be tweaked a bit.
[mysqld]
innodb_file_per_table=1
Note::
mysql> show variables like 'innodb_file_per_table';
+-----------------------+-------+
| Variable_name | Value |
@@ -54,15 +54,15 @@ installation needs to be tweaked a bit.
innodb_file_per_table=1
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::
$ cd /var/www/nextcloud
$ sudo -u www-data php occ maintenance:mode --on
4. Restart the MySQL server in case you changed the configuration in step 1.
5. Change your databases character set and collation::
ALTER DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
6. 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"
@@ -71,6 +71,10 @@ installation needs to be tweaked a bit.
$ sudo -u www-data php occ maintenance:repair
.. note::
This will alos change the `ROW_FORMAT` to `COMPRESSED` for your tables, to make sure the used database storage size is not getting out of hand.
8. Disable maintenance mode::
$ sudo -u www-data php occ maintenance:mode --off