Modifications entre les versions 36 et 37
Version 36 à la date du 2008-07-10 21:26:14
Taille: 6951
Éditeur: ThomasNoël
Commentaire:
Version 37 à la date du 2009-01-19 11:40:11
Taille: 3013
Éditeur: ThomasNoël
Commentaire: doc à jour
Texte supprimé. Texte ajouté.
Ligne 3: Ligne 3:
Machine hôte : Debian Etch (VZ)

 ||<#ffaa00> page à mettre à jour suite à migration vers vz et moinmoin 1.6 -- ThomasNoël||

 ||<#ffaa00> page à mettre VRAIMENT à jour suite à migration vers mod_wsgi -- ThomasNoël||
Machine hôte : Debian Etch (VZ), apache2 + mod_wsgi.
Ligne 10: Ligne 6:
Ligne 11: Ligne 8:
 * installation de MoinMoin (dernière version) avec `PREFIX=/usr/local`
 * configuration en mode "Ferme de Wiki" (`farmconfig.py`). Configuration dans `/etc/moinmoin` (dossier ajouté au `sys.path` au début de `moin.cgi`)
 * configuration de apache pour https://wiki.auf.org
 * 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é)
 * activation du mode FastCGI (déjà installé pour RT3... on factorise)
 * modification du certificat de www.auf.org pour ajouter wiki.auf.org et courriel.auf.org en SubjetAltName (cf /etc/apache/openssl.cnf)
 * ajout de quelques themes, pour voir (bof)

== Upgrade de Moinmoin (changement de version) ==

 1. faire une sauvegarde de la version courante (répertoires /usr/local/share/moin et /usr/local/lib/python2.3/ notamment)
 1. installation de la nouvelle version (`cd /usr/src/moin[N°-nouvelle-version] && sudo python setup.py --quiet install --prefix="/usr/local" --record=install.log`) après l'avoir téléchargée (http://moinmoin.wikiwikiweb.de/MoinMoinDownload) et désarchivée dans `/usr/src`
 1. après l'installation :
  a. modifier la variable `sys.path.insert` des fichiers `moin.fcg` et `moin.cgi` de la nouvelle version (dans `/usr/local/share/moin/server/` : `moin.cgi` et `moin.fcg`) :
  {{{# Path of the directory where wikiconfig.py is located.
# YOU NEED TO CHANGE THIS TO MATCH YOUR SETUP.
sys.path.insert(0, '/etc/moinmoin')
}}}
  a. remplacer l'ancien `htdocs` par la nouvelle version (`/usr/src/moin-[N°-nouvelle-version]/wiki/htdocs` --> `/usr/local/share/moin/`)
 2. puis relancer apache (#apachectl graceful)
 3. s'assurer qu'on est à la bonne version : `https://wiki.auf.org/wikiteki?action=test`

'''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é.

== A étudier ==
 * suppression de `python-dev` (a priori nécessaire uniquement
 * accélération ''mod_python'' ? mais Sarge ne contient que la "vieille" version... FastCGI a l'air de suffire ?


== Panne du 7 novembre suite à mise à jour en 1.5.6 ==

Je (ThomasNoël) n'arrive pas très bien à savoir ce qui c'est
passé (et j'ai pas envie de recommencer à jouer avec le feu).
 1. Moussa a mis à jour MoinMoin en 1.5.6 la veille au soir, mais sans faire le restart apache (et donc on était resté en 1.5.5a via FastCGI)
 1. Mardi 7 matin, j'ai fait un restart d'apache, mais ensuite j'ai juste été voir si ?action=test indiquait bien la version 1.5.6 : je n'ai pas essayé d'éditer de page
 1. Ensuite j'ai voulu optimiser un peu la configuration dans /etc/moinmoin (regrouper les choses dans farmwiki.py)
 1. Là j'ai testé...et toutes les pages étaient devenue "immuables" ! Aïe.
 1. J'ai alors remis l'ancienne conf, mais ça n'a rien changé : ça plantait toujours... Comme si les groupes n'étaient plus reconnus. Mais je ne sais donc pas si c'est l'upgrade ou ma manip qui a cassé le fait que MoinMoin ne reconnaissait plus la notion de "GroupeAUF".

Pour réparer, voici ce que j'ai du faire après plusieurs tentatives infructueuses :
 1. Puisque les "GroupeXXX" ne semblaient plus fonctionner, j'ai ajouter ThomasNoël en dur dans les ACL générale (au niveau de wikiteki.py)
 1. A partir de là, j'ai pu accéder au wiki avec les droits nécessaires partout.
 1. J'ai alors forcé la mise à jour des pages GroupeAUF, GroupeAdmin et GroupePartenaires (en écrivant des bétises dedans puis en les retirant)
 1. Ensuite j'ai supprimé mon accès ACL "ThomasNoël" et j'ai vérifié que les GroupeXXX étaient bien à nouveau pris en compte. Oui. Ouf.

Je pense que MoinMoin optimise la gestion des groupes : il ne va pas lire les pages GroupeXXX à chaque requête (!). Il doit tenir une table séparée quelque part.
Il faudra, au prochain upgrade, vérifier que c'est bien mes tentatives d'optimisations inutiles (sic) qui ont planté cette reconnaissance desgroupes, et non pas l'upgrade lui-même. Sinon il faudra étudier comment systématiser la prise en compte des groupes à chauqe upgrade (et signaler un bogue à MoinMoin - il est possible que ça marche pour
des GroupXXX (in english) et pas pour les versions traduites).

Désolé pour ce downtime...


= wiki2 =

 * moinmoin 1.6.x
 * test SANS apache, en mode natif : http://moinmo.in/HelpOnInstalling/StandaloneServer
 * installation sur Etch (vz 104, merci Moussa)
  * paquets installés : python-xml, python-xapian, python-dev (pour installation), apache2 + libapache2-mod-fcgid (pour mode fastcgi), catdoc+xpdf-utils (aide à xapian)
 * `python setup.py install --prefix='/usr/local' --record=install.log`, '''ok''' donne une installation dans :
  * `/usr/local/bin/moin` : lanceur
 * 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)
Ligne 73: Ligne 12:
 * mkdir /etc/moinmoin pour nos configs, et ajout de `sys.path.insert(0, '/etc/moinmoin')` dans /usr/local/bin/moin
 * abandon de la solution native (marche mal, exception Python dès que l'url a un soucis... bof), passage en mode FastCGI avec libapache2-mod-fcgid (fastcgi, le "vrai", étant non-free, je donne une chance à cette alternative)
 * migration du thème : ok, à ré-optimiser peut-être à l'occasion mais bon
 * en test: http://wiki2.auf.org/wikiteki (n'est pas sensé fonctionner pour l'instant, bourré le bogue, normal, pas la peine de me le dire ;) )
 * installation en https ok (merci Jérôme pour m'avoir éviter une seconde soirée humiliante !)
 * '''activation xapian''' : NON car apparement ça ne marche pas bien (fullsearch ne fonctionne plus, il y a des pages qui ne sont pas indexées, etc... enquete à suivre, peut-être sur des pages qui s'affichent mal ou "de travers" avec certaines macros, je sais pas encore)
 * tentative de passage à lighttpd (22 fév) : échec. `moin.fcgi` plante de temps en temps, provoquant des erreurs 500. Apparement le mod_fcgid d'apache2 sait beaucoup mieux gérer les plantages de process fastcgi...? Peut-être. Où alors bon.
 * 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é)
 * adaptation du thème [[http://moinmo.in/ThemeMarket/sinorca4moin|sinorca4moin]]
 * ''note'' : moteur de recherche Xapian installé, mais ne fonctionne pas. A revoir (paquets `python-xapian` et `catdoc+xpdf-utils`)
Ligne 81: Ligne 27:
Plus tard :
 * activer xapian correctement (pourquoi ça ne passe pas ?... idem que http://moinmo.in/MoinMoinBugs/1.6currBrowser )
 * tuning fastcgi
 * xmlrpc : on peut faire quoi en vrai
 * syntaxe créole ?
== Procédure d'upgrade de Moinmoin (changement de version) ==

 1. sauvegarde de la version courante (répertoires /usr/local/share/moin et /usr/local/lib/python*/ notamment)
 1. sauvegarde des données : /var/lib/moinmoin/
 1. installation de la nouvelle version :
 {{{
# cd /usr/src/moin[N°-nouvelle-version]
# python setup.py install --prefix='/usr/local' --record=install.log
}}}
 1. après l'installation :
  a. modifier la variable `sys.path.insert` de `/etc/moinmoin/moin.wsgi` : `sys.path.insert(0, '/etc/moinmoin')`
  a. remplacer l'ancien `htdocs` par la nouvelle version (`/usr/src/moin-[N°-nouvelle-version]/wiki/htdocs` --> `/usr/local/share/moin/`)
 1. éventuellement, si modification de syntaxe : `moin migration data --help`
 1. puis relancer apache (# apachectl graceful)
 1. s'assurer qu'on est à la bonne version : `https://wiki.auf.org/wikiteki?action=test`

'''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é.

= Prévisions =
 * upgrade vers Moinmoin 1.8... mais il faudra d'abord passer par 1.7
 * Thème [[http://moinmo.in/ThemeMarket/Gugiel|Gugiel]] plus simple, plus sobre
 * 1.8 : ré-activation éditeur graphique (après quelques tests, histoire de...)
 * re-tentative de moteur de recherche Xapian

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é)

  • adaptation du thème sinorca4moin

  • note : moteur de recherche Xapian installé, mais ne fonctionne pas. A revoir (paquets python-xapian et catdoc+xpdf-utils)

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

  1. sauvegarde de la version courante (répertoires /usr/local/share/moin et /usr/local/lib/python*/ notamment)
  2. sauvegarde des données : /var/lib/moinmoin/
  3. installation de la nouvelle version :
    # cd /usr/src/moin[N°-nouvelle-version]
    # python setup.py install --prefix='/usr/local' --record=install.log
  4. après l'installation :
    1. modifier la variable sys.path.insert de /etc/moinmoin/moin.wsgi : sys.path.insert(0, '/etc/moinmoin')

    2. remplacer l'ancien htdocs par la nouvelle version (/usr/src/moin-[N°-nouvelle-version]/wiki/htdocs --> /usr/local/share/moin/)

  5. éventuellement, si modification de syntaxe : moin migration data --help

  6. puis relancer apache (# apachectl graceful)
  7. s'assurer qu'on est à la bonne version : https://wiki.auf.org/wikiteki?action=test

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é.

Prévisions

  • upgrade vers Moinmoin 1.8... mais il faudra d'abord passer par 1.7
  • Thème Gugiel plus simple, plus sobre

  • 1.8 : ré-activation éditeur graphique (après quelques tests, histoire de...)
  • re-tentative de moteur de recherche Xapian

ZA/WikiAufOrg (dernière édition le 2015-07-10 19:13:00 par JeanChristopheAndré)