The PEAK Developers' Center   HelpOnUpdating UserPreferences
HelpContents Search Diffs Info Edit Subscribe XML Print View
The following 410 words could not be found in the dictionary of 50 words (including 50 LocalSpellingWords) and are highlighted below:
2f   Abandoned   Adapting   Administration   After   Agents   Aktuelle   Anchor   Attach   Aufgegebene   Before   Benutzer   Box   Category   Changes   Check   Configuration   Contents   Counts   Creating   Currently   Delete   Depending   Due   Einstellungen   Event   File   Finally   Find   Finden   Foot   Front   Fs   General   Gesuchte   Gr   Größe   Help   Hilfe   Hit   Home   I18   Ideally   If   Images   Index   Installing   Inter   It   Language   Local   Name   Navigation   Note   Of   Often   On   Orphaned   Page   Pages   Preferences   Python   Python4   Random   Recent   Sand   Seite   Seiten   Site   Size   Spelling   Start   Stats   Structured   Subscribe   Suite   System   Table   Template   Text   The   Then   This   Titel   Title   To   Troubleshooting   Updating   Upgrade   User   Version   Verwaiste   Wanted   Web   Weg   Weiser   When   Word   Words   Wort   Xslt   You   Zufalls   actions   activate   activated   adapt   add   added   adding   admin   advisable   after   against   alias   all   allow   allowed   also   an   and   any   applying   are   as   assign   at   automatically   bar   basic   be   because   been   before   behind   best   bin   bugs   but   by   c4nderungen   calls   can   case   cgi   change   changed   changing   check   come   command   common   compare   config   configurable   configuration   considered   contain   content   continue   copy   copying   create   current   customization   dangerous   data   default   defaults   delete   dfe   diagnosis   dir   directory   distribution   do   easier   effect   either   end   entries   errors   especially   etc   every   example   existing   explicitely   extend   f6   fault   favour   feature   features   feeds   file   files   find   follow   following   for   found   from   front   future   get   gets   global   goal   good   has   have   help   htdocs   icon   icons   idea   if   image   images   img   in   include   included   indeed   information   installation   installed   instance   instructions   interactive   interface   intermap   internal   interwikiname   invisible   is   issues   it   itself   jump   just   least   like   likely   links   list   loaded   localization   location   long   longer   m707   macros   mail   main   mainly   make   master   means   menu   merge   minimal   miss   mkdir   modified   moniker   more   much   my   name   named   navi   necessary   need   new   newest   next   no   normally   not   now   of   offically   often   old   on   once   one   only   options   or   over   own   page   pages   part   past   per   permissions   pertaining   point   points   positive   precedence   prefix   previously   prior   private   procedures   provide   provided   public   rather   re   read   reason   reasoning   recommended   regarding   release   remaining   request   result   runs   sane   scheme   sections   secured   seed   server   set   setting   settings   setup   several   share   shared   should   simply   sitename   situation   smarthost   software   some   somewhat   specfic   specific   spot   starting   step   strongly   support   supported   sure   system   take   takes   test   text   that   the   them   then   there   they   this   those   tightly   time   title   to   true   two   under   unless   unsafe   until   up   update   updates   upgrades   upgrading   use   used   user   users   values   version   versions   very   visible   visitors   want   warned   was   web   webserver   when   whether   which   while   whole   will   with   won   work   you   your   Änderungen  

Clear message

HelpContents > HelpOnAdministration > HelpOnUpdating


  1. General procedures
    1. Configuration update
    2. Updating files
    3. Troubleshooting
  2. Upgrade information for specfic versions
    1. Version 0.11

1 General procedures

/!\ Before you update an existing wiki, MAKE A BACKUP! You have been warned, and it's not my fault when you end up like this... @)

1.1 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 "".

This is especially true for:

1.2 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 GIFs 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 entries in the "intermap.txt" file; if you have "private" entries, add them to the distribution file, then copy the result over your current file. Note that starting with version 0.11, 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).

1.3 Troubleshooting

To make UserPreferences work, you should "mkdir -m707 user" in your "data" directory. 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.

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

2.1 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 that you find in .../share/moin/cgi-bin/ 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) 

The next version will include an admin interface that will allow interactive upgrades.

   1 Adapting means to compare your settings and the default values found in the MoinMoin/ file.

EditText of this page (last modified 2002-12-12 16:06:09)
FindPage by browsing, title search , text search or an index
Or try one of these actions: AttachFile, DeletePage, LikePages, LocalSiteMap, SpellCheck