From 75c17c69089577f7205f82d5eb299abc3d7118f8 Mon Sep 17 00:00:00 2001
From: Jakub Kadlcik <frostyx@email.cz>
Date: Jul 23 2019 17:52:59 +0000
Subject: [doc] describe how to upgrade the database


---

diff --git a/doc/how_to_upgrade_persistent_instances.rst b/doc/how_to_upgrade_persistent_instances.rst
index 16868bc..ae32cfb 100644
--- a/doc/how_to_upgrade_persistent_instances.rst
+++ b/doc/how_to_upgrade_persistent_instances.rst
@@ -108,6 +108,9 @@ you need to debug and fix the issues from running it. If required, adjust the pl
 and re-run it again and again. Most likely you will also need to attach a volume to it
 in the `OpenStack instances dashboard`_.
 
+.. note:: frontend - It will most likely be necessary to manualy upgrade the database.
+          See `Upgrade the database`_.
+
 .. note:: backend - Copr backend requires an outdated version of python3-novaclient.
           See `Downgrade python novaclient`_.
 
@@ -219,6 +222,25 @@ instance)::
           with the situation properly.
 
 
+Upgrade the database
+....................
+
+When upgrading to a distribution that provides a new major version of PostgreSQL server,
+there is a manual intervention required.
+
+Upgrade the database::
+
+    [root@copr-fe-dev ~][STG]# dnf install postgresql-upgrade
+    [root@copr-fe-dev ~][STG]# postgresql-setup --upgrade
+
+
+And rebuild indexes::
+
+    [root@copr-fe-dev ~][STG]# su postgres
+    bash-5.0$ cd
+    bash-5.0$ reindexdb --all
+
+
 
 .. _`Fedora Infra OpenStack`: https://fedorainfracloud.org
 .. _`OpenStack images dashboard`: https://fedorainfracloud.org/dashboard/project/images/