= 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 [[AuthentificationCentralisée/NssMysql|système d'authentification NSS-MySQL]] au lieu de NIS
 * passer [[Postfix/BackendMysql|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 [[http://trac.sn.auf.org/guia/browser/contrib/migrations|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/Etch|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 Virtual``Host 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|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/<Nom``Greffon>/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)