Added by oktay t. over 6 years ago
Hello Support,
I have some problems after upgrade OpenProject Release: 7.4.7 to 8.0.0.
Upgrade steps:
stable/7
in /etc/yum.repos.d/openproject.repo
to stable/8
All steps runs without errors, with one warning:
After Upgrade the OpenProject was not accessible.
Environment: Installation on VServer CentOS Linux 7.5.1804 (Core) + Plesk Onyx Version 17.8.11
Thanks,
o.t.
Replies (3)
Hello,
The screenshot you added is a warning regarding UTF-8 support in MySQL. MySQL <= 5.6 (or MariaDB <= 10.1) do not natively support utf8mb4 without restricting index key lengths. If you enable utf8mb4 in these versions, migrations will result in errors because some of our indices are simply longer than the 767 bytes in utf8mb4. In UTF-8, all indices are short enough.
The essence is:
When you run MySQL 5.7 -> Use utf8mb4 encoding for new OpenProject installations, otherwise UTF-8
When you use UTF-8 -> Some UTF-8 characters cannot be processed by MySQL and result in an error (typical cases for are emojis, certain cyrillic characters, for example)
When you have run OpenProject in the past with UTF-8, you'll either need to stick with it or migrate your database. There are a few guides out there on how to do that. It's very unfortunate, but in the end it's MySQL's fault for selling their UTF-8 encoding as something not fully UTF-8 compatible.
Regarding accessibility of the application:
could you append the output of
/var/log/openporject/*.log
?Best,
Oliver
Hello,
I restore yesterday the Release: 7.4.7 back. To reproduce the installation 8.0.0, I have installed the version today 8.0.0 again.
Same Installation steps:
stable/7
in/etc/yum.repos.d/openproject.repo
tostable/8
The warning "OpenProject requires UTF-8 encoding set on MySQL < 5.7 ....." comes again.
But this time the installation 8.0.0 worked fine. Login, other functions are OK.
My question is: What disadvantages arise when the OpenProject installation 8.0.0 runs with this warning.
Configurations:
Installed MYSQL Version:
File: opt/openproject/config/database.yml
Production.log
Database
Thanks,
o.t.
Hello o.t.,
actually, MySQL installations with OpenProject have always run with utf8 encoding in the past, so the warning is only a result of the bug reports we have received from users that run into issues with utf8. It has no other effect and if you wish you can silence it with
openproject config:set OPENPROJECT_SKIP_MYSQL_ENCODING_CHECK=true
Short version: In MySQL, utf8 encoding has only allowed UTF-8 characters of up to three bytes since around ~2003, likely for performance and space optimization. However, emojis and certain character sets (Cyrillic we know of due to ticket ) will not be accepted by MySQL with this encoding. This will result in OpenProject raising an internal error when trying to submit text with these characters.
A switch to utf8mb4 is possible for MySQL versions > 5.7 due to other issues with Index key lengths in the utf8mb4 encoding. However, this requires manual effort on the DBA side that we cannot automate well.
Regarding the warning: If you freshly install OpenProject on MySQL versions 5.7. and above, use the
utf8mb4
encoding and you'll be fine!I would suggest reading this article if you're interested in the details: https://medium.com/@adamhooper/in-mysql-never-use-utf8-use-utf8mb4-11761243e434
Best,
Oliver