Notes sur l'installation de MoinMoin sur wiki.auf.org

Machine hôte : Debian Etch (VZ), apache2 + mod_wsgi.

Procédure suivie pour l'installation

• installation de python, python-dev

• installation de MoinMoin (dernière version) avec : python setup.py install --prefix='/usr/local' --record=install.log :

  • /usr/local/bin/moin : lanceur (note : il faut y modifier le sys.path)

  • /usr/local/lib/python2.4/site-packages/MoinMoin : le programme lui-même

  • /usr/local/share/moin/ : données et configs

• tournera en mode WSGI (mod_wsgi de apache, depuis backports) :

  • cp /usr/local/share/moin/server/moin.wsgi /etc/moinmoin/

  • activation dans Apache :

     # mod_wsgi (http://code.google.com/p/modwsgi/)
     WSGIScriptAlias /wikiteki /etc/moinmoin/moin.wsgi
     Alias /static/wikitekibeta /var/www/wikitekibeta

• création du répertoire /etc/moinmoin pour nos configs

  • donc ajouter/modifier la ligne sys.path.insert(0, '/etc/moinmoin') dans /usr/local/bin/moin et /etc/moinmoin/moin.wsgi

• configuration en mode "Ferme de Wiki" (farmconfig.py)

• activation de tout ce qui est RSS en installant python-4suite (rien d'autre à faire, MoinMoin détecte tout seul la présence de cette possibilité)

• petite adaptation du thème Gugiel (et avant : sinorca4moin)

Procédure d'upgrade de Moinmoin (changement de version)

1. sauvegarde de la version courante, c-a-d des répertoires :

   • /usr/local/share/moin et /usr/local/lib/python*/ (ou plus généralement /usr/local) : le logiciel

   • /var/lib/moinmoin/ : les données

   • /etc/moinmoin : la configuration

2. installation de la nouvelle version :

   # cd /usr/src/moin-X.Y.Z
   # python setup.py install --prefix='/usr/local' --record=install.log

3. après l'installation :

   1. faire un sys.path.insert dans /etc/moinmoin/moin.wsgi et /usr/local/bin/moin (indiquer sys.path.insert(0, '/etc/moinmoin'))

   2. remplacer l'ancien htdocs par celui de la nouvelle version (/usr/src/moin-X.Y.Z/wiki/htdocs -> /usr/local/share/moin/)

4. (éventuellement, si modification de syntaxe : moin migration data --help)

5. puis relancer apache

6. s'assurer qu'on est à la bonne version : https://wiki.auf.org/wikiteki?action=test

7. faire quelques tests (gestion des acl surtout)

NB : le système d'upgrade de MoinMoin étant TRÈS tatillon, il vaut mieux, pour patcher un truc, mettre le fichier patché dans /etc/moinmoin ou tout autre répertoire. Ne pas toucher aux sources fournies, sinon l'upgradeur ne les mets pas à jour. Le nouveau système risque, alors, d'être buggé.

Corrections par rapport à 1.8.1

• Fix AttachFile XSS issues (mis en place le 30 janvier 2009)

• Fix other AttachFile XSS issues (mis en place le 30 janvier 2009)

• Fix antispam XSS issue (mis en place le 30 janvier 2009)