Update MoinMoin from 1.9.5 to 1.9.7

This is the general steps for updating moinmoin from 1.9.5 to 1.9.7

1. Stop web server or standalone process
2. backup wiki instance (eg. mywiki or instance1)
3. backup moinmoin installation path
4. if there is customized logo, backup it as well (eg. moinmoin.png)
5. delete *.pyc or *.pyo
   find  -name *.pyc -exec rm {} \; 
6. download moinoin1.9.7 and install to existing path
   python setup.py install --prefix 
7. replace moinmoin.png if necessary
8. if using web server, remember to change the static path from "/moin_static195" to "/moin_static197"
9. start web server or standalone process
10. double check the version by http:///SystemInfo

Create a Wiki (Moinmoin) on Raspberry

Moinmoin is a very good Wiki application without using a DB. It is very fast, with easy syntax and I recommend to use it as a quick knowledge base for home or SME usage.

 This guide is to install moinmoin on a Raspberry Pi and make it accessible via Lighttpd (using fastcgi). It is assumed a virtual host is available for this wiki (eg. http://wiki.example.com )

The moinmoin program will be installed at /usr/local/moinmoin_engine while the instance will be installed at another place (eg. /usr/local/moinmoin_instance1. )

1. Download the latest source (1.9.5 as of this moment) at http://moinmo.in
2. extract the tar ball to a temp place (eg. /tmp)
3. under the source path, run

   python setup.py install --prefix=/usr/local/moinmoin_engine

4. mkdir the instance path

   mkdir /usr/local/moinmoin_instance1

5. copy the following directories from "engine" to "instance", and change the ownership to the lighttpd user:

   cp -r /usr/local/moinmoin_engine/share/moin/data /usr/local/moinmoin_instance1
   cp -r /usr/local/moinmoin_engine/share/moin/underlay /usr/local/moinmoin_instance1
   cp /usr/local/moinmoin_engine/share/moin/config/wikiconfig.py /usr/local/moinmoin_instance1
   cp /usr/local/moinmoin_engine/share/moin/server/moin.fcgi /usr/local/moinmoin_instance1
   chown -R www-data:www-data /usr/local/moinmoin_instance1

6. modify the moin.fcgi, locate the following lines:

   # a1) Path of the directory where the MoinMoin code package is located.
   #     Needed if you installed with --prefix=PREFIX or you didn't use setup.py.
   #sys.path.insert(0, 'PREFIX/lib/python2.3/site-packages')
   sys.path.insert(0, '/usr/local/moinmoin_engine/lib/python2.7/site-packages')
   
   # a2) Path of the directory where wikiconfig.py / farmconfig.py is located.
   #     See wiki/config/... for some sample config files.
   #sys.path.insert(0, '/path/to/wikiconfigdir')
   sys.path.insert(0, '/usr/local/moinmoin_instance1')
   
   ...
   
   ## this works around a bug in flup's CGI autodetection (as of flup 1.0.1):
   #os.environ['FCGI_FORCE_CGI'] = 'Y' # 'Y' for (slow) CGI, 'N' for FCGI
   os.environ['FCGI_FORCE_CGI'] = 'N'
   
   ...
   
   # Is fixing the script name needed?
   # Use None if your url looks like http://domain/wiki/moin.fcgi
   # Use '' if you use rewriting to run at http://domain/
   # Use '/mywiki' if you use rewriting to run at http://domain/mywiki/
   #fix_script_name = None  # <-- adapt="adapt" as="as" class="anchor" here="here" id="line-24" needed="needed" span="span">

fix_script_name = ''# <-- adapt="adapt" as="as" here="here" needed="needed" pre="pre">

Next prepare virtual host by appending the following block /etc/lighttpd/lighttpd.conf:

$HTTP["host"] =~ "wiki\.example\.com" {
        
  fastcgi.server += ( "/" =>
      ((
        "socket" => "/tmp/moin.socket",
        "min-procs" => 1,
        "max-procs" => 2,
        "check-local" => "disable",
        "bin-path" => "/usr/local/moinmoin_instance1/moin.fcgi",
        "fix-root-scriptname" => "enable"
      ))
  )

  alias.url += ( "/moin_static195" => "/usr/local/moinmoin_engine/lib/python2.7/site-packages/MoinMoin/web/static/htdocs")

}

Restart Lighttpd and the your own wiki is just born! 

For more information about user and administration guide, please refer the HelpContents.

PS: So here is the wiki running on my Raspberry Pi: http://wiki.jessed121.us/ . You can walk around and feel it.