optionally you can also backup your underlay_data_dir (it shouldn't contain data from you, but it is maybe easier to rollback if you have a backup of it and don't need to get it from some other place)

Code update

First remove the old MoinMoin code (including any *.pyc and *.pyo files).

If you are installing from the original distribution archive, run "python setup.py install" as root to install the new version.

If you are using some Linux (or other) distributor's package, please read their docs.

Please also upgrade your moin.cgi (or moin.wsgi or other) server adaptor file. You likely have to edit it to fix some pathes and you also need to set some specific user/group/mode on that file (just look at the old one before replacing it).

Configuration update

After upgrading, your existing wiki should continue to work (the goal is to have sane defaults for any new config values, but then there can be bugs and also changes that must break compatibility).

Check that this is indeed the case, and then take the time to check the CHANGES file in your distribution archive. Often, new features will be invisible unless you extend your configuration in wikiconfig.py.

Check that you have the latest "intermap.txt" file; If you have your own entries, you can point "shared_intermap" at a file loaded before the file in your data directory, which takes precedence (i.e. have global entries in the shared one, private entries the data dir file).

Static stuff update

On every update, you should copy the content of the "wiki/htdocs/" directory we provide to the directory visible to your web server, normally a new release has some new images, CSS and Javascript in it.

You also have to change your web server / directory setup to match the url_prefix_static setting of moin. This defaults to /moin_staticVVV (VVV is 170 for moin release 1.7.0) and the default will change on every release (moin 1.7.1 will use /moin_static171 by default). This is done to be able to use a very long cache lifetime for the static stuff, so your wiki will be faster and cause less load and traffic.

Wiki pages update

System and Help pages

System and help pages are separately stored in the underlay directory. Just use the fresh underlay directory we provide in the distribution archive (move the old one to your backup directory).

If you previously modified some system page in your wiki (see EditedSystemPages on your wiki), you might want to Delete them to use moinmoin's updated version (warning: you can't un-delete that page later).

InterWiki data

Copy intermap.txt from the distribution archive into your wiki data

Your valuable own pages

See CHANGES and README.migration for maybe necessary steps to convert your data_dir to what we expect.

Clean your cache

Finally, delete cached data by running moin ... maint cleancache. This is necessary for things like the updated InterWiki data to trickle down into the pages that use it.

Troubleshooting

Hints:

Use absolute pathes, not relative ones.

Make sure you have an adequate logging configuration (see server adaptor script and the logging configuration file) and carefully read the log!

Make sure python can find the MoinMoin code package and your wiki configuration files (fix sys.path in the server adaptor script or PYTHONPATH in the environment).

Make sure MoinMoin can find the data_dir and data_underlay_dir (see wikiconfig.py).

When you are editing python code files (e.g. wikiconfig.py), be careful to indent correctly (use 4 spaces, not tabs) and also be careful not to make syntax errors. If you have a working config, do not make too many changes at once (and have a backup of a working version).

Check permissions (the moin process needs read/write access to data_dir and data_underlay_dir, it needs at least read access to the MoinMoin code and configuration).

Depending on your installation, more tightly secured permissions are a good idea. Ideally, you assign all files in the data directory to the user the web server runs under, and then you use 700 or 770 - see also the config.umask setting.