From 3a32d9e38d3b130aa1a1afaf998a6e968921ad94 Mon Sep 17 00:00:00 2001
From: Michal Konečný <mkonecny@redhat.com>
Date: Feb 23 2022 12:09:48 +0000
Subject: 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>

---

diff --git a/UPGRADING.rst b/UPGRADING.rst
index c4fb50a..07d5962 100644
--- a/UPGRADING.rst
+++ b/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
 ----------------