projects / mediagoblin.git / blame
| Commit | Line | Data |
|---|---|---|
| 6a547ea4 BS |
1 | .. MediaGoblin Documentation |
| 2 | ||
| 3 | Written in 2020 by MediaGoblin contributors | |
| 4 | ||
| 5 | To the extent possible under law, the author(s) have dedicated all | |
| 6 | copyright and related and neighboring rights to this software to | |
| 7 | the public domain worldwide. This software is distributed without | |
| 8 | any warranty. | |
| 9 | ||
| 10 | You should have received a copy of the CC0 Public Domain | |
| 11 | Dedication along with this software. If not, see | |
| 12 | <http://creativecommons.org/publicdomain/zero/1.0/>. | |
| 13 | ||
| 14 | ====================== | |
| 15 | Upgrading MediaGoblin | |
| 16 | ====================== | |
| 17 | ||
| 18 | Updating to a new release of MediaGoblin | |
| 19 | ---------------------------------------- | |
| 20 | ||
| 21 | Preparation | |
| 22 | ~~~~~~~~~~~ | |
| 23 | ||
| 24 | *ALWAYS* do backups before upgrading, especially before running migrations! That | |
| 25 | way if something goes wrong, we can fix things! | |
| 26 | ||
| 27 | And be sure to shut down your current MediaGoblin/Celery processes before | |
| 28 | upgrading! | |
| 29 | ||
| 30 | ||
| 31 | Upgrade (already on Python 3) | |
| 32 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| 33 | ||
| 34 | 1. Update to the latest release. In your ``mediagoblin`` directory, run: | |
| 35 | ``git fetch && git checkout -q v0.10.0 && git submodule update`` | |
| 36 | 2. Remove your existing installation: | |
| 37 | ``rm -rf bin include lib lib64 node_modules`` | |
| 38 | 3. Install MediaGoblin: | |
| 39 | ``./bootstrap.sh && ./configure && make`` | |
| 40 | 4. Update the database: | |
| 41 | ``./bin/gmg dbupdate`` | |
| 42 | 5. Restart MediaGoblin | |
| 43 | ||
| 44 | ||
| 45 | Upgrade (upgrading to Python 3) | |
| 46 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| 47 | ||
| 48 | 1. Refer to the "Dependences" and "Configure PostgreSQL" sections of | |
| 49 | ":doc:`deploying`" to install the necessary Python 3 dependencies. | |
| 50 | 2. Update to the latest release. In your ``mediagoblin`` directory, run: | |
| 51 | ``git fetch && git checkout -q stable && git submodule update`` | |
| 52 | 3. Remove your existing installation: | |
| 53 | ``rm -rf bin include lib lib64 node_modules`` | |
| 54 | 4. Install MediaGoblin: | |
| 55 | ``./bootstrap.sh && ./configure && make`` | |
| 56 | 5. Update the database: | |
| 57 | ``./bin/gmg dbupdate`` | |
| 58 | 6. Restart MediaGoblin | |
| 59 | ||
| 60 | ||
| 61 | Upgrade (remaining on Python 2 - not recommended) | |
| 62 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| 63 | ||
| 64 | 1. Update to the latest release. In your ``mediagoblin`` directory, run: | |
| 65 | ``git fetch && git checkout -q stable && git submodule update`` | |
| 66 | 2. Remove your existing installation: | |
| 67 | ``rm -rf bin include lib lib64 node_modules`` | |
| 68 | 3. Install MediaGoblin: | |
| 69 | ``./bootstrap.sh && ./configure --without-python3 && make`` | |
| 70 | 4. Update the database: | |
| 71 | ``./bin/gmg dbupdate`` | |
| 72 | 5. Restart MediaGoblin | |
| 73 | ||
| 74 | ||
| 75 | Updating your system Python | |
| 76 | --------------------------- | |
| 77 | ||
| 78 | Upgrading your operating system or installing a new version of | |
| 79 | Python may break MediaGoblin. This typically occurs because Python virtual | |
| 80 | environment is referring to a copy of Python that no longer exists. To fix this: | |
| 81 | ||
| 82 | 1. In your ``mediagoblin`` directory, remove your existing installation: | |
| 83 | ``rm -rf bin include lib lib64 node_modules`` | |
| 84 | 2. Install MediaGoblin: | |
| 85 | ``./bootstrap.sh && ./configure && make`` | |
| 86 | 3. Update the database: | |
| 87 | ``./bin/gmg dbupdate`` | |
| 88 | 4. Restart MediaGoblin |