view docs/admin/upgrade.rst @ 2860:233d63abbdaf

reorder modernized blog.css rules to match basic blog.css sequence no code changes, rules remain unnecessarily inconsistent
author RogerHaase <haaserd@gmail.com>
date Tue, 02 Dec 2014 14:21:32 -0700
parents 6af6e61dc25f
children
line wrap: on
line source
=========
Upgrading
=========

.. note::
   Internally, moin2 is very different than moin 1.x.

   moin 2.0 is *not* just a +0.1 step from 1.9 (like 1.8 -> 1.9), but the
   change of the major version number is indicating *major and incompatible changes*.

   So please consider it to be different and incompatible software that tries
   to be compatible in some areas:

   * Server and wiki engine Configuration: expect to review/rewrite it
   * Wiki content: expect 90% compatibility for existing moin 1.9 content. The
     most commonly used simple moin wiki markup (like headlines, lists, bold,
     ...) will still work, but expect to change macros, parsers, action links,
     3rd party extensions, for example.

From moin < 1.9
===============
If you run an older moin version than 1.9, please first upgrade to a recent
moin 1.9.x version (preferably >= 1.9.7) before upgrading to moin2.
You may want to run that for a while to be sure everything is working as expected.

Note: Both moin 1.9.x and moin2 are WSGI applications.
Upgrading to 1.9 first also makes sense concerning the WSGI / server side.


From moin 1.9.x
===============

If you want to keep your user's password hashes and migrate them to moin2,
make sure you use moin >= 1.9.7 WITH enabled passlib support and that all
password hashes stored in user profiles are {PASSLIB} hashes. Other hashes
will get removed in the migration process and users will need to do password
recovery via email (or with admin help, if that does not work).


Backup
------
Have a backup of everything, so you can go back in case it doesn't do what
you expect. If you have a testing machine, it is a good idea to try it there
first and not directly modify your production machine.


Install moin2
-------------
Install and configure moin2, make it work, and start configuring it from
the moin2 sample config. Do *not* just use your 1.9 wikiconfig.


Adjusting the moin2 configuration
---------------------------------
It is essential that you adjust the wiki config before you import your 1.9
data:

Example configuration::

    from os.path import join
    from MoinMoin.storage import create_simple_mapping

    interwikiname = u'...' # critical, make sure it is same as in 1.9!
    sitename = u'...' # same as in 1.9
    item_root = u'...' # see page_front_page in 1.9

    # if you had a custom passlib_crypt_context in 1.9, put it here

    # configure backend and ACLs to use in future
    # TODO


Clean up your moin 1.9 data
---------------------------
It is a good idea to clean up your 1.9 data first, before trying to import
it into moin2. In doing so you can avoid quite some
warnings that the moin2 importer would produce.

You do this with moin *1.9*, using these commands::

  moin ... maint cleanpage
  moin ... maint cleancache

.. todo::
   add more info about handling of deleted pages


Importing your moin 1.9 data
----------------------------
Assuming you have no moin2 storage and no index created yet, include the
-s and -i options to create the storage and an index.

The import19 argument to the `moin` script will then read your 1.9 data_dir (pages, attachments and users),
convert the data as needed, and write it to your moin2 storage and also
build the index::

  moin import19 -s -i --data_dir /your/moin/1.9/data 1>import1.log 2>import2.log

If you use the command as given, it will write all output into two log files.
Please review them to find out whether the importer had critical issues with your
data.


Testing
-------
Start moin now, as it should have your data available.

Try "Index" and "History" views to see what is included.

Check whether your data is complete and working fine.

If you find issues with data migration from moin 1.9 to 2, please check the
moin2 issue tracker.


Keep your backups
-----------------
Make sure you keep all backups of your moin 1.9 installation, such as code, config,
data, just in case you are not happy with moin2 and need to revert to the old version.