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

Include info about Barracuda innodb_file_format (#1512)

Browse Source 
Include info about Barracuda innodb_file_format
This commit is contained in:
John Molakvoæ
2019-07-02 06:43:36 +02:00
committed by GitHub
parent 27a144d2a1 2a725a60d0
commit bbec0b7261
1 changed files with 29 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
admin_manual/configuration_database/mysql_4byte_support.rst
View File

@@ -2,10 +2,34 @@
Enabling MySQL 4-byte support
=============================
.. note::
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.
1. Make sure the following InnoDB settings are set on your MySQL server:
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 |
+--------------------+-----------+
| 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:
a. MySQL 8.0 or later::
@@ -29,16 +53,16 @@ installation needs to be tweaked a bit.
innodb_file_format=barracuda
innodb_file_per_table=1
2. Restart the MySQL server in case you changed the configuration in step 1.
3. Change your databases character set and collation::
3. Restart the MySQL server in case you changed the configuration in step 1.
4. Change your databases character set and collation::
ALTER DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
4. Set the ``mysql.utf8mb4`` config to true in your config.php::
5. 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"
5. Convert all existing tables to the new collation by running the repair step::
6. Convert all existing tables to the new collation by running the repair step::
$ sudo -u www-data php occ maintenance:repair