= 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 [[http://moinmo.in/ThemeMarket/Gugiel|Gugiel]] (et avant : [[http://moinmo.in/ThemeMarket/sinorca4moin|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
 1. installation de la nouvelle version :
 {{{
# cd /usr/src/moin-X.Y.Z
# python setup.py install --prefix='/usr/local' --record=install.log
}}}
 1. après l'installation :
  a. faire un `sys.path.insert` dans `/etc/moinmoin/moin.wsgi` et `/usr/local/bin/moin` (indiquer `sys.path.insert(0, '/etc/moinmoin')`)
  a. remplacer l'ancien `htdocs` par celui de la nouvelle version (`/usr/src/moin-X.Y.Z/wiki/htdocs` -> `/usr/local/share/moin/`)
 1. (éventuellement, si modification de syntaxe : `moin migration data --help`)
 1. puis relancer apache
 1. s'assurer qu'on est à la bonne version : `https://wiki.auf.org/wikiteki?action=test`
   . `action=test` ne marche plus, utiliser plutôt `https://wiki.auf.org/wikiteki/SystemInfo`
 1. 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 ==
 * [[http://hg.moinmo.in/moin/1.8/rev/8cb4d34ccbc1 | Fix AttachFile XSS issues]] (mis en place le 30 janvier 2009)
 * [[http://hg.moinmo.in/moin/1.8/rev/5c4043e651b3 | Fix other AttachFile XSS issues]] (mis en place le 30 janvier 2009)
 * [[http://hg.moinmo.in/moin/1.8/rev/89b91bf87dad | Fix antispam XSS issue]] (mis en place le 30 janvier 2009)


== Notes pour la 1.9.4 ==

Il y a un bogue avec les TextCha qui empêche l'usage d'accents, cf https://moinmo.in/MoinMoinBugs/1.9.4BreaksTextChaWithAccents

Le correctif se trouve sur http://hg.moinmo.in/moin/1.9/rev/1ddf7d88c53d

Ce correctif a été appliqué à Montréal le 2015-07-10. (application du patch, puis `dpkg-reconfigure python-moinmoin` pour recompiler les modules Python, puis redémarrage du service `apache2`)