[Alice]

HelpOnInstalling/TroubleShooting

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

action   an   and   append   assume   bang   be   because   before   below   bin   both   Built   built   bundled   but   by   case   cd   chmod   come   command   commands   common   diagnostic   different   distribution   distributions   doing   Driver   Duelling   dump   encounter   engine   enter   environment   example   file   files   find   fix   following   for   get   hostname   if   If   import   In   in   includes   install   installed   interpreter   into   itself   just   lib   like   likely   Linux   ll   local   log   look   lynx   Make   might   missing   Missing   mode   module   modules   most   must   mywiki   needs   newer   of   old   only   or   out   packages   path   permissions   prefix   problem   prompt   python   Python   python2   Pythons   readable   recent   result   root   run   Script   server   setting   site   situation   still   sys   test   that   There   they   This   this   thus   to   To   typical   useful   using   usr   usually   version   we   web   webserver   when   where   will   with   within   work   works   world   write   wrong   you   your  

Clear message

Built-in test

There's a built-in diagnostic mode that's useful when doing an install; just append "?action=test" to the URL of your wiki:

lynx --dump http://`hostname`/mywiki?action=test

If you see an import error here, but "python -c "import MoinMoin"" works, it's likely a result of missing file permissions or a wrong PYTHONPATH setting within the web server environment.

Duelling Pythons

The most common problem you might encounter is when you have an old Python version installed into "/usr", and a newer Python distribution into "/usr/local"; this is typical for GNU/Linux distributions that still come bundled with an old Python version.

In that case, if you enter "python" on your prompt, you will usually get the more recent Python interpreter, because "/usr/local/bin" is in your PATH. The situation is different in your webserver environment, and thus you might have to change the bang path of "moin.cgi", like this:

#!/usr/local/bin/python

"""
    MoinMoin - CGI Driver Script
...
"""

Missing file permissions

If you are root, the installed files may be readable only by root, but they must also be readable by the web server before the wiki will work. This includes both the Python modules and the site itself. For the data directory, the wiki engine also needs write access. To fix this, first find out where the Python module directory is; look in install.log, or run the command:

python -c "import sys; print '%s/lib/python%s/site-packages' % ( sys.prefix, sys.version[:3] )"

For the example below, we'll assume that the Python module directory is /usr/local/lib/python2.3/site-packages. Make the files world-readable using the following commands:

cd /usr/local
chmod -R a+rX lib/python2.3/site-packages/MoinMoin