welcome: please sign in

The following 339 words could not be found in the dictionary of 7 words (including 7 LocalSpellingWords) and are highlighted below:
able   absolute   access   adaptor   adequate   Administration   After   after   all   also   an   and   any   archive   are   as   As   assign   at   avoid   backup   Backup   be   because   been   Before   before   better   break   bugs   But   but   by   cache   can   careful   carefully   case   cause   cgi   change   changed   changes   Check   check   code   Code   compatibility   complete   config   Configuration   configuration   contain   contained   containing   content   Contents   continue   convert   copy   correctly   data   default   defaults   delete   depend   Depending   details   developer   dir   directory   distribution   distributor   do   docs   don   done   Download   easier   easy   edit   editing   either   end   enough   entries   environment   errors   even   every   existing   expect   extend   farmconfig   faster   fault   fcg   features   file   files   find   First   fix   fixes   for   fresh   from   General   get   global   goal   good   group   has   have   having   help   Help   here   hints   homepage   hope   how   htdocs   idea   Ideally   if   If   images   import   in   including   indeed   indent   Index   install   installation   installing   interested   interfering   intermap   invisible   is   it   Javascript   just   Just   latest   least   less   lib   lifetime   like   likely   Linux   load   loaded   log   logging   long   look   losing   Make   make   many   match   maybe   might   migration   mode   more   move   must   necessary   need   needs   new   no   normally   not   now   Of   of   often   Often   old   On   on   once   one   ones   optionally   or   original   other   our   outdated   overwritten   own   package   packages   pages   path   pathes   paths   people   permissions   place   Please   please   point   precedence   prefix   private   procedures   process   project   provide   provided   py   pyc   pyo   python   read   Reading   real   relative   release   released   relying   remove   repeat   replacing   rollback   root   run   runs   sane   script   secured   security   see   See   separately   server   set   setting   setup   share   shared   should   shouldn   single   site   so   some   Some   spaces   specific   static   Static   static171   steps   stop   stored   stuff   sure   syntax   sys   System   Table   tabs   take   takes   than   that   The   the   their   then   there   they   This   this   tightly   time   to   too   traffic   Troubleshooting   txt   umask   under   underlay   unless   unpack   up   update   updating   Updating   upgrade   upgrades   upgrading   url   Use   use   user   using   usr   usually   valuable   values   version   very   visible   want   warned   we   web   what   When   when   which   wiki   Wiki   wikiconfig   wikiname   will   with   won   work   working   worst   write   wsgi   You   you   your   Your  

Clear message
Page Locked

HelpOnUpdating

HelpContents > HelpOnAdministration > HelpOnUpdating

Index

Contents

  1. General procedures
    1. Download and unpack the new MoinMoin archive
    2. Reading the docs
    3. Backup
    4. Code update
    5. Configuration update
    6. Static stuff update
    7. Wiki pages update
      1. System and Help pages
      2. Your valuable own pages
    8. Troubleshooting

1. General procedures

1.1. Download and unpack the new MoinMoin archive

Download the MoinMoin code that you are interested in updating to. If you are not a developer, this is usually the latest released version from the project homepage.

(!) Often it is better (and easy enough) to install latest release from distribution archive than relying on some outdated package provided by your Linux distribution. Some people use moin as a package, because they hope for easy upgrades and security fixes. But often, there are either no upgrades or they are not easy and in the worst case, there are not even security fixes.

1.2. Reading the docs

Please read the files docs/CHANGES and docs/README.migration contained in the moin distribution archive for details on what changed and how to upgrade.

/!\ The docs might contain import installation, compatibility and upgrade hints we won't repeat here.

1.3. Backup

/!\ 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-(

As you want to make a complete backup (not even losing a single edit), you want to stop your wiki server process now.

This is what you should backup (the real paths depend on your installation):

1.4. 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).

1.5. 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).

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

1.7. Wiki pages update

1.7.1. 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).

1.7.2. Your valuable own pages

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

1.8. Troubleshooting

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.