Skip to content

Commit 9310a32

Browse files
Merge pull request nextcloud#1789 from nextcloud/bugfix/noid/add-comment-about-compression
Add a comment about the changed ROW_FORMAT
2 parents 822b0d0 + b1811b4 commit 9310a32

File tree

1 file changed

+16
-12
lines changed

1 file changed

+16
-12
lines changed

admin_manual/configuration_database/mysql_4byte_support.rst

+16-12
Original file line numberDiff line numberDiff line change
@@ -10,23 +10,23 @@ In order to use Emojis (textbased smilies) on your Nextcloud server with a MySQL
1010
installation needs to be tweaked a bit.
1111

1212
1. Make sure your database is set to use the Barracuda InnoDB file format:
13-
13+
1414
Login to your mysql database and run::
15-
15+
1616
mysql> show variables like 'innodb_file_format';
1717
+--------------------+-----------+
1818
| Variable_name | Value |
1919
+--------------------+-----------+
2020
| innodb_file_format | Barracuda |
2121
+--------------------+-----------+
2222
1 row in set (0.00 sec)
23-
23+
2424
If your `innodb_file_format` is set as 'Antelope' you must upgrade your file format using::
25-
25+
2626
mysql> SET GLOBAL innodb_file_format=Barracuda;
27-
27+
2828
.. note::
29-
29+
3030
On some shared hosts, you may not have the permissions to upgrade the InnoDB file format, meaning you are unable to use utf8mb4
3131

3232
2. Make sure the following InnoDB settings are set on your MySQL server:
@@ -35,9 +35,9 @@ installation needs to be tweaked a bit.
3535

3636
[mysqld]
3737
innodb_file_per_table=1
38-
38+
3939
Note::
40-
40+
4141
mysql> show variables like 'innodb_file_per_table';
4242
+-----------------------+-------+
4343
| Variable_name | Value |
@@ -54,15 +54,15 @@ installation needs to be tweaked a bit.
5454
innodb_file_per_table=1
5555

5656
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::
57-
57+
5858
$ cd /var/www/nextcloud
5959
$ sudo -u www-data php occ maintenance:mode --on
60-
60+
6161
4. Restart the MySQL server in case you changed the configuration in step 1.
6262
5. Change your databases character set and collation::
63-
63+
6464
ALTER DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
65-
65+
6666
6. Set the ``mysql.utf8mb4`` config to true in your config.php::
6767

6868
$ 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.
7171

7272
$ sudo -u www-data php occ maintenance:repair
7373

74+
.. note::
75+
76+
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.
77+
7478
8. Disable maintenance mode::
7579

7680
$ sudo -u www-data php occ maintenance:mode --off

0 commit comments

Comments
 (0)