docs/source/siteadmin/relnotes.rst

   1 .. MediaGoblin Documentation
   2
   3    Written in 2012 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 Release Notes
  16 =============
  17
  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.
  21
  22
  23 0.3.1
  24 =====
  25
  26 As usual in this release you should be sure to run `bin/gmg dbupdate`
  27 to upgrade the database to the latest schema.  There are not major
  28 changes other than this that you need to do to make your present
  29 MediaGoblin instance continue to work.
  30
  31 However, MediaGoblin now also includes theming support, which you can
  32 read about in the section :ref:`_theming_chapter`.  If you set up your
  33 server config with an older version of mediagoblin and the mediagoblin
  34 docs, it's possible you don't have the "theme static files" alias, so
  35 double check to make sure that section is there if you are having
  36 problems.
  37
  38
  39 0.3.0
  40 =====
  41
  42 This release has one important change. You need to act when
  43 upgrading from a previous version!
  44
  45 This release changes the database system from MongoDB to
  46 SQL(alchemy). If you want to setup a fresh instance, just
  47 follow the instructions in the deployment chapter. If on
  48 the other hand you want to continue to use one instance,
  49 read on.
  50
  51 To convert your data from MongoDB to SQL(alchemy), you need
  52 to follow these steps:
  53
  54 1. Make sure your MongoDB is still running and has your
  55    data, it's needed for the conversion.
  56
  57 2. Configure the ``sql_engine`` URI in the config to represent
  58    your target database (see: :ref:`deploying-chapter`)
  59
  60 3. You need an empty database.
  61
  62 4. Then run the following command::
  63
  64        bin/gmg [-cf mediagoblin_config.ini] convert_mongo_to_sql
  65
  66 5. Start your server and investigate.
  67
  68 6. That's it.