diff options
| -rw-r--r-- | docs/source/siteadmin/relnotes.rst | 2 | ||||
| -rw-r--r-- | docs/source/siteadmin/upgrading.rst | 20 |
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. |