Préparer son système

GUIA version 1.0 ne dispose(ra) pas de tous les greffons dont vous avez rêvé. Pour l'utiliser, il faut adapter votre système :

• passer en système d'authentification NSS-MySQL au lieu de NIS

• passer votre messagerie en MySQL (au lieu des fichiers /etc/aliases & consorts).

Sans attendre GUIA 1.0, nous vous conseillons d'étudier dès à présent ces migrations. Des outils pour vous y aider sont disponibles. Les spécialistes de renommée internationale sont aussi plus ou moins disponibles : JeanChristopheAndré et JérômeSantini, pour n'en citer que deux.

Pré-requis d'installation système

• Debian GNU/Linux "Etch" 4.0 (bah oui quoi, elle est déjà sortie, donc...)

• installer obligatoirement les paquets suivants :

  • locales (pour le support d'environnement en français, au moins)

    • apache2 (n'est plus à présenter)

  • python-django (le moteur de traitement Django)

  • python-pysqlite2 (recommandé par le paquet django)

  • python-mysqldb (support UTF-8 bogué ? empaqueter une version >= 1.2.2b2)

    • (http://sourceforge.net/tracker/index.php?func=detail&aid=1521274&group_id=22307&atid=374932 La 1.2.2 est publiée le 03/03/2007)

  • subversion (pour récupérer et faire le suivi des sources de GUIA)

  • patch (pour appliquer des... correctifs)

• installer éventuellement les paquets suivants :

  • python-imaging (pour le support des photos des utilisateurs)

  • libapache2-mod-python (pour optimiser le lancement des scripts)

  • sqlite3 (pour taper dans la base de données Django via les outils en ligne de commande ; pourrait parfois être utile)

• récupérer et installer les sources :

  • svn co http://trac.sn.auf.org/svn/guia/trunk/guia /usr/local/share/guia

• préciser le chemin d'installation dans la configuration (temporaire) :

  • sed -i "s|^rep_projet .*\$|rep_projet = '/usr/local/share/guia'|" /usr/local/share/guia/noyau/config.py

Installation Apache+mod_python

• Installer mod_python (libapache-mod-python)

• Créer un VirtualHost demo-guia.votredomaine.tld (/etc/apache2/sites-available/demo-guia)

<VirtualHost *>

        ServerName demo-guia.votredomaine.tld

        # pour /media/
        DocumentRoot /var/www/
        <Directory />
                Options FollowSymLinks
                AllowOverride None
        </Directory>
        <Directory /var/www/>
                Options Indexes FollowSymLinks MultiViews
                AllowOverride None
                Order allow,deny
                allow from all
        </Directory>

        <Location />
                PythonPath "['/usr/local/share/'] + sys.path"
                SetHandler python-program
                PythonHandler django.core.handlers.modpython
                SetEnv DJANGO_SETTINGS_MODULE guia.settings
                PythonDebug On
        </Location>

        <Location /media/>
                AddOutputFilterByType DEFLATE text/html text/plain text/xml text/javascript
                SetHandler None
        </Location>

        <LocationMatch "\.(jpg|gif|png)$">
                SetHandler None
        </LocationMatch>

</VirtualHost>

• Copier/Lier le répertoire media sous /var/www depuis /usr/share/python-support/python-django/django/contrib/admin/media

• Téléchargez et décompactez dojo sous /var/www/media/js/dojo (http://download.dojotoolkit.org/release-0.4.1/dojo-0.4.1-ajax.zip)

• Installez mysql-server et créer les bases des greffons qui vous intéressent (les schéma sont généralement sous guia/noyau/greffons/<NomGreffon>/bases/

• Ouvrez le fichier guia/noyau/greffons/init.py, choisissez les greffons qui vous intéressent et commentez les autres

• Modifiez les fichiers de config config.py dans les répertoires des greffons qui vous intéressent à votre convenance.

• Activez le site (et mod_deflate si ce n'est déjà fait) et pointez firefox sur http://demo-guia.votredomaine.tld/guia/ (admin/admin)

sudo a2ensite demo-guia
sudo a2enmod deflate

Si vous avez des problèmes ils sont là les Magiciens (JérômeSantini, JeanChristopheAndré, ThomasNoël) et jettez un coup d'oeil à la bonne doc sur http://www.djangoproject.com/documentation/modpython/

Installation Apache+FastCGI

http://www.djangoproject.com/documentation/fastcgi/

Exemple de script Init (http://code.djangoproject.com/wiki/InitdScriptForLinux)