Commit a1038940 authored by Christian Pointner's avatar Christian Pointner
Browse files

improved docs

parent 761469f8
Pipeline #257 passed with stages
in 5 minutes and 19 seconds
......@@ -31,7 +31,7 @@ running database migrations failed: Error 1071: Specified key was too long; max
```
This most likely means you are using a MariaDB server running on Debian 9 (stretch). Please read
[mariadb-stretch-err1071.md](/mariadb-stretch-err1071.md) for help.
[contrib/mariadb-stretch-err1071.md](/contrib/mariadb-stretch-err1071.md) for help.
If you encouter this problem on any other platform please let us know!
......
......@@ -6,7 +6,7 @@
by default is mapped to a `VARCHAR(255)` inside the database.
Starting with Debian 9 (stretch) MariaDB is installed instead of mySQL. Debian also
switched to `utf8mb4` as the default character set in an attempt to support Emoji's
stored as utf-8 characters in the database.
stored as UTF-8 characters in the database.
This means that a `VARCHAR(255)` is now 1021 bytes long which exceeds the maximum
length (767 bytes) for primary key indices when `innodb` is used (also the default since quite
some time).
......@@ -15,12 +15,15 @@ some time).
There are several possible workarounds for the problem:
* create the database using `utf8` (not `utf8mb4`):
When creating the database use the following command:
* Use `utf8` (not `utf8mb4`). Either by setting `store.db.Charset` to `utf8` or by
creating the database using this command:
```mysql
create database tank CHARACTER SET utf8 COLLATE utf8_general_ci;
```
This means you won't be able to use Emoji's in File Metadata.
Setting the character set using the daemon configuration is preferred because this also
sets makes sure that the database connection itself will use the correct settings as well.
Mind that this means you won't be able to use Emoji's in File Metadata. 😭
* Debian has [backported](https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=886756) some
changes to the MariaDB version in Debian Stretch. Because of this it is possible to switch
......@@ -34,7 +37,7 @@ innodb_large_prefix = On
innodb_default_row_format = dynamic
```
* consider switching to another DBMS:
* Consider switching to another DBMS:
* `tank` also works with postgres
* you may use the mySQL Community Packages from [Oracle](https://dev.mysql.com/doc/refman/5.7/en/linux-installation-debian.html)
* [Percona Server](https://www.percona.com/software/mysql-database/percona-server) is drop-in replacement for mySQL
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment