From 7981fdaf7d7611316f592cd89f05a48d2dcffc2c Mon Sep 17 00:00:00 2001 From: Ben Sturmfels Date: Mon, 11 May 2020 23:14:18 +1000 Subject: [PATCH] docs: Add chapter on upgrading, inc. system Python upgrades [#972]. --- docs/source/index.rst | 1 + docs/source/siteadmin/deploying.rst | 17 ++-------- docs/source/siteadmin/relnotes.rst | 52 +++-------------------------- 3 files changed, 9 insertions(+), 61 deletions(-) diff --git a/docs/source/index.rst b/docs/source/index.rst index b13968a5..0fba45f4 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -39,6 +39,7 @@ MediaGoblin website. It is written for site administrators. siteadmin/deploying siteadmin/production-deployments siteadmin/configuration + siteadmin/upgrading siteadmin/media-types siteadmin/help siteadmin/relnotes diff --git a/docs/source/siteadmin/deploying.rst b/docs/source/siteadmin/deploying.rst index b870bf45..41e67c31 100644 --- a/docs/source/siteadmin/deploying.rst +++ b/docs/source/siteadmin/deploying.rst @@ -275,20 +275,9 @@ This directory will be used to store uploaded media files:: $ mkdir --mode=2750 user_dev -This concludes the initial configuration of the MediaGoblin -environment. In the future, when you update your -codebase, you should also run:: - - sudo su mediagoblin --shell=/bin/bash - $ cd /srv/mediagoblin.example.org - $ git submodule update && ./bin/python setup.py develop --upgrade && ./bin/gmg dbupdate - -.. note:: - - Note: If you are running an active site, depending on your server - configuration, you may need to stop it first or the dbupdate command - may hang (and it's certainly a good idea to restart it after the - update) +This concludes the initial configuration of the MediaGoblin +environment. In the future, you can upgrade MediaGoblin according to +the ":doc:`upgrading`" documentation. Configure Mediagoblin diff --git a/docs/source/siteadmin/relnotes.rst b/docs/source/siteadmin/relnotes.rst index c4272854..69126834 100644 --- a/docs/source/siteadmin/relnotes.rst +++ b/docs/source/siteadmin/relnotes.rst @@ -21,14 +21,6 @@ This chapter has important information for releases in it. If you're upgrading from a previous release, please read it carefully, or at least skim over it. -.. note:: - - ALWAYS do backups before upgrading, especially before - running migrations! That way if something goes wrong, we can fix - things! - - And be sure to shut down your current MediaGoblin/Celery processes - before upgrading! 0.11.0 (work in progress) @@ -57,46 +49,12 @@ release. FastCGI support has now been deprecated and removed from the documentation as our dependency `flup` does not support Python 3. -**Upgrade (already on Python 3):** +**Upgrading:** -0. Update to the latest release. In your ``mediagoblin`` directory, run: - ``git fetch && git checkout -q v0.10.0`` -1. Remove your existing installation: - ``rm -rf bin include lib lib64 node_modules`` -2. Upgrade MediaGoblin: - ``./bootstrap.sh && ./configure && make`` -3. Update the database: - ``./bin/gmg dbupdate`` -4. Restart MediaGoblin - -**Upgrade (upgrading to Python 3):** - -0. Refer to the "Dependences" and "Configure PostgreSQL" sections of - ":doc:`deploying`" to install the necessary Python 3 dependencies. -1. Update to the latest release. In your ``mediagoblin`` directory, run: - ``git fetch && git checkout -q v0.10.0`` -2. Remove your existing installation: - ``rm -rf bin include lib lib64 node_modules`` -3. Upgrade MediaGoblin: - ``./bootstrap.sh && ./configure && make`` -4. Update the database: - ``./bin/gmg dbupdate`` -5. Restart MediaGoblin - -**Upgrade (remaining on Python 2 - not recommended):** - -0. Update to the latest release. In your ``mediagoblin`` directory, run: - ``git fetch && git checkout -q v0.10.0`` -1. Remove your existing installation: - ``rm -rf bin include lib lib64 node_modules`` -2. Upgrade MediaGoblin: - ``./bootstrap.sh && ./configure --without-python3 && make`` -3. Update the database: - ``./bin/gmg dbupdate`` -4. Restart MediaGoblin - -For detailed instructions on installing MediaGoblin, see ":doc:`deploying`". If -you have any problems, please drop in to the `#mediagoblin IRC chat +For detailed instructions on installing or upgrading, see ":doc:`deploying`" and +":doc:`upgrading`". + +If you have any problems, please drop in to the `#mediagoblin IRC chat `_, report an issue on our `issue tracker `_ or drop us an email to `mediagoblin-devel@gnu.org `_. -- 2.25.1