GUIDE D'INSTALLATION

© Epistema 2002-2003
Mis à jour le 24/07/03

Note : Vous pouvez imprimer ce guide sur votre imprimante au format A4.

Introduction

Bienvenue,

Toute l'équipe d'EPISTEMA est heureuse de vous accueillir parmi les utilisateurs d'Epilearn.

Lisez attentivement ce guide avant d'utiliser le logiciel Epilearn. Il vous explique la méthode d'installation du logiciel sur un serveur local ou sur un serveur distant.

Pour répondre à toutes vos questions, EPISTEMA a mis à votre disposition un support complet sur le site internet www.epilearn.com.

Nous attachons également beaucoup d'importance à votre avis. N'hésitez pas à nous en faire part simplement à l'aide des formulaires prévus à cet effet sur le site www.epilearn.com.

Le service client EPISTEMA

Sommaire

1. Les composants d'installation d'Epilearn

Prérequis

L'installation du logiciel Epilearn nécessite une connaissance suffisante des serveurs web ainsi que la maîtrise des procédures élémentaires de transfert de fichier (FTP) vers un serveur distant.

Le niveau requis est celui d'un utilisateur capable de créer lui-meme son site web statique chez un hébergeur. Si vous ne vous trouvez pas dans ce cas, il est préférable de faire appel aux services techniques d'Epistema qui installeront, pour vous, le logiciel.

Présentation

Epilearn est une plateforme de formation en ligne qui vous permet notamment de :

• Gérer une base d'utilisateurs (étudiants)
• Gérer une base de ressources de formation
• Gérer des parcours de formation individualisés
• Gérer les statistiques d'accès à la plateforme (temps d'accès, évaluations, nombre d'accès)

L'installation contient plusieurs éléments :

2. Configuration serveur nécessaire

Epilearn nécessite pour fonctionner un environnement serveur composé du serveur web Apache, de l'interpréteur de pages actives PHP4 et du système de base de données MySQL (Les versions minimum requises pour ces logiciels sont : Apache 1.3.20 - PHP 4.2.0 - MySQL 3.23.47). Cet environnement serveur tourne sur la plupart des systèmes d'exploitation, en particulier :

• Linux/Unix : ces outils sont distribués en standard et configurés correctement dans la majorité des distributions Linux.
• Windows : vous pouvez installer cet environnement en utilisant par exemple le package Wampp téléchargeable sur http://www.apachefriends.org/wampp-en.html.
• MacOS X : la version serveur de MacOS X est installée avec Apache, PHP et MySQL. (Sur la version client, Apache est livré en standard, mais pas MySQL ni PHP. Vous pouvez cependant installer l'un et l'autre en suivant les instructions sur le site http://www.entropy.ch/).

Hébergement mutualisé : un grand nombre de solutions d'hébergement mutualisé existe sur le marché, telles qu'Online.net, OVH ou Claranet, qui proposent cet environnement en standard.
Chaque hébergeur a ses spécificités. Epistema a recensé les caractéristiques d'un certain nombre d'hébergeurs pour lesquels la procédure d'installation est explicitée. Pour les autres, il vous appartient de vérifier les configurations disponibles et les éventuelles contraintes que ces hébergeurs peuvent imposer.

Modules PHP : Epilearn ne nécessite que les modules fournis en standard sur la majorité des distributions PHP, tels que GD, en particulier.

Variables PHP : il est important que la variable PHP "register_globals" soit mise à "on" et non pas à "off" comme cela peut être le cas par défaut sur les versions les plus récentes de PHP.

Note importante : PHP est un logiciel libre et évoluant sans cesse. Nous ne pouvons garantir l'execution sans faute d'Epilearn sur une configuration PHP différente que celle conseillée plus haut, les nouvelles fonctionnalités ajoutés à PHP pouvant parfois introduire des régressions. N'hésitez pas à nous contacter pour plus d'information sur les configurations serveur compatibles avec Epilearn.

3. Procédure d'installation

Cette procédure nécessite de votre part une connaissance élémentaire des mécanismes serveurs tels que le téléchargement de fichiers sur un compte FTP et l'appel d'un page serveur depuis un navigateur internet.

L'installation s'effectue en 3 phases :

• Phase 1 : recopie à l'identique du dossier \Epilearn sur le serveur que vous avez choisi pour mettre en ligne votre offre d'e-learning. Le dossier de recopie sur le serveur doit être vu du serveur Apache, afin que les scripts (écrits en PHP) puissent être lancés.
• Phase 2 : création ou paramétrage de la base de données MySQL
• Phase 3 : lancement de la configuration automatique du serveur d'e-learning
  

Dans la suite du présent guide d'installation nous supposerons que votre site est hébergé sous le nom serveur_elearning.com.

Phase 1 : Copie du dossier \Epilearn sur son emplacement serveur.

La première étape consiste à copier le contenu du dossier \Epilearn sur son emplacement serveur final.

Vous pouvez réaliser cette opération à l'aide d'un logiciel FTP (Leech FTP ou Cute FTP sur un PC, ou encore Fetch sur un Mac) si vous accédez à un serveur distant par exemple.

Nota : Le nom du répertoire de stockage du logiciel Epilearn sur votre serveur peut être choisi librement : vous prendrez par exemple :"\training" ou "\epl".

Phase 2 : Création de la base de donnée MySQL

Epilearn utilise une base de données MySQL pour gérer vos données de formation.
Vous devez vous assurer qu'une base de données est disponible pour être utilisée par le logiciel serveur.

Procurez vous les informations suivantes auprès de l'hébergeur ou de l'administrateur du serveur ; vous en aurez besoin pour la configuration automatique d'Epilearn :

• Serveur de la base de données. Il peut s'agir d'une url du type sql.serveur_elearning.com. Par défaut, la valeur est "localhost".
• Port d'accès à la base (optionnel) - Par défaut, il est couramment de "3306"
• Login d'accés à la base - Ex.: "charlie5"
• Mot de passe d'accès à la base - Ex. : "zilouga733"
• Nom de la base de données - Ex : base.serveur_elearning. Pour les hébergeurs mutualisés, ce nom est souvent imposé. Online.fr par exemple impose que la base de données porte le meme nom que celui du domaine hébergé.

Phase 3 : Lancement de la configuration automatique du serveur

Pour appeler le script automatique de configuration d'Epilearn, tapez dans votre navigateur l'adresse URL de la page index.php se trouvant à la racine du dossier d'Epilearn. Si vous avez nommé le dossier de stockage d'Epilearn Classroom en \training par exemple, le script se trouvera à l'adresse :

Ex : http://www.serveur_elearning.com/training/index.php

• La première partie de l'url "http://www.serveur_elearning.com" correspond à l'url de votre serveur internet.
• La deuxième partie "/training" correspond au nom que vous avez donné au dossier où vous avez stocké Epilearn.
• La troisième partie "/index.php" est le nom de la page internet démarrant le script d'installation du logiciel.

Lorsque vous avez cliqué sur l'URL, la page d'accueil de l'installation s'affiche :

Il vous suffit de cliquer sur "Démarrez l'installation maintenant" pour lancer le script d'installation automatique.

Nota : Si pour une raison quelconque le script d'installation ne fonctionne pas correctement sur votre serveur, vous pouvez :

• Contacter Epistema pour corriger ce problème
• Configurer vous même à la main votre logiciel serveur (cf fin de ce chapitre)

La configuration automatique s'effectue en 4 étapes :

• Etape 1 : rappels des prérequis pour installer Epilearn
• Etape 2 : controle du répertoire de stockage d'Epilearn
• Etape 3 : entrée des paramètres d'accès à la base MySQL et des chemins d'Epilearn
• Etape 4 : lancement de l'installation automatique et controle du résultat

Etape 1 : Un premier écran vous rappelle les prérequis pour installer Epilearn :

Etape 2 : Lecture, par le programme d'installation, des paramètres d'emplacement d'Epilearn

Etape 3 : entrée des paramètres d'accès à la base de données MySQL et des chemins d'Epilearn

Etape 4 : lancement de l'installation automatique du logiciel et rappel des résultats d'installation :

Si l'installation automatique n'a pas fonctionné, et si vous vous y connaissez suffisamment...

Vous pouvez dans ce cas entrer vous même les informations de configuration dans le fichier suivant :

/Epilearn/lms_hmi/conf/lms.conf.php

Vous trouverez au sein même du fichier les indications (en anglais) vous permettant une bonne configuration.

Les problèmes que vous pouvez parfois rencontrer :

→ les identifiants de la base de donnée que vous avez saisis n'ont pas permis au programme de se connecter. Il est possible que le mot de passe ou le nom de la base soient erronés. Vérifiez aussi le nom du serveur, ils diffèrent d'un type d'installation à l'autre.

→ En essayant de faire une copie de sauvegarde du fichier de configuration, le programme a rencontré une erreur, car il ne possède pas les droits de création de fichier dans le répertoire conf. En général, il suffit pour corriger ce problème de donner les droits d'écriture à tout le monde sur le dossier conf :

→ Le fichier conf.lms.php est protégé en écriture. De même que dans le cas précédent, il suffit de changer les attributs de ce fichier pour que l'installation se déroule correctement.

Note importante : ne changez les droits d'écriture et de lecture des dossiers et des fichiers que si vous rencontrez ces problèmes. Certains serveurs ont une configuration internet particulière qui fait que le logiciel cesserait de fonctionner avec des droits autres que ceux par défaut.

4. Installation d'Epilearn Manager

Epilearn Manager comporte les mêmes fonctions que l'interface web du manager, mais l'ergonomie Windows apporte un grand confort d'utilisation dans la gestion des données de la plate-forme.

Prérequis

L'installation d'Epilearn Manager nécessite que vous ayez un accès direct à la base de donnée MySQL utilisée par Epilearn. Certains serveurs n'offrent pas cette fonctionnalité. Vous devez par ailleurs vous assurer qu'un éventuel pare-feu ne bloque pas l'accès à la base de donnée.

Vous aurez besoin pour l'installation du logiciel de connaître les coordonnées de la plate-forme Epilearn, c'est à dire :

• l'URL d'accès à la plate-forme
• les coordonnées de la base de donnée

Installation

Pour installer Epilearn Manager il suffit de lancer le programme d'installation.

Configuration

Une fois le programme installé, vous pouvez le démarrer. Epilearn Manager s'ouvre systématiquement sur une fenêtre d'identification. Lors de la première utilisation, il vous faudra ouvrir les préférences de l'application à partir du bouton "Préférences", et saisir les coordonnées de la plate-forme et de la base de donnée. Vous pouvez tester chaque jeu de paramètres afin de vous assurer qu'ils sont valides. Vous pouvez ouvrir l'aide d'Epilearn Manager pour plus d'information sur chaque paramètre.

Une fois configuré, vous pouvez revenir à la fenêtre d'identification et saisir l'identifiant et le mot de passe du manager (par défaut "admin" et "epistema"). Il est fortement conseillé de changer le mot de passe du manager dès la première utilisation.

5. Procédure de mise à jour

Régulièrement, vous pourrez trouver sur le site www.epilearn.com, des patchs de mise à jour corrective ou évolutive.

Ces patchs contiennent des fichiers à installer au sein de l'arborescence de votre répertoire Epilearn.

Copiez les simplement par FTP à l'endroit indiqué dans les instructions de mises à jour fournies avec le patch.