aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBen Sturmfels <ben@sturm.com.au>2021-04-09 15:18:17 +1000
committerBen Sturmfels <ben@sturm.com.au>2021-04-09 15:19:50 +1000
commit93084dfe2873008c0de904d30d10f6d82e081a7f (patch)
treea3c9095318d37d4d49d4d2a5e554de2575667ab0
parent45a8c34a711e4396e598ebeba2f65ccb6adb53f2 (diff)
downloadmediagoblin-93084dfe2873008c0de904d30d10f6d82e081a7f.tar.lz
mediagoblin-93084dfe2873008c0de904d30d10f6d82e081a7f.tar.xz
mediagoblin-93084dfe2873008c0de904d30d10f6d82e081a7f.zip
Document re-installation of plugins during upgrade [#5611].
-rw-r--r--docs/source/siteadmin/relnotes.rst2
-rw-r--r--docs/source/siteadmin/upgrading.rst20
2 files changed, 16 insertions, 6 deletions
diff --git a/docs/source/siteadmin/relnotes.rst b/docs/source/siteadmin/relnotes.rst
index d1214d29..d54c3244 100644
--- a/docs/source/siteadmin/relnotes.rst
+++ b/docs/source/siteadmin/relnotes.rst
@@ -31,6 +31,8 @@ This chapter has important information about our current and previous releases.
Martins)
- Add Docker and CI builds for Debian 11/Bullseye (Ben Sturmfels)
- Fix/document Guix setup for 100% passing test suite (Ben Sturmfels)
+- Convert `setup.py` to `setup.cfg` (Ben Sturmfels)
+- Document re-installation of plugins during upgrade [#5611] (Ben Sturmfels)
**Bug fixes:**
diff --git a/docs/source/siteadmin/upgrading.rst b/docs/source/siteadmin/upgrading.rst
index 598479ee..40df97ff 100644
--- a/docs/source/siteadmin/upgrading.rst
+++ b/docs/source/siteadmin/upgrading.rst
@@ -32,19 +32,27 @@ Upgrade
git fetch && git checkout -q v0.12.0 && git submodule update
-2. Remove your existing installation::
+2. Note down any plugins you have installed by reviewing your
+ ``mediagoblin.ini`` configuration. These will be removed by the following
+ steps and must be re-installed.
+
+3. Remove your existing installation::
make distclean
-3. Recreate the virtual environment and install MediaGoblin::
+4. Recreate the virtual environment and install MediaGoblin::
+
+ ./bootstrap.sh && VIRTUALENV_FLAGS='--system-site-packages' ./configure &&
+ make
- ./bootstrap.sh && VIRTUALENV_FLAGS='--system-site-packages' ./configure && make
+5. Re-install any ":doc:`plugins`" you had previously installed. Skipping these
+ may result in errors updating the database.
-4. Update the database::
+6. Update the database::
./bin/gmg dbupdate
-5. Restart the Paster and Celery processes. If you followed ":doc:`deploying`",
+7. Restart the Paster and Celery processes. If you followed ":doc:`deploying`",
this may be something like::
sudo systemctl restart mediagoblin-paster.service
@@ -55,7 +63,7 @@ Upgrade
sudo journalctl -u mediagoblin-paster.service -f
sudo journalctl -u mediagoblin-celeryd.service -f
-6. View your site and hover your cursor over the "MediaGoblin" link in the
+8. View your site and hover your cursor over the "MediaGoblin" link in the
footer to confirm the version number you're running.