1 .. MediaGoblin Documentation
3 Written in 2012 by MediaGoblin contributors
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
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/>.
18 This chapter has important information for releases in it.
19 If you're upgrading from a previous release, please read it
20 carefully, or at least skim over it.
26 **Do this to upgrade**
28 1. Make sure to run ``bin/gmg dbuptdate`` after upgrading.
30 2. If you set up your server config with an older version of
31 mediagoblin and the mediagoblin docs, it's possible you don't
32 have the "theme static files" alias, so double check to make
33 sure that section is there if you are having problems.
41 MediaGoblin now also includes theming support, which you can
42 read about in the section :ref:`theming-chapter`.
46 MediaGoblin has a flatpages plugin allowing you to add pages that
47 are aren't media-related like "About this site...", "Terms of
50 See :ref:`core-plugin-section` for plugin documentation
54 We bundle the optional plugin trim_whitespace which reduces the size
55 of the delivered html output by reducing redundant whitespace.
57 See :ref:`core-plugin-section` for plugin documentation
62 This release has one important change. You need to act when
63 upgrading from a previous version!
65 This release changes the database system from MongoDB to
66 SQL(alchemy). If you want to setup a fresh instance, just
67 follow the instructions in the deployment chapter. If on
68 the other hand you want to continue to use one instance,
71 To convert your data from MongoDB to SQL(alchemy), you need
72 to follow these steps:
74 1. Make sure your MongoDB is still running and has your
75 data, it's needed for the conversion.
77 2. Configure the ``sql_engine`` URI in the config to represent
78 your target database (see: :ref:`deploying-chapter`)
80 3. You need an empty database.
82 4. Then run the following command::
84 bin/gmg [-cf mediagoblin_config.ini] convert_mongo_to_sql
86 5. Start your server and investigate.