MANUEL INSTALLATION GANESHA version 3.0 Editeur Anéma SAS Département Développement Rédacteur Graziella DUVERNY Tél. : + 33 (0)1 43 47 17 14 duverny@anemalab.org Anéma SAS 12, rue Moreau F-75012 Paris Tél. +33 (0)1 43 47 17 14 Fax +33 (0)1 43 47 37 15 SAS au capital de 51 860 euros - RCS Paris B 432 224 855 Siret : 432 224 855 00028 - NAF/APE : 804 D www.anema.fr
Historique des modifications Date Version Description Auteur 10/12/04 1.0 Création G. Duverny 25/05/05 1.1 Correction p6 + ajout sélection de la langue p20 G. Duverny Manuel d installation Ganesha v3.0-25/05/2005-2/22
Index du Manuel d Installation Introduction Préparation installation (Etape 0) o Dézippage o FTP pour une installation fraîche o Mise à jour depuis une version 1.68 JG depuis une version 2.0 depuis une version 2.1.X o Connexion o Hébergement Licence (Etape1) Configuration (Etape2) o Création de la base de données o Renseigner les champs o Exemple chez un hébergeur professionnel o Exemple chez des hébergeurs gratuits o Exemple en local avec EasyPHP o Utilisation de l'aide Sélection du type d'installation (Etape 3) Installation réussie (Etape 4) Installation manuelle Accès à la plate-forme o Premier accès Administrateur o Premier accès Stagiaire Rappel Login/Password Inscription en ligne Manuel d installation Ganesha v3.0-25/05/2005-3/22
Introduction Ce document décrit la procédure d installation de GANESHA version 3, plate-forme de téléformation open source sous licence GPL et gratuite. Editeur : Anéma SAS Rédacteur de cette documentation : Graziella DUVERNY (duverny@anemalab.org) Préparer l'installation (Etape 0) Dézippage de l'archive Décompresser l'archive au format zip. Vous obtenez la liste suivante : Fichiers Répertoires index.php version.txt gpl.txt lisez-moi.txt anema.inc.php-dist addons bno chat debug docs exemple_csv formation ganesha groupes install intro rsync upload_photos FTP pour une installation "fraîche" Envoyez via FTP l'ensemble de ces fichiers et répertoires sur votre espace serveur chez votre hébergeur (le cas échéant n'oubliez pas d'activer les services "base de données MYSQL" et "PHP" auprès de votre hébergeur). Vous pouvez utilisez les logiciels suivants : Logiciel client FTP => FileZilla ( http://filezilla.sourceforge.net/ ) Logiciel de serveur FTP => TYPsoft FTP Serveur ( http://www.typsoft.com/ ) Manuel d installation Ganesha v3.0-25/05/2005-4/22
Mise à jour Mise à jour 1.68 JG vers 3.0 Il faut : - Supprimer les répertoires suivants : com cv phorum - Renommer le répertoire : ganesha en _ganesha - Garder les répertoires : formation groupes - Envoyez via FTP les répertoires de la nouvelle version : addons ganesha chat install intro docs bno debug upload_photos - Et les fichiers à la racine : gpl.txt index.php lisez-moi.php version.txt anema.inc.php-dist Manuel d installation Ganesha v3.0-25/05/2005-5/22
Mise à jour 2.0 vers 3.0 Il faut : 1- Supprimer les répertoires suivants : com cv phorum 2- Renommer le répertoire : ganesha en _ganesha 3- Garder les répertoires : formation groupes 4- Envoyez via FTP les répertoires de la nouvelle version : addons ganesha chat install intro docs bno debug upload_photos 5- Et les fichiers à la racine : gpl.txt index.php lisez-moi.php version.txt anema.inc.php-dist Manuel d installation Ganesha v3.0-25/05/2005-6/22
Mise à jour 2.1 vers 3.0 Il faut : - Supprimer les répertoires suivants : com cv phorum - Renommer le répertoire : ganesha en _ganesha - Garder les répertoires : formation groupes - Envoyez via FTP les répertoires de la nouvelle version : addons ganesha chat install intro docs bno debug upload_photos - Et les fichiers à la racine : gpl.txt index.php lisez-moi.php version.txt anema.inc.php-dist Manuel d installation Ganesha v3.0-25/05/2005-7/22
Connexion pour l'installation en ligne Tapez dans votre navigateur l url d accès à votre répertoire ganesha sur votre espace d'hébergement (exemple : www.nomdomaine.com/plateforme). Automatiquement Ganesha reconnaît que la procédure d'installation doit commencer, puis suivez les instructions. Voici l écran de démarrage de l installation : Hébergement Vous pouvez utiliser des hébergeurs gratuits ou payants. Pour tenir compte des particularités de votre hébergeur, il faudra configurer la plate-forme (mail, upload ). Pour ceux qui utilisent Windows, vous devez installer un serveur Web supportant PHP, par exemple en utilisant l installateur EasyPHP ( http://www.easyphp.org/ ) ou Wamp ( http://www.wampserver.com/ ). Pour uploader des documents vous devez avoir les droits d écriture sur votre espace web. Si ce n est pas le cas, il faut contacter votre hébergeur et lui demander comment appliquer ces derniers. Manuel d installation Ganesha v3.0-25/05/2005-8/22
Licence (Etape 1) Dans un 1er temps, vous devez lire la licence GPL (General Public License). La traduction française de la licence est disponible à l adresse suivante : http://www.gnu.org/copyleft/copyleft.fr.html#translations Manuel d installation Ganesha v3.0-25/05/2005-9/22
Puis, dans un 2ème temps, vous devez accepter la licence en cliquant sur le bouton en bas de la page : Configuration (Etape2) Création de la base de données Ganesha ne prend pas en compte la création de la base de données. Vous devez donc la créer ou utiliser une base de données déjà créée. Exemple de création d une base de données avec PhpMyAdmin : Manuel d installation Ganesha v3.0-25/05/2005-10/22
Renseigner les champs Vous devez renseigner les champs suivants : 1. Nom du serveur de la base de données 2. Nom d utilisateur de la base de données 3. Mot de passe de la base de données 4. Nom de la base de données 5. Chemin absolu vers Ganesha 6. URL vers Ganesha 7. Type de ganesha Si vous n avez pas toutes ces informations, vous devez contacter votre hébergeur ou votre administrateur système. Manuel d installation Ganesha v3.0-25/05/2005-11/22
Exemple chez un hébergeur professionnel Exemple avec un compte chez OVH (compte ganesha3, installation à la racine) : Nom du serveur : sql1.ovh.net Nom d utilisateur : ganesha3 Mot de passe : xxxxxx Nom de la base de données : ganesha3 Chemin absolu vers Ganesha : /home/ganesha3/www/ URL vers Ganesha : http://www.ganesha3.org Si vous n avez pas toutes ces informations, vous devez contacter votre hébergeur ou votre administrateur système. Exemple chez des hébergeurs gratuits Exemple avec un compte chez Free (compte www.ganesha3, installation à la racine) : Nom du serveur : sql.free.fr Nom d utilisateur : www.ganesha3 Mot de passe : le même que celui du compte Nom de la base de données : www.ganesha3 Chemin absolu vers Ganesha : /var/www/free.fr/4/w/w/w/./www.ganesha3/ URL vers Ganesha : http://www.ganesha3.free.fr Exemple avec un compte chez Lycos (compte demoganesha3, installation à la racine) : Nom du serveur : localhost Nom d utilisateur : le même que celui de votre compte Mot de passe : (pas de mot de passe) Nom de la base de données :demoganesha3_db Chemin absolu vers Ganesha : /data/perso/d/e/m/demoganesha3/ URL vers Ganesha : http://membres.lycos.fr/demoganesha3 Si vous n avez pas toutes ces informations, vous devez contacter votre hébergeur ou votre administrateur système. Manuel d installation Ganesha v3.0-25/05/2005-12/22
Exemple d'installation en local sous Windows (avec EasyPHP) Exemple pour une installation dans le répertoire ganesha3 dans le www d'easyphp (installation par défaut d'easyphp) : Nom du serveur : localhost Nom d utilisateur : root Mot de passe : (pas de mot de passe) Nom de la base de données : ganesha3 (ou celle que vous avez créée) Chemin absolu vers Ganesha : c:/program files/easyphp/www/ganesha3/ URL vers Ganesha : http://localhost/ganesha3/ Si vous n avez pas toutes ces informations, vous devez contacter votre administrateur système. Utilisation de l'aide Vous pouvez utiliser l aide pour remplir les deux champs suivants : Chemin absolu vers Ganesha URL vers Ganesha Manuel d installation Ganesha v3.0-25/05/2005-13/22
Et aussi pour choisir le type de Ganesha : Ganesha Standard (standalone) Ganesha site Local Ganesha site National Backup Ganesha Manuel d installation Ganesha v3.0-25/05/2005-14/22
Sélection du type d'installation (Etape 3) Vous pouvez effectuer différentes installations en fonction de vos besoins : Installation complète : installation complète de Ganesha et de la base de données. Reconfiguration de Ganesha 3.0 : reconfiguration de Ganesha sans toucher à la base de données. Mise à jour de la version 1.68 JG : installation de la version 3.0 à partir de la version 1.68 JG. Mise à jour de la version 2.0 : installation de la version 3.0 à partir de la version 2.0. Mise à jour de la version 2.1.X : installation de la version 3.0 à partir de la version 2.1.X. Avant une installation complète ou une mise à jour, pensez à sauvegarder l ensemble des fichiers de votre site, installer les fichiers de la nouvelle version et faire une sauvegarde de votre base de données. Lors d une installation complète, vous perdez toutes vos données. Sauvegarde de votre ancienne base de données : soit vous utilisez le bouton «Backup» de l étape 3 (ci-dessus), soit PhpMyAdmin. Pour plus d information voir le site : http://www.phpmyadmin.net/ Manuel d installation Ganesha v3.0-25/05/2005-15/22
Une fois que vous avez validé le type d installation, 2 possibilités : L installation automatique a réussi et vous passez à l étape 4 (InstallationReussie); Il y a un problème d écriture sur le serveur et vous devez effectuer une installation manuelle (cf InstallationManuelle). Lors de l installation, le fichier anema.inc.php va être copié dans le répertoire racine : NE PAS L'EFFACER! Il contient le chemin d accès aux fichiers include. Installation réussie (Etape 4) L'installation automatique de la version 3.0 de Ganesha s est bien déroulée, vous obtenez l écran ci-dessous : Dès votre 1ère connexion, n oubliez pas de : Changer le mot de passe de l administrateur. Supprimer (ou protéger) le répertoire install. Manuel d installation Ganesha v3.0-25/05/2005-16/22
Installation manuelle Votre installation a échoué, vous avez rencontré un problème de droit d écriture sur le serveur de votre hébergeur. Vous êtes donc passé, automatiquement, en installation manuelle via l écran ci-dessous : Voici la procédure à suivre : 1. Télécharger le fichier anema.inc.php et le placer à la racine. Exemple du contenu : // Date de l'installation : 6/12/2004 define('rp_inc', 'c:/www/dev_ganesha/ganesha3/ganesha/inc/'); define('rp_cls', 'c:/www/dev_ganesha/ganesha3/ganesha/class/'); include_once(rp_inc.'init_ganesha.inc.php') ; Manuel d installation Ganesha v3.0-25/05/2005-17/22
2. Télécharger le fichier config.inc.php et le placer dans le répertoire :./ganesha/inc/ // Gestion de la connexion a la base de donnees $BDD['name'] ='ganesha3'; $BDD['user'] ='root'; $BDD['pass'] =''; $BDD['server'] ='localhost'; define('rp_bin_mysql', define('rp_rsync', define('port_rsync', ''); ''); ''); // define retour a la ligne... define('crlf',"\r\n") ; // Chemin d'installation de la plate forme et adresse define('rp_main', 'c:/www/dev_ganesha/ganesha3/'); define('http_main', 'http://localhost/dev_ganesha/ganesha3/') ; define('rp_ganesha', RP_MAIN.'ganesha/'); define('http_ganesha', HTTP_MAIN.'ganesha/') ; define('http_phpmyadmin', 'http://127.0.0.1/mysql/'); define('ginstall', 1); define('h_deb_m', '08:00:00'); define('h_fin_m', '12:00:00'); define('h_deb_ap','14:00:00'); define('h_fin_ap','18:00:00'); define('smtp', define('adr_serveur_smtp', define('num_port_smtp', define('authen_smtp', define('nom_compte_smtp', define('password_smtp', false); ''); '25'); false); ''); ''); 3. Choisir entre une installation complète ou une mise à jour. Ne pas oublier de sauvegarder sa base de données si nécessaire. Manuel d installation Ganesha v3.0-25/05/2005-18/22
Accès à la plateforme Une fois l installation réussie vous pouvez accéder à la plate-forme via la page ci-dessous : Pour se connecter à la plate-forme, il faut cliquer sur les identifiants proposés dans la page exemple ci-dessus, le mot de passe se remplit automatiquement et vous avez plus qu'à valider. Vous pouvez y accéder selon les 3 profils suivants : le profil Stagiaire (Apprenant) le profil Tuteur (Formateur)/Tuteur Admin/Intégrateur/Tuteur Entreprise le profil Administrateur Manuel d installation Ganesha v3.0-25/05/2005-19/22
Première connexion Administrateur Voici les codes d accès en profil Administrateur : Identifiant : admin Mot de passe : ganesha Pour sélectionner la langue : 1. Cliquez sur le menu Options en haut de la page. 2. Sélectionnez la langue que vous voulez utiliser en cliquant sur le menu de gauche Gestion de la Langue. 3. Cliquez sur le bouton Enregistrer, le changement est immédiat. Ne pas oublier de changer tout de suite ces codes! 1. Connectez-vous sur Ganesha avec le profil Administrateur. 2. Cliquez sur ADMINISTRATION, changez la fiche et validez. Première connexion stagiaire Manuel d installation Ganesha v3.0-25/05/2005-20/22
Rappel Login/Password En cas d oubli de l'identifiant et du mot de passe, un membre (stagiaire/tuteur/admin) peut recevoir ces derniers par e-mail en indiquant son adresse dans le champ correspondant. Manuel d installation Ganesha v3.0-25/05/2005-21/22
Inscription en ligne Depuis la page d identification à la plate-forme vous avez la possibilité de vous inscrire en ligne. Pour cela vous devez remplir le formulaire contenant les champs suivants : Code (fourni par votre tuteur ou l administrateur) Nom Prénom E-mail Adresse Code postal Ville Une fois le formulaire validé, vous recevrez un identifiant et un mot de passe dans votre messagerie afin de pouvoir vous connecter à la plate-forme Ganesha et suivre votre formation. Manuel d installation Ganesha v3.0-25/05/2005-22/22