The Road to 1.8

Upgrading from MoinMoin 1.7.x to 1.8.x

This is a Cliffs Notes version of upgrading. While this will [probably] be complete enough to get you upgraded, you should always read the CHANGES file in the Moin directory.

(see also: Upgrading from 1.6 to 1.7 and Upgrading from 1.5 to 1.6 instructions. I would advise you to apply the updates sequentially.)



Upgrading

If you successfully survived the 1.5 to 1.6 upgrade, you'll be happy to know that upgrading to 1.7 and 1.8 is a relative piece of cake! Only a few configuration changes need to happen.

  1. Modify your farmconfig.py/wikiconfig.py file:

    • url_prefix is now removed and will be ignored. You should comment it out or remove it so you won't confuse yourself later. If you want to define your own static directory, change this to url_prefix_static. Otherwise, simply add to your httpd.conf file:

      alias     /moin_static180/   "D:/Python25/share/moin/htdocs/"
    • If your wiki is configured with authentication (for example, domain authentication), the authentication statement has changed again. In your wikiconfig.py file, find your previous auth statement and change it to:
          auth = [HTTPAuth(autocreate=True)]

    see HelpOnAuthentication for more information

  2. Modify FastCGI:

    • FastCGI has to be configured slightly differently for Windows than it does for Linux/Unix. Open the server_fastcgi.py file located in: D:\Python25\Lib\site-packages\MoinMoin\server\:

    • the server_fastcgi.py file has been updated to include an optional variable for the port number. For Windows, we need to set that variable. Locate line 50, and change the port = None to the port number you specify in your Apache httpd.conf file. Following the example in the instructions, line 50 should now read Port = 9001.



Notable New Features

  1. WikiConfig Macro:

    • 1.8 adds a new macro, which is extremely helpful in identifying old and/or out of date wiki configurations in your wikiconfig.py file. Simply create a new page and add the macro <<WikiConfig>> to it and save the page (in moinmoin-1.9 that's in SystemInfo page). Anything in italics is either unknown or a third-party variable. Note: third-party variables do not mean they're not valid, just that they're unknown by the default config.

  2. New 'modernized' theme

    • This is an updated version of the default 'modern' theme. To activate as default, you should add theme_default = 'modernized' to your wikiconfig.py file.

MoinMoin: RickVanderveer/UpgradingFromMoin17ToMoin18 (last edited 2010-01-24 20:25:39 by FranklinPiat)