Browse Source

Document MySQL migration issue

Document solution for the https://pagure.io/pagure/issue/5219 in pagure
documentation.

Signed-off-by: Michal Konečný <mkonecny@redhat.com>
Michal Konečný 2 years ago
parent
commit
3a32d9e38d
1 changed files with 8 additions and 0 deletions
  1. 8 0
      UPGRADING.rst

+ 8 - 0
UPGRADING.rst

@@ -42,6 +42,14 @@ New configuration key added (in 5.11.2):
 
 * LOGGING_GIT_HOOKS
 
+.. warning:: When upgrading MySQL database you can encounter issue with
+       incompatible columns. In this case try to check the collation of the
+       mentioned column by ``show full columns from <table>;`` in ``mysql``.
+       If the collation is something else then `utf8` you need to convert
+       your database to `utf8` first. See
+       `this guide <https://stackoverflow.com/questions/1294117/how-to-change-collation-of-database-table-column>`_
+       for how to do it or if you have SQL script for db setup,
+       you can change it directly in the script.
 
 From 5.9 to 5.10
 ----------------