MANUALE DI INSTALLAZIONE GANESHA versione 2.0 Editore Anéma SA Département Développement Redattore Graziella DUVERNY Tél. : + 33 (0)1 43 47 17 14 duverny@anemalab.org Anéma SA 12, rue Moreau F-75012 Paris Tél. +33 (0)1 43 47 17 14 Fax +33 (0)1 43 47 37 15 SA au capital de 44 220 euros - RCS Paris B 432 224 855 Siret : 432 224 855 00028 - NAF/APE : 804 D www.anema.fr mi_ganesha20_v2_it.doc Page 1/20
Cronologia modifiche Data Versione Descrizione Autore 23/01/04 1.0 Creazione G. Duverny 2.0 Creazione della base dati G. Caldeira 15/03/04 2.0 Traduzione italiana A. Gilibini mi_ganesha20_v2_it.doc Page 2/20
SOMMARIO 1. INTRODUZIONE 4 2. STEP 0 : PREPARARE L INSTALLAZIONE 4 2.1 Decomprimere la versione di Ganesha 4 2.2 FTP per un'installazione «da zero» 4 2.3 FTP per un aggiornamento di versione (1.X -> 2.0) 5 2.3.1 Preparare l'aggiornamento 5 2.3.2 Aggiornamento dei CV e dei moduli formativi 6 2.3.3 Gli skin 6 2.4 Connessione per l'installazione in linea 7 2.5 Hosting 7 3. STEP 1 : LA LICENZA GPL 8 4. STEP 2 : CONFIGURAZIONE DI GANESHA 10 4.1 Creazione della base dati 10 4.2 Completare i campi 10 4.3 Esempio di configurazione per hosting a pagamento 11 4.4 Esempio di configurazione per hosting gratuito 11 4.5 Esempio d'installazione in locale sotto windows (con EasyPHP) 11 4.6 Help 12 5. STEP 3 : SCELTA DEL TIPO DI INSTALLAZIONE 13 6. STEP 4 : INSTALLAZIONE A BUON FINE 14 7. INSTALLAZIONE MANUALE 15 8. ACCESSO ALLA PIATTAFORMA 17 8.1 1 a connessione amministratore 17 8.2 1 a connessione studente 18 9. RECUPERO LOGIN / PASSWORD 18 10. ISCRIZIONE IN LINEA 19 mi_ganesha20_v2_it.doc Page 3/20
1. INTRODUZIONE Questo documento descrive la procedura di installazione di GANESHA versione 2.0, piattaforma e-learning open source sviluppata sotto licenza GPL. 2. STEP 0 : PREPARARE L INSTALLAZIONE 2.1 DECOMPRIMERE LA VERSIONE DI GANESHA Dopo aver decompresso il file di installazione otterrete il seguente elenco di file e cartelle : File - index.php - version.txt - gpl.txt - lisez-moi.txt - anema.inc.php-dist Cartelle - addons - bno - chat - com - cv - debug - docs - formation - ganesha - groupes - install - intro - phorum - upload_tuteur 2.2 FTP PER UN'INSTALLAZIONE «DA ZERO» Trasferite via FTP l'insieme dei file e delle cartelle viste al punto 2.1 sul vostro spazio server presso l'hosting provider di vostra scelta (nel caso, non dimenticate di attivare presso quest'ultimo i servizi "database MySQL" e "PHP"). mi_ganesha20_v2_it.doc Page 4/20
2.3 FTP PER UN AGGIORNAMENTO DI VERSIONE (1.X -> 2.0) 2.3.1 Preparare l'aggiornamento Con la versione 2.0 il file ganesha.inc.php è stato sostituito dal file anema.inc.php, è necessario quindi prestare attenzione unicamente alle cartelle seguenti : - cv - formation - groupes - upload_tuteur Per sveltire la procedura e conservare sul sito le cartelle della vecchia versione, sarà sufficiente rinominare queste ultime aggiungendo un "_" (underscore) davanti al nome : - ganesha ==> _ganesha - phorum ==> _phorum - visiteurs20 ==> questa cartella può essere eliminata in quanto non più utilizzata da Ganesha - chat ==> _chat Trasferite via FTP le cartelle della versione 2.0 : - addons - com - ganesha - phorum - chat - install - intro - docs - bno - debug e i file presenti nella root : - gpl.txt - index.php - lisez-moi.php - version.txt - anema.inc.php-dist mi_ganesha20_v2_it.doc Page 5/20
2.3.2 Aggiornamento dei CV e dei moduli formativi Nel caso abbiate creato dei CV (per i tutor) e dei moduli formativi, dovrete modificare il codice PHP inserito all'inizio dei rispettivi file. Aprite il vostro editor di testo e apportate le seguenti modifiche : Versione 1.X Versione 2.0 <?PHP include "../ganesha.inc.php"; if (!Init($connexion,'','')) { PageErreur(); exit(); }?>... <link rel="stylesheet" href="<?php echo $HTTP['skin'].$gfilecss?>" type="text/css"> <?PHP include "../../anema.inc.php";?>............... <?php stylesheet()?> 2.3.3 Gli skin Con la versione 2.0, ogni skin è definito da una cartella (nome dello skin) e da 2 file: color.inc.php e ganesha.css. mi_ganesha20_v2_it.doc Page 6/20
2.4 CONNESSIONE PER L'INSTALLAZIONE IN LINEA Digitate nel vostro browser l url d accesso alla cartella ganesha presente sul vostro spazio server (esempio : www.nomedominio.com/piattaforma). Ganesha riconosce in automatico l'inizio della procedura d'installazione; da questo punto in poi seguite le istruzioni. Ecco la schermata di avvio dell'installazione : 2.5 HOSTING Potete utilizzare provider gratuiti o a pagamento. Per tener conto delle caratteristiche del vostro provider, sarà necessario configurare la piattaforma (mail, upload ). Coloro che utilizzano Windows dovranno installare un server Web che supporti PHP, per esempio EasyPHP (http://www.easyphp.org). Per effettuare l'upload di documenti dovete disporre dei diritti di scrittura sul vostro spazio web. In caso contrario, contattate il vostro provider e domandategli come attivarli. mi_ganesha20_v2_it.doc Page 7/20
3. STEP 1 : LA LICENZA GPL Come prima cosa, leggete la licenza GPL (General Public License). La traduzione non ufficiale in italiano della licenza è disponibile al seguente indirizzo : http://www.prosa.it/philosophy/gpl.txt mi_ganesha20_v2_it.doc Page 8/20
Successivamente sarà necessario accettare i termini della licenza cliccando sul bottone in basso : Accettare la licenza GPL mi_ganesha20_v2_it.doc Page 9/20
4. STEP 2 : CONFIGURAZIONE DI GANESHA 4.1 CREAZIONE DELLA BASE DATI La procedura d'installazione di Ganesha non prevede la creazione della base dati. Dovrete quindi crearla preventivamente o utilizzarne una già esistente. 4.2 COMPLETARE I CAMPI Dovrete completare i seguenti campi : - Nome del server della base dati - Nome utente della base dati - Password della base dati (facoltativa) - Nome della base dati - Percorso assoluto verso Ganesha - URL verso Ganesha Help : accesso al manuale d'installazione in linea Help per completare i 2 campi indicati mi_ganesha20_v2_it.doc Page 10/20
4.3 ESEMPIO DI CONFIGURAZIONE PER HOSTING A PAGAMENTO Esempio di un account presso OVH (account ganesha20, installazione nella root) : - Nome del server : sql1.ovh.net - Nome utente : ganesha20 - Password : xxxxxx - Nome della base dati : ganesha20 - Percorso assoluto verso Ganesha : /home/ganesha20/www/ - URL verso Ganesha : http://www.ganesha20.org 4.4 ESEMPIO DI CONFIGURAZIONE PER HOSTING GRATUITO Esempio di un account presso Free (account www.ganesha20, installazione nella root) : - Nome del server : sql.free.fr - Nome utente : www.ganesha20 - Password: (la medesima dell'account) - Nome della base dati : www.ganesha20 - Percorso assoluto verso Ganesha : /var/www/free.fr/4/w/w/w/./www.ganesha20/ - URL verso Ganesha : http://www.ganesha20.free.fr Esempio di un account presso Lycos (account demoganesha, installazione nella root) : - Nome del server : localhost - Nome utente : (lo stesso del vostro account) - Password : (nessuna password) - Nome della base dati : demoganesha_db - Percorso assoluto verso Ganesha : /data/perso/d/e/m/demoganesha/ - URL verso Ganesha : http://membres.lycos.fr/demoganesha Se non disponete di tutte le informazioni necessarie, contattate il vostro provider o l'amministratore di sistema. 4.5 ESEMPIO D'INSTALLAZIONE IN LOCALE SOTTO WINDOWS (CON EASYPHP) Esempio per un'installazione nella cartella ganesha20 nel www di EasyPHP (cartella di default di EasyPHP) : - Nome del server : localhost - Nome utente : root - Password : (nessuna password) - Nome della base dati : ganesha20 (o quella che avete creato) - Percorso assoluto verso Ganesha : c:/program files/easyphp/www/ganesha20/ - URL verso Ganesha : http://localhost/ganesha20/ mi_ganesha20_v2_it.doc Page 11/20
4.6 HELP E' possibile utilizzare l'help per completare i due seguenti campi : - Percorso assoluto verso Ganesha - URL verso Ganesha mi_ganesha20_v2_it.doc Page 12/20
5. STEP 3 : SCELTA DEL TIPO DI INSTALLAZIONE E' possibile effettuare diversi tipi di installazione : - Installazione completa : installazione completa di Ganesha e della base dati. - Riconfigurazione di Ganesha 2.0 : riconfigurazione di Ganesha senza toccare la base dati - Aggiornamento della versione 1.2 : installazione della versione 2.0 a partire dalla versione 1.2. - Aggiornamento della versione 1.3 : installazione della versione 2.0 a partire dalla versione 1.3. - Aggiornamento della versione 1.4 : installazione della versione 2.0 a partire dalla versione 1.4. Visualizzazione dei file config.inc.php e anema.inc.php (per verifica) Backup della base dati prima dell'installazione o dell'aggiornamento Prima di una installazione completa o di un aggiornamento, premuratevi di fare un backup di tutti i file del vostro sito e della base dati. Nel caso di un'installazione completa, tutti i dati precedenti andranno perduti. Salvataggio della base dati esistente : Potete utilizzare il bottone «Backup» durante lo Step 3 della procedura d'installazione (qui sopra), oppure PhpMyAdmin. Per maggiori informazioni : http://www.phpmyadmin.net mi_ganesha20_v2_it.doc Page 13/20
Una volta scelto il tipo d'installazione, 2 possibilità : - L installazione automatica è riuscita e passate allo Step 4 (capitolo 6); - Vi è un problema di scrittura sul server e dovete effettuare una installazione manuale (capitolo 7). Durante l'installazione, il file anema.inc.php viene copiato nella root : NON CANCELLATELO! Contiene il percorso d'accesso ai file include. 6. STEP 4 : INSTALLAZIONE A BUON FINE Se l'installazione automatica della versione 2.0 di Ganesha si è svolta regolarmente, otterrete la schermata qui sotto: Alla vostra prima connessione, non dimenticate di : - modificare la password d'amministratore ; - eliminare (o proteggere) la cartella "install"; - eliminare (o proteggere) la cartella "visiteurs20" (update 1.X); - eliminare (o proteggere) la cartella "testconfig" (update 1.X). mi_ganesha20_v2_it.doc Page 14/20
7. INSTALLAZIONE MANUALE La vostra installazione è fallita, avete incontrato un problema di scrittura sul server del vostro provider. Siete dunque passati, automaticamente, all'installazione manuale mediante la schermata qui sotto : mi_ganesha20_v2_it.doc Page 15/20
Ecco la procedura da seguire : 1. Fare l'upload del file anema.inc.php e posizionarlo nella root del vostro spazio server. Esempio del contenuto : 2. Fare l'upload del file config.inc.php e posizionarlo nella cartella : /ganesha/inc/ Esempio del contenuto : 3. Scegliere tra un'installazione completa o un aggiornamento di versione. Non dimenticare, se necessario, di fare un backup della base dati esistente. mi_ganesha20_v2_it.doc Page 16/20
8. ACCESSO ALLA PIATTAFORMA Una volta portata a termine l'installazione, potete accedere alla piattaforma a partire dalla schermata riportata qui sotto : Lista di username e password per testare il profilo Studente Lista di username e password per testare il profilo Tutor Username e password per testare il profilo Amministratore L'accesso può avvenire secondo uno dei tre profili seguenti : - il profilo Studente - il profilo Tutor - il profilo Amministratore 8.1 1 A CONNESSIONE AMMINISTRATORE Di seguito i codici d'accesso relativi al profilo Amministratore : - Username : admin - Password : ganesha Non dimenticate di cambiare immediatamente questi codici! 1. Entrate in Ganesha con il profilo Amministratore. 2. Cliccate su ADMINISTRATION, cambiate i codici e confermate. mi_ganesha20_v2_it.doc Page 17/20
8.2 1 A CONNESSIONE STUDENTE 9. RECUPERO LOGIN / PASSWORD Nel caso si dimentichi del proprio username e/o della propria password, ogni membro (studente/tutor/amministratore) li potrà ricevere per e-mail indicando il proprio indirizzo di posta nell'apposito campo. Inserite qui la vostra e-mail mi_ganesha20_v2_it.doc Page 18/20
10. ISCRIZIONE IN LINEA A partire dalla pagina d'accesso alla piattaforma vi è la possibilità di effettuare un'iscrizione in linea. A questo scopo è necessario inserire il codice fornito dal proprio tutor e confermare. Inserire qui il codice fornito dal tutor mi_ganesha20_v2_it.doc Page 19/20
In seguito è necessario completare i seguenti campi e confermare: - Cognome - Nome - E-mail - Indirizzo - CAP - Città Confermare Una volta validato il form, riceverete username e password all'indirizzo e-mail indicato, così da poter accedere alla piattaforma e seguire il vostro percorso formativo. mi_ganesha20_v2_it.doc Page 20/20