From 49f8fba232c2c4d7efb050b8e0f499015d25a344 Mon Sep 17 00:00:00 2001 From: Eliot Berriot Date: Tue, 15 Oct 2019 11:52:15 +0200 Subject: [PATCH] Fix #934: Documented how to create DB extension by hand in case of permission error during migrations --- changes/changelog.d/934.doc | 1 + docs/admin/upgrading.rst | 6 ++++++ docs/installation/external_dependencies.rst | 1 + 3 files changed, 8 insertions(+) create mode 100644 changes/changelog.d/934.doc diff --git a/changes/changelog.d/934.doc b/changes/changelog.d/934.doc new file mode 100644 index 000000000..4b319c922 --- /dev/null +++ b/changes/changelog.d/934.doc @@ -0,0 +1 @@ +Documented how to create DB extension by hand in case of permission error during migrations (#934) diff --git a/docs/admin/upgrading.rst b/docs/admin/upgrading.rst index d18dd7447..9f0dc3774 100644 --- a/docs/admin/upgrading.rst +++ b/docs/admin/upgrading.rst @@ -192,6 +192,12 @@ match what is described in :doc:`/installation/debian`: # restart the services sudo systemctl start funkwhale.target +.. note:: + If you see a PermissionError when running the ``migrate`` command, try running the following commands by hand, and relaunch the migrations:: + + sudo -u postgres psql funkwhale -c 'CREATE EXTENSION IF NOT EXISTS "citext";' + sudo -u postgres psql funkwhale -c 'CREATE EXTENSION IF NOT EXISTS "unaccent";' + .. warning:: You may sometimes get the following warning while applying migrations:: diff --git a/docs/installation/external_dependencies.rst b/docs/installation/external_dependencies.rst index 1e108f00a..6925eaf72 100644 --- a/docs/installation/external_dependencies.rst +++ b/docs/installation/external_dependencies.rst @@ -66,6 +66,7 @@ for Funkwhale to work properly: .. code-block:: shell sudo -u postgres psql funkwhale -c 'CREATE EXTENSION "unaccent";' + sudo -u postgres psql funkwhale -c 'CREATE EXTENSION "citext";' Cache setup (Redis)