= Environment =

 * Debian GNU/Linux but should work for every Linux distribution. 
 * Apache 2.2 with CGI
 * Python 2.4

The following three directory paths are important:
 * <path-to-libs>, for me with Python 2.4 is {{{/usr/lib/python2.4/site-packages/MoinMoin}}}. Here are located the MoinMoin code
 * <path-to-share>, generally {{{/usr/share/moin}}}
 * <path-to-instance>, in my case is {{{/var/www/wiki-instance}}}. It the most important path because it contains all your data.

= Backup =

First of all, you want to be sure you have a backup of all your data. To be sure we can easily restore and go back to the previous situation with a working MoinMoin 1.5, I suggest to not only backup <path-to-instance> but also <path-to-libs> and <path-to-share>.
{{{
# cd /opt
# mkdir backup-wiki
# cd backup-wiki
# tar cvzf _libs_MoinMoin1.5.tgz <path-to-libs>
# tar cvzf _share_MoinMoin1.5.tgz <path-to-share>
# tar cvzf _data_MoinMoin1.5.tgz <path-to-instance>
}}}

= Purge =

To be sure that no conflict or problem araise, we will erase all the MoinMoin 1.5 installed files.
{{{
# rm -fr <path-to-libs> <path-to-share>
}}}

{i} this step is probably not necesary, but I got some problems when I migrate, and there seems to be related to a bad copy, so purging solved them

= MoinMoin 1.6 installation =

== Files ==

Now, we will install the files from the new version. After downloading and decompressing of the archive, go to its directory and run
{{{
# python setup.py install --record=../install-1.6.x.log
}}}
The file {{{../install-1.6.x.log}}} will contain the list of files which where copied during the installation

== Web server ==

Now, you must update your {{{moin.cgi}}} (or equivalent) of your instance
{{{
# cd <path-to-instance>
# cd cgi-bin
# cp <path-to-share>/server/moin.cgi .
}}}

And edit it to fit to your configuration. In general, you just have to change this line
{{{ 
sys.path.insert(0, '<path-to-instance>')
}}}

You also need to edit your Apache configuration to have something like this 
{{{
Alias /moin_static16X/ <path-to-share>/htdocs/           
ScriptAlias /mywiki <path-to-instance>/cgi-bin/moin.cgi
}}}
Change /moin_static16X/ to fit the 1.6.X version of MoinMoin you use.

''If you want you can also have your MoinMoin engine installed in the root of you domain, check HelpOnConfiguration/ApacheVoodoo''

== Updating system pages ==

Under <path-to-instance>/underlay directory are stored the default MoinMoin pages. Now that MoinMoin 1.6 files are installed, you must update this directory.
{{{
# cd <path-to-instance>
# cp -R <path-to-share>/underlay .
}}}

== Updating your instance configuration ==

I'm not sure if the <path-to-instance>/wikiconfig.py needs or not to be updated. On my server, I preferred to install the new version and then update it to fit my configuration
{{{
# cp <path-to-share>/config/wikiconfig.py .
}}}

== Migrate the data ==

The most crucial (and critical) part is the migration of your data. This is based on a set of scripts which convert your 1.5.X data to 1.6.X.
{{{
# su www-data
$ cd <path-to-instance>
$ moin --config-dir=<path-to-instance> --wiki-url=wiki.domain.tld migration data
}}}

You'll get an output similar to
{{{
Calling migration script for <path-to-instance>/data, base revision 1050700
Returned. New rev is 1050800.
Calling migration script for <path-to-instance>/data, base revision 1050800
Returned. New rev is 1059999.
Calling migration script for <path-to-instance>/data, base revision 1059999
You must first edit <path-to-instance>/data/rename1.txt.
For editing it, please use an editor that is able to edit UTF-8 encoded files.
Carefully edit - the fields are separated by a | char, do not change this!
Entries in this file look like:
PAGE OLDPAGENAME NEWPAGENAME
FILE OLDPAGENAME OLDFILENAME NEWFILENAME
You may ONLY edit the rightmost field (the new name - in case you want to rename
 the page or file).

After you have finished editing, rename the file to <path-to-instance>/data/rename2.txt and re-issue the moin migrate command.
Final mig script reached, migration is complete.
}}}

As MoinMoin 1.6 distinguish between spaces (" ") and underscores ("_") in page names, the migration lets you the possibility to rename some pages. To do it, just edit the file {{{<path-to-instance>/data/rename1.txt}}} to fix page or attachments names.[[BR]]
When it's ok, just rename this file to {{{rename2.txt}}} and relaunch the previous command.

== Finish the migration ==

Normally, the migration is now complete and you just have to do some things:
 * reinstall your language pack if necesary, visit the SystemPagesSetup on your Wiki as superuser to do it
 * reinstall all the macros, parsers, formatters, etc. you had in the previous version. Visit MoinMoinExtensions
 * maybe fix the text of some pages which was not handled by the migration script (e.g. if you use the Frame parser)