Installation d'Iconito

Note : Cette page est une version mise en forme du fichier INSTALL disponible à la racine du projet.

Pour installer et faire fonctionner ICONITO, vous avez besoin des éléments suivants :

• Apache
• Serveur de base de données
• PHP 4.3 ou supérieur (avec les extension GD2, Magic Mime et le support GIF)

ATTENTION, dans cette première version, la documentation et les scripts ne s’appliquent qu’à MySql. Le support des autres bases de données sera ajouté ultérieurement.

Cette méthode est la plus courante, elle nécessite d’avoir téléchargé le TGZ d’une version d’Iconito. Il existe deux façons d’installer Iconito : une automatique et une manuelle. L’installation automatique est conseillée, car elle est plus facile, plus rapide, et ne nécessite pas de connaissances techniques particulières pour intervenir sur le serveur. L’installation manuelle reste toujours possible, surtout pour ceux qui ont des problèmes avec l’installation automatique.

1. Téléchargez les sources de l’application sur la forge de l’Adullact : http://adullact.net/frs/?group_id=210.
   Prenez de préférence la dernière version (stable si c’est précisé)
2. Décompressez l’archive dans un répertoire de votre serveur web en conservant l’arborescence des fichiers :
   

   tar xvfz iconito-vX.tgz

   (X=le numéro de la version téléchargée)

3. Accédez à la racine web du site (http://127.0.0.1 par exemple, ou http://127.0.0.1/Iconito/www) et suivez les différentes étapes de l’installeur automatique. Cette procédure vérifie que votre serveur dispose des éléments requis et vous demande les informations nécessaires à la configuration d’Iconito (base de données...)
4. Lorsque l’installation est terminée, vous pouvez vous connecter avec le compte administrateur :
   • Nom d’utilisateur : admin
   • Mot de passe : celui que vous aurez choisi à l’étape 3
5. Si vous souhaitez installer le jeu d’essai, suivez les instructions ci-dessous.

1. Téléchargez les sources de l’application sur la forge de l’Adullact : http://adullact.net/frs/?group_id=210.
   Prenez de préférence la dernière version (stable si c’est précisé)
2. Décompressez l’archive dans un répertoire de votre serveur web en conservant l’arborescence des fichiers :
   

   tar xvfz iconito-vX.tgz

   (X=le numéro de la version téléchargée)

3. Copiez les fichiers de configuration, en retirant le “.default” du nom :
   • Dans project/ : project.default.xml → project.xml
   • Dans project/config/ : copix.conf.default.php → copix.conf.php
   • Dans var/config/ : profils.copixdb.default.xml → profils.copixdb.xml
4. Donnez les droits en lecture/écriture au serveur web (Apache par exemple) aux répertoires suivants (ainsi qu’à leurs éventuels sous-répertoires) :
   

   chmod -R 777 data
   chmod -R 777 var
   chmod -R 777 www/static
   chmod -R 777 temp

5. S’il s’agit d’une première installation, créez les tables MySql nécessaires à l’application, en utilisant le script de création des tables (iconito.sql dans le dossier instal) disponible dans le répertoire instal, à exécuter dans une base de données dédiée si possible à ICONITO :
   

   mysql --user=utilisateur --password=motdepasse nombase < instal/iconito.sql

   Si vous ne disposez pas encore d’une base MySql, vous pouvez la créer avec cette commande :
   

   mysqladmin --user utilisateur --password motdepasse create nombase

6. Insérez dans la base les données minimales obligatoires, par le fichier instal/data.sql. Si vous pouvez imposer le jeu de caractères du fichier lors de l’import, spécifiez “latin1”.
   

   mysql --user=utilisateur --password=motdepasse nombase < instal/data.sql

7. Configurez l’accès à la base de données en modifiant le fichier var/config/profils.copixdb.xml
   

   driver="mysql"
   dataBase="nombase"
   host="localhost"
   user="utilisateur"
   password="motdepasse"

   Remplacez nombase par le nom de la base de données, localhost par le serveur, utilisateur par le nom d’utilisateur MySql et motdepasse par son mot de passe. Veillez à laisser les guillemets autour.

8. Editez le fichier project/project.xml si vous souhaitez activer l’envoi de mails au travers d’un serveur SMTP, en modifiant les lignes suivantes. Pour mailEnabled, mettez 1 à la place de 0 et pour mailSmtpHost, mettez le nom ou l’adresse IP de votre serveur SMTP à la place de localhost) :
   

   <parameter name="mailEnabled"  captioni18n="parameter.mailEnabled"  default="0"  />
   <parameter name="mailSmtpHost"  captioni18n="parameter.mailSmtpHost"  default="localhost"  />

9. Accédez à la racine web du site (http://127.0.0.1 par exemple).
   La page affiche un message d’erreur, cliquez sur “Continuez sans configurer la base de données”. Vous obtenez ensuite le message “Installation terminée”. Cliquez sur le lien pour aller à l’accueil d’Iconito.
10. Vous pouvez vous connecter avec le compte administrateur fourni :
    • Nom d’utilisateur : admin
    • Mot de passe : admin
      Il est conseillé de modifier le mot de passe de ce compte à la première connexion.
11. Si vous souhaitez installer le jeu d’essai, suivez les instructions ci-dessous.

Attention ! Il est nécessaire d’installer le jeu d’essai de suite après l’installation d’Iconito, avant toute utilisation.

Si vous souhaitez démarrer avec un jeu d’essai comprenant quelques classes, élèves, enseignants, directeurs et parents (avec des comptes d’accès pour chacun), connectez-vous avec le compte “admin”, allez sur la page index.php?module=kernel&desc=demo et suivez les instructions.

(http://127.0.0.1/index.php?module=kernel&desc=demo par exemple)

Après installation, les comptes suivants sont opérationnels (nom d’utilisateur / mot de passe) :

• Elève : jean / 123456
• Directeur : pfranc / 123456
• Enseignant : mmeyer / 123456
• Parent : alenaick / 123456
• Ville : mbraton / 123456

En plus des comptes, le jeu d’essai fournit différents contenus : minimails de bienvenue, demandes d’interventions (téléprocédures), messages dans les carnets de correspondance, groupes de travail avec photos, blogs, forum....

Cette méthode est réservée aux utilisateurs avertis.

Avantages : mises-à-jour simplifiées, seuls les fichiers modifiés sont mis-à-jour, possibilité de suivre les développements en cours, possibilité d’envoyer vos modifications (patch) à l’équipe de développement, etc.

Limites : Il faut avoir un accès direct à la machine (shell ou système de fichier) et non un simple accès FTP sur les fichiers. Evidemment, CVS doit être installé !

1. Placez-vous dans le répertoire dans lequel vous souhaitez copier les sources sur votre serveur.
2. Connectez-vous au dépôt CVS (La connexion étant anonyme, appuyez simplement sur “Entrée” quand CVS vous demande le mot de passe) :

   cvs -d :pserver:anonymous@scm.adullact.net:/cvsroot/iconito login
   

3. Récupérez les sources depuis le CVS :

   cvs -d :pserver:anonymous@scm.adullact.net:/cvsroot/iconito checkout Iconito
   cvs -d :pserver:anonymous@scm.adullact.net:/cvsroot/iconito checkout Gael
   

   Deux répertoires seront alors créés : Iconito et Gael.

4. Faites pointer votre serveur web dans les répertoires Iconito/www et Gael/www.
   Pour cela, vous avez plusieurs méthodes en fonction de votre solution d’hébergement : soit dans la configuration d’Apache (VirtualHost et DocumentRoot), soit avec un lien symbolique pointant vers les répertoires “www”. Dans tous les cas, ne faites JAMAIS pointer votre racine web en dehors des répertoires “www” !!!

1. Entrez dans le répertoire à mettre à jour (Iconito, Gael, ou même un sous-répertoire).
2. Tappez simplement “cvs update”.
3. La mise à jour ne touche qu’aux fichiers. Les fichiers de mise à jour de la base sont dans “Gael/instal/update...” et “Iconito/www/upgrade...”.

Avec CVS, il est possible de créer des “branches” et des “tags”. Les branches sont des développements parallèles du même projet (par exemple : Iconito 1 et Iconito 2). Les tags sont des labels que nous plaçons sur les fichiers pour signaler leur avancement (par exemple : V2_0, STABLE, etc.).

Si vous récupérez les sources dans une branche donnée, les mises-à-jour resteront dans cette branche (pratique pour suivre les correction de la Version 1 d’Iconito par exemple). Il est de plus possible de récupérer plusieurs fois les sources du même projet : une fois en version 1 pour l’exploitation, une fois en version 2 pour les développements, etc.

1. Récuperer les sources de la version 1 d’Iconito (et y rester pour les mises-à-jour) :

cvs -d :pserver:anonymous@scm.adullact.net:/cvsroot/iconito checkout -r BRANCH_1 Iconito 

1. Récuperer les sources de la version de développement d’Iconito :

cvs -d :pserver:anonymous@scm.adullact.net:/cvsroot/iconito checkout -r HEAD Iconito 

1. Récuperer les sources de la version 0.8 d’Iconito (même si ca ne sert à rien) :

cvs -d :pserver:anonymous@scm.adullact.net:/cvsroot/iconito checkout -r ICONITO_0_8 Iconito