From 83a744b1a24e9e8cacfffc337f7e1e0237941148 Mon Sep 17 00:00:00 2001 From: Ben Sturmfels Date: Wed, 10 Mar 2021 20:44:54 +1100 Subject: Update version number, relnotes and upgrading docs in preparation for release. --- docs/source/siteadmin/relnotes.rst | 35 +++++++++++++++++++---------------- docs/source/siteadmin/upgrading.rst | 31 ++++++++++++++++++++----------- 2 files changed, 39 insertions(+), 27 deletions(-) (limited to 'docs/source/siteadmin') diff --git a/docs/source/siteadmin/relnotes.rst b/docs/source/siteadmin/relnotes.rst index cde8526f..b589fa6d 100644 --- a/docs/source/siteadmin/relnotes.rst +++ b/docs/source/siteadmin/relnotes.rst @@ -17,27 +17,30 @@ Release Notes ============= -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. +This chapter has important information about our current and previous releases. +0.11.0 +====== + +This release of MediaGoblin drops support for Python 2 and removes all Python 2 +compatibility code, significantly reducing the work of maintaining MediaGoblin +going forward. Please see details about upgrading below. + +This release also reinstates audio spectrograms with a completely rewritten +Python 3 replacement for the previous Python 2-only audio feature by Fernando +Gutierrez. -0.11.0 (work in progress) -========================= +**Upgrading:** -# make distclean instead of ad-hoc rm's -# advice on --system-site-packages - currently not used in upgrade -# git submodule update --init +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 `_. -# Blog post -- Python3 -- spectrograms -- dressupgeekout images -- Boris retire -- IRC no longer requires registration -- trialling new forge -j **Improvements:** - Run test for LDAP, OpenID and PDF plugins in development Dockerfiles (Ben Sturmfels) diff --git a/docs/source/siteadmin/upgrading.rst b/docs/source/siteadmin/upgrading.rst index 47d78264..a4a851d1 100644 --- a/docs/source/siteadmin/upgrading.rst +++ b/docs/source/siteadmin/upgrading.rst @@ -27,19 +27,28 @@ way if something goes wrong, we can fix things! And be sure to shut down your current MediaGoblin/Celery processes before upgrading! +.. note:: + + Previous versions of the upgrade docs recommended ``./bootstrap.sh && + ./configure && make`` without ``--system-site-packages``. This ignores any + system-wide Python modules and installs everything from the Python Package + Index. That's not strictly a problem, but is inconsistent with the + ":doc:`deploying`" instructions. If you have problems with dependencies, feel + free to revert to this approach. + Upgrade (already on Python 3) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Update to the latest release. In your ``mediagoblin`` directory, run: - ``git fetch && git checkout -q v0.10.0 && git submodule update`` + ``git fetch && git checkout -q v0.11.0 && git submodule update`` 2. Remove your existing installation: - ``rm -rf bin include lib lib64 node_modules`` + ``make distclean`` 3. Install MediaGoblin: - ``./bootstrap.sh && ./configure && make`` + ``./bootstrap.sh && VIRTUALENV_FLAGS='--system-site-packages' ./configure && make`` 4. Update the database: ``./bin/gmg dbupdate`` -5. Restart MediaGoblin +5. Restart the Paster and Celery processes Upgrade (upgrading to Python 3) @@ -48,14 +57,14 @@ Upgrade (upgrading to Python 3) 1. Refer to the "Dependences" and "Configure PostgreSQL" sections of ":doc:`deploying`" to install the necessary Python 3 dependencies. 2. Update to the latest release. In your ``mediagoblin`` directory, run: - ``git fetch && git checkout -q stable && git submodule update`` + ``git fetch && git checkout -q v0.11.0 && git submodule update`` 3. Remove your existing installation: - ``rm -rf bin include lib lib64 node_modules`` + ``make distclean`` 4. Install MediaGoblin: - ``./bootstrap.sh && ./configure && make`` + ``./bootstrap.sh && VIRTUALENV_FLAGS='--system-site-packages' ./configure && make`` 5. Update the database: ``./bin/gmg dbupdate`` -6. Restart MediaGoblin +6. Restart the Paster and Celery processes Updating your system Python @@ -66,9 +75,9 @@ Python may break MediaGoblin. This typically occurs because Python virtual environment is referring to a copy of Python that no longer exists. To fix this: 1. In your ``mediagoblin`` directory, remove your existing installation: - ``rm -rf bin include lib lib64 node_modules`` + ``make disclean`` 2. Install MediaGoblin: - ``./bootstrap.sh && ./configure && make`` + ``./bootstrap.sh && VIRTUALENV_FLAGS='--system-site-packages' ./configure && make`` 3. Update the database: ``./bin/gmg dbupdate`` -4. Restart MediaGoblin +4. Restart the Paster and Celery processes -- cgit v1.2.3