Informazioni generali per l'installazione
Da Wikipedia, l'enciclopedia libera.
| Table of contents |
Introduzione
Questa pagina è pensata più per gli amministratori che per gli sviluppatori, ma descrive alcuni trucchi utili anche per questi ultimi.
Prima dell'installazione
Requisiti di Sistema
Prima di tutto, non dimenticate di leggere il file install.txt che contiene importanti informazioni.
Sistemi operativi
È necessario utilizzare uno dei seguenti sistemi operativi:
- Linux / BSD / Unix (*)
- Windows (9x, Me, NT4, 2000, 2003, XP)
- MacOS X.
Nota
- Claroline viene controllato in dettaglio con le distribuzioni GNU/Linux Debian (stabile) e Mandrake GNU/Linux, ma altre distribuzioni GNU/Linux dovrebbero funzionare. Abbiamo ricevuto responsi positivi da utenti che lavorano su Red Hat e Suse. Non esitate a notificarci ogni problema incontrato su altre distribuzioni GNU/Linux.
Server web
Raccomandiamo Apache, ma altri potrebbero andare bene ugualmente:
- Apache 1.3 o 2.0
- Microsoft IIS
PHP
PHP (versione >= 4.1.x) configurato con i seguenti moduli: mysql, zlib, preg. Gran parte delle distribuzioni compilate di PHP4 sono fornite di questi moduli. Comunque la loro presenza viene controllata dallo script di installazione di Claroline.
Si potrebbero incontrare dei problemi se le impostazioni di PHP non corrispondessero alle seguenti:
short_open_tag = On register_globals = On safe_mode = Off magic_quotes_gpc = On magic_quotes_runtime = Off error_reporting = E_ALL & ~E_NOTICE (*)
Note
- Gli utenti con PHP 4.2 o superiori dovrebbero impostare il parametro:
register_globals = On
- Gli utenti con PHP 4.3 o superiori dovrebbero impostare anche il parametro:
magic_quotes_gpc = On
- È possibile impostare error_reporting ad un livello più basso ma non ad un livello più alto.
Server di database MYSQL
È necessario avere un server database MySQL ed una coppia utente/password che permetta di amministrare e creare almeno un database. L'impostazione predefinita di Claroline creerà un singolo database per contenere tutti i corsi. Se si vuole utilizzare Claroline su un 'host di database multipli' è necessario impostare l'opzione corrispondente all'installazione. Ciò significa che l'host dovrà permettere di creare ed amministrare più database contemporaneamente.
Attenzione
- Se si usa l'opzione single database, è raccomandabile di utilizzare il database solo per Claroline. Se si condivide questo database con altre applicazioni possono avvenire delle interferenze tra i nomi delle tabelle che possono provocare seri problemi di funzionamento ai programmi.
Nota
- Il carattere di apice inverso (`) inserito dentro molte interrogazioni SQL da Claroline versione 1.3 in poi, non funziona con versioni di MySQL precedenti la 3.23.6.
Note importanti
- Claroline funziona solo con un server e un account.
- Claroline necessita di almeno un database.
- Con l'opzione di installazione single database, Claroline viene fatto funzionare in maniera tale da renderlo capace di lavorare con un account che non può creare database.
- Con l'opzione di installazione multi database, Claroline funzionerà in maniera tale da considerare che l'account possa creare database.
Permessi sulle cartelle
Date il permesso di scrittura alla directory web dove è stato spostato o decompresso. Remotamente, si avrà la necessità di cambiare i permessi sulle cartelle e sui file attraverso FTP, telnet, ssh o altro.
Server di posta
Un server di posta viene chiamato in termini tecnici Mail Transport Agent (MTA).
Il server non è necessario ma alcune caratteristiche di Claroline rimarranno mute se non si è provvisti di un MTA.
- Tante distribuzioni GNU/Linux forniscono un MTA (Sendmail, Exim, Qmail, PostFix, ...).
- Sulle macchine MS Windows, non c'è un MTA fornito un maniera predefinita. È possibile modificare il file di configurazione php.ini per redirezionare la posta su un MTA accessibile su un'altra macchina, o installare un MTA sul server che ospita Claroline. Esistono diversi MTA disponibili per MS Windows (Blat, Netmail95, WMailto , Hamster ...).
Requisiti MySql
Archivi tabelle
Claroline necessita di 2 tipi di archivi tabelle (in uno o più database).
- Tabelle principali
- Tabelle corsi
Tabelle principali
Ci sono tabelle:
- Centrali (utenti, elenco strumenti, ...).
- Statistiche sulla piattaforma.
Queste tabelle sono create in un database.
Tabelle corsi
Ci sono tabelle per:
- Strumenti corsi.
- Gruppi.
- Statistiche del corso.
Claroline è fatto per avere una tabella per ogni paia di "strumento-corso". Perciò la tabella chat nel corso pinco non è la stessa del corso pallo.
Ciò significa che ci sono molte tabelle. È più semplice avere un database per ogni corso ma prima di installare non si sa quanti corsi verranno creati. Perciò Claroline necessita di un utente con i diritti di creazione di database (è l'opzione multi database all'installazione).
Molti amministratori di mysql lo troveranno da pazzi: 'Cosa? Dare diritti di creazione database ai miei utenti? .. NO!'
Se l'amministratore rimane inflessibile è possibile richiedere un solo database e stringere tutte le tabelle dei corsi nello stesso database (è l'opzione single database all'installazione)
Nota per gli amministratori
Un'ottima soluzione è quella di richiedere il permesso di creare database con un prefisso fisso.
- Creare un utente con meno diritti possibile (nessuno)
- Dare tutti gli accessi a quest'utente sul db 'foo%'
Con questi diritti, l'account può creare tutti i database che necessita ma tutti i database devono avere il nome che comincia per foo. È possibile impostare questo prefisso del nome all'installazione.
Nota per gli sviluppatori
La soluzione per gli amministratori è comoda anche perché in questo modo è possibile eseguire più piattaforme Claroline sulla stessa macchina. Personalmente abbiamo un utente chiamato "claroline" con password. I diritti di quest'utente sono "all" sui database "claro%". E quando installiamo Claroline, impostiamo un prefisso "clarofoo" dove "foo" è il nostro nome di checkout.
Sul disco
Claroline necessita di lavorare nello spazio web.
Perciò Caroline contiene:
- index.php.
- Alcuni file html.
- Sotto cartelle e script Claroline.
- File di Readme e licenza.
Se si vuole che Claroline non sia l'unico "strumento" sul sito web è meglio creare una sottocartella nella radice del server web.
Sarà necessario fare qualcosa come:
esempio
- La radice del server web è in /var/www/html/
cd /var/www/html/ mkdir miascuola cd miascuola
- Mettere nella sottocartella miascuola il contenuto dell'archivio (o del checkout del cvs per gli sviluppatori).
Permessi sul file system
Per gestire i file di Claroline, usare un account membro del gruppo del processo del webserver.
esempio
- Debian GNU/Linux
addgroup paul www-data
- Mandrake GNU/Linux
addgroup paul apache
