> HelpOnUpdating

The following 656 words could not be found in the dictionary of 159 words (including 159 LocalSpellingWords) and are highlighted below:

2f   Abandoned   about   above   action   actions   activate   activated   active   adapt   Adapting   add   added   adding   additional   Administration   advisable   after   After   against   Agents   Aktuelle   alias   all   allow   allowed   Allows   already   also   an   Anchor   and   any   applet   applies   applying   archive   are   areas   around   as   As   assign   at   Attach   Aufgegebene   automatically   available   Backup   backup   bar   basename   bash   basic   Be   be   because   been   before   Before   behind   Benutzer   best   better   between   bin   border   Box   brackets   broken   browser   browsers   Browsers   bugs   but   by   c4nderungen   caching   called   calls   can   case   Category   category   cause   cgi   change   changed   Changes   changes   changing   Check   check   class   classic   cleanup   code   come   comes   command   common   compare   completely   compliant   config   configurable   configuration   Configuration   considered   contain   containing   content   Contents   continue   convert   Converting   cookie   copy   copying   correct   Counts   create   Creating   credits   css   current   Currently   customization   dangerous   data   default   defaults   defined   Delete   delete   denied   denies   deny   depend   Depending   Developers   dfe   diagnosis   dict   diff   dir   directories   directory   dirname   disable   disappear   display   distribution   distutils   Do   do   does   don   done   dot   Download   draw   drawing   drawings   Due   easier   echo   edit   Editor   effect   Einstellungen   either   email   empty   en   enable   enabled   Enabling   end   ending   ends   enhancements   entries   errors   especially   etc   even   Event   every   example   executable   existing   explicitely   extend   external   f6   fallback   faster   fault   favour   feature   features   feed   feeds   fi   File   file   filename   files   Finally   find   Find   Finden   first   fmt   follow   following   Foot   footer1   For   for   force   forget   Form   form   formats   found   fragments   Free   from   front   Front   Fs   future   General   German   Gesuchte   get   gets   gif   given   global   goal   good   Gr   group   Größe   Gs   has   have   head   header1   height   help   Help   higher   Hilfe   his   Hit   Home   Homepage   host   hosts   htdocs   html   I18   icon   iconbar   icons   idea   Ideally   if   If   Image   image   images   Images   img   implemented   in   included   indeed   Index   indexed   Info   information   init   install   Install   installation   installed   Installing   instance   instead   Instead   instructions   Inter   interested   interface   intermap   internal   interwikiname   into   invisible   issues   it   It   itself   jump   just   key   know   lang   language   last   later   layout   least   lib   license   lifetime   like   likely   links   Linux   list   loaded   loader   Local   localization   location   lock   locking   login   long   longer   look   Mac   macros   Magick   mail   main   mainly   make   maps   markup   master   Master   may   maybe   means   media   menu   merge   metadb   might   minimal   minutes   miss   modified   modify   moinmoin   moniker   more   Mozilla   much   must   name   Name   named   names   navi   Navigation   necessary   need   needed   Netscape   new   newer   newest   next   nice   no   None   normal   normally   Not   not   Note   now   Of   of   offically   offset   Often   often   old   On   on   once   one   ones   only   optional   options   or   Orphaned   our   output   over   own   packages   page   Page   pages   Pages   pagetitle   part   password   past   path   paths   per   permissions   pertaining   please   plugin   Plugins   png   point   points   Policy   policy   positive   precedence   Preferences   prefix   previously   prior   private   procedures   provide   provided   Ps   public   pwd   py   python   quite   Random   rather   rc   re   read   reason   reasoning   Recent   recommend   recommended   regarding   regex   release   remaining   removed   request   require   requires   root   rss   run   runs   Same   Sample   Sand   sane   saves   scheme   screen   searched   section   sections   secure   secured   Security   security   see   See   seed   Seite   Seiten   send   separated   server   set   setting   settings   setup   several   share   shared   should   simply   sitename   situation   Size   smarthost   smileys   so   Software   software   some   somewhat   space   specfic   specific   Spelling   spot   standards   Start   start   statistics   Stats   step   still   string   strongly   Structured   stuff   subclass   subnet   Subscribe   support   supported   sure   system   System   table   Table   take   takes   Template   template   test   Text   text   that   The   the   them   theme   Themeing   themename   themes   then   Then   There   there   these   they   this   This   those   tightly   time   timeout   Titel   Title   title   title1   to   To   trees   Troubleshooting   true   tuple   Twikidrawplugin   two   txt   type   tz   umask   under   unless   unsafe   until   up   update   updates   Updating   updating   Upgrade   upgrade   upgrades   upgrading   Upgrading   use   used   user   User   username   users   using   usr   usual   value   values   variables   Version   version   versions   Verwaiste   very   visible   visitors   want   Wanted   warn   warned   was   wasn   We   we   Web   web   webserver   Weg   Weiser   were   what   When   when   whether   which   while   whole   width   Wiki   wiki   wikiname   wikis   will   Windows   with   won   Word   Words   work   works   world   Wort   Xslt   You   you   your   Zufalls   Änderungen  

Clear message

HelpContents > HelpOnAdministration > HelpOnUpdating


  1. General procedures
    1. Backup
    2. Install
    3. Configuration update
    4. Updating files
    5. Troubleshooting
  2. Upgrade information for specfic versions
    1. Version 0.11
    2. Version 1.0
    3. Version 1.1
    4. Version 1.2

General procedures


/!\ Before you update an existing wiki, MAKE A BACKUP!

You have been warned, and it's not our fault when you end up like this: X-(

There are two directory trees which you should backup:

The paths depend on your installation.


Download the MoinMoin code that you are interested in updating to.

As root, run "python setup.py install" to install the new version.

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). Check that this is indeed the case, and then take the time to check the CHANGES file in your distribution. Often, new features will be invisible unless your extend your configuration in "moin_config.py".

This is especially true for:

Updating files


On every update, you should copy the content of the "share/moin/htdocs/img" directory to the image directory visible to your web server, normally a new release has some new images in it. If you use the default distutils setup scheme, this is no longer necessary (distutils updates the files for you, and your webserver gets the files from the installed images).

System pages

When upgrading to a new version, copy at least the help pages ("Help*") to your existing directory. Then check whether you miss any new system pages.


Check that you have the newest "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).


A good idea is to do a request for "moin.cgi?test" (which calls an internal diagnosis feature) after you installed a new release, which will spot some common errors.

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 755.

Upgrade information for specfic versions

The following sections provide information pertaining to specific versions of the software; if you jump several versions, read all the sections applying to your situation.

Version 0.11

(!) It is strongly recommended that you change any installation prior to 0.11 to the new distutils scheme, this will make any future upgrades much easier.

You should follow the instructions on ?HelpOnInstalling regarding basic installation, until you come to the "Creating a wiki instance" step. Then you have two options:

  1. simply adapt your old instance to the new situation, this especially means to create an alias that points to the .../share/moin/htdocs directory; you have to change url_prefix to /wiki then. The positive effect is that you automatically get any new icons and CSS files of version 0.11 and any future version, because distutils will update them in that location.

  2. create a new instance as per the instructions, copy the data directory from your old instance, and merge the configuration files.

Check your configuration against the provided default moin_config.py that you find in .../share/moin/cgi-bin/moin_config.py after installation with distutils. You should add the sitename setting, which gets added to the page title, to RSS feeds and the like.

When you are offically a part of the InterWiki system, then also add interwikiname, which should contain your own InterWiki moniker (for example "MoinMoin" for the MoinMoin wiki itself).

To get new icons, and also to allow I18N customization of the menu and icon links, you should either delete or adapt1 your settings for page_icons and navi_bar. Note that the new navi_bar default setting gets the wiki's name from the new sitename setting, which previously was the main reason to have your own modified navi_bar.

Due to I18N support for system pages, the only remaining configurable page name is that of the front page, which can be set by page_front_page (the old name front_page for that setting is also no longer supported); the reasoning behind this is that page name customization was mainly added and used for localization issues, while changing the front page name is rather common, often the front page is named like the whole wiki.

Finally, copy any new system pages to your wiki data directory. The current system pages are in the directory .../share/moin/data/text. The minimal set to copy is the new help pages ("Help*"). If you are sure you have not modified any system pages, you can simply copy all of them to your instance data/text directory.

/!\ When copying all system pages with one command, be sure to delete pages from the following list of pages that are likely changed by your users.

The following pages are very likely to change once a wiki is in use, and it is advisable to delete them from the master system page directory .../share/moin/data/text before any instance update; they are only included to seed new wikis:
The recommended set is in the following list:
If you want to do German visitors a favour, also copy the new German system and help pages, they will be automatically activated as long as you use the default page_icons and navi_bar settings:
AktuelleÄnderungen (Aktuelle_c4nderungen)
SeitenGröße (SeitenGr_f6_dfe)

Version 1.0

Version 1.0 is the last to support Python 1.5.2, but some optional features (like statistics) already require Python 2.0.

Version 1.1

Be sure to read the above section on General procedures before you start upgrading.

Version 1.1 requires Python 2.0 or higher, we recommend to use Python 2.2 (version 2.2.2 if that is available on your host) or even better 2.3.2 (with 2.3.x, MoinMoin runs about 20-30% faster).

The next version (1.2) will require Python 2.2.2 or newer.

Upgrading your configuration

Enabling new features

Version 1.2

Version 1.2 requires Python 2.2 or higher, we recommend to use Python >=2.3.2 (with 2.3.x, MoinMoin runs about 20-30% faster) or >= 2.2.2.