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)
- 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
- installation de la nouvelle version :
# cd /usr/src/moin-X.Y.Z # python setup.py install --prefix='/usr/local' --record=install.log
- après l'installation :
faire un sys.path.insert dans /etc/moinmoin/moin.wsgi et /usr/local/bin/moin (indiquer sys.path.insert(0, '/etc/moinmoin'))
remplacer l'ancien htdocs par celui de la nouvelle version (/usr/src/moin-X.Y.Z/wiki/htdocs -> /usr/local/share/moin/)
(éventuellement, si modification de syntaxe : moin migration data --help)
- puis relancer apache
s'assurer qu'on est à la bonne version : https://wiki.auf.org/wikiteki?action=test
- 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é.