ECOSERRE Guide d installation
1. Configuration nécessaire pour installer ecoserre. Pour installer ecoserre sur votre machine, il faut au préalable vérifier que votre système d'exploitation vous donne accès : à un serveur de pages internet (ex : Apache www.apache.org) au langage de programmation PHP5 ou supérieur (www.php.org) au système de base de données MySQL (www.mysql.com) Remarque : une gestionnaire de base de données 1 n est pas obligatoire mais est vivement conseillé pour faciliter la maintenance de la base de données. 2. Installation sur un système GNU/Linux. Si c'est le cas, extrayez tous les fichiers de l'archive ZIP vers le répertoire «ecoserre» où pointe le serveur de pages html (voir dans le fichier «/etc/httpd/httpd.conf» pour Apache). Sinon, installez les packages à partir des CD de votre distribution Linux ou *BSD. Alias "/ecoserre" "/var/www/html/ecoserre/" <Directory "/var/www/html/ecoserre/"> Options Indexes FollowSymLinks Includes AllowOverride All #Order allow,deny Allow from all </Directory> Exemple de modification à apporter au fichier de configuration «/etc/httpd/httpd.conf». La copie des fichiers étant effectuée, vous pouvez maintenant configurer ecoserre en vous rendant sur la page http://localhost/ecoserre/setup/. Selon les droits dont vous disposez, il vous faudra créer préalablement une base de données. Si vous êtes sur un serveur local, utilisez un gestionnaire pour créer la base «ecoserre». Dans le cas contraire, demandez à votre hébergeur le nom de la base de données installée par défaut. mysql -u root mysql> create database ecoserre; mysql> exit Exemple de commandes à lancer pour créer la base de données «ecoserre» à partir d une console. 3. Installation sous M$-Windows. 1. télécharger et installer easyphp 2 2. dézipper les fichiers de ecoserre dans le répertoire "C:\Users\<nom d'utilisateur>\documents\www\ecoserre" 3. lancer easyphp : une icône doit se trouver dans la barre des icônes en bas à droite 4. click droit sur l'icône easyphp dans la barre d'icônes puis Administration 5. sur la page web : click sur le lien ajouter un alias 6. remplir les champs de la façon suivante : - nom de l'alias : ecoserre - répertoire : C:\Users\<nom d'utilisateur>\documents\www\ecoserre - puis OK 7. click sur le lien ecoserre nouvellement créé 1 PhpMyAdmin : http://www.phpmyadmin.net/home_page/index.php. Eskuel : http://eskuel.sourceforge.net/. 2 http://www.easyphp.org/download.php fr_install.odt - Page 2-25/05/2015
4. L installation de ecoserre. Laissez-vous guider par la procédure d'installation automatisée en 3 étapes. Vous pouvez choisir la langue d installation en cliquant sur le drapeau ad hoc. Si tous les indicateurs sont au «vert» ou «orange», vous pourrez installer ecoserre. Sur un serveur local (ie, votre machine) si vous n avez pas l habitude de configurer un serveur MySQL, laissez les paramètres ci-dessus par défaut. Si vous installez ecoserre sur le serveur d'un hébergeur, indiquez dans les champs de saisie cidessus les informations que votre hébergeur vous aura donné pour vous connecter à la base de données. Votre base MySQL a été installée sur notre serveur. Voici les données techniques: ----------------------------- MySQL: fr_install.odt - Page 3-25/05/2015
Serveur : mysql5-15 Utilisateur : lettretc001 Nom de la base : lettretc001 Mot de passe : 5LW2RDTb Exemple de mél envoyé par un hébergeur qui donne toutes les informations nécessaires. La base de données a pour nom «ecoserre». C'est fini! fr_install.odt - Page 4-25/05/2015
5. La première connexion. 1. lancer le navigateur internet 2. dans la barre de l'url du navigateur, taper: localhost/ecoserre 3. voilà, il suffit de se connecter Remarque : il existe un compte prédéfini avec les droits super utilisateur (maintenance) -> email : admin -> mot de passe : 6. Les problèmes fréquemment rencontrés. Malgré le soin apporté au module d installation automatique de ecoserre, il arrive parfois que les administrateurs rencontrent quelques problèmes lors du déploiement. Nous avons listé ci-dessous les erreurs principalement rencontrées. Droits Unix Il est possible que les droits Unix sur les fichiers et/ou les répertoires ne soient pas corrects si vous rencontrez les problèmes suivants : message d'erreur : "Echec à la création de config.php" impossible de sauvegarder la personnalisation de ecoserre Assurez-vous, dans ce cas, que le propriétaire et le groupe soient bien "apache" et que les droits Unix soient positionnés à rwxr-xr-x pour les fichiers et les sous répertoires. Si ce n'est pas le cas, exécutez la commande : "chown R apache:apache *" dans le répertoire d installation. Droits MySQL S'il y a des problèmes d'accès à la base de données vérifiez que l'utilisateur de la base "ecoserre" (en principe localhost) possède les droits ad hoc. Si ce n'est pas le cas, exécutez la requête SQL : "grant all on ecoserre.* to root@localhost". L interface phpmyadmin permet de lancer rapidement des requêtes SQL. Si vous avez indiqué un mot de passe (ex : ecoserre) pour accéder au serveur dans l étape 1, la requête devient : " grant all on ecoserre.* to root@localhost identified by ecoserre ". Problème de session Chez certains hébergeurs il est nécessaire de créer le répertoire «sessions» à la racine du répertoire «ecoserre» pour permettre un fonctionnement correct des sessions (ce répertoire doit posséder les droits d écriture!). Warning: session_start() [function.session-start]: open(/mnt/119/sdb/c/e/ramep/sessions/sess_e8d9302dd8b7017f9c9861ae8a7852a8, O_RDWR) failed: No such file or directory (2) Exemple de message d erreur. fr_install.odt - Page 5-25/05/2015
7. Mises à jour. Lors des évolutions de version de ecoserre, procédez de la façon suivante : Sauvegardez votre base de données Dézippez l archive dans le répertoire d installation Lancez le script d installation automatique à l'adresse http://localhost/ecoserre/setup/ A l étape 2, cochez la case «NE PAS effacer la base de données existante» N oubliez pas de cocher cette case. Sinon les données de la bdd seront perdues! Et c est tout! Le programme met à jour automatiquement la structure des tables MySQL à partir des fichiers.sql du répertoire MySql/update. Les mises à jour s'effectuent automatiquement sur la branche actuelle et la précédente. Pour des versions plus anciennes, procédez par étapes successives de branche majeure en branche majeure. fr_install.odt - Page 6-25/05/2015