Nota: benché le procedure di installazione siano concettualmente indipendenti dal sistema operativo, gli esempi riportati si riferiscono ad una configurazione standard su sistema operativo Linux, web server Apache e database MySql.

Nota 1: le istruzioni per l'installazione delle versioni precedenti si trovano all'interno del pacchetto scaricabile.

Avvertenza per l'aggiornamento da precedenti versioni di ADA.

Assicurarsi che il computer su cui si vuole installare ADA rispetti i requisiti minimi richiesti.

STEP 1
Decomprimere i files dell'installazione in un directory vuota
(i nomi delle directory sono da considerarsi di esempio)
--
mkdir ada_install
cd ada_install
cp dir_di_download/ada_install_1-71.tar.gz .
tar xvzf ada_install_1-71.tar.gz
--

STEP 2
Decomprimere i files di programma in una directory vuota accessibile via web
-- creazione dir
mkdir nome_dir
-- copia del files compresso contenente i programmi nella directory creata
cd nome_dir
cp ada_install/ada_1-71.tar.gz .
tar xvzf ada_1-71.tar.gz

STEP 3
Creazione database e importazione tabelle mysqladmin create ada
mysql ada < ada_171.sql
nota 1: la stessa operazione può essere eseguita anche da PhpMyAdmin o da uno strumento equivalente
nota 2: è ovviamente necessario conoscere user name e password dell'utente mysql abilitato a creare DataBase

STEP 4
Impostare i permessi correttamente
Le directory

1. upload_file/media_perupload,
2. upload_file/uploaded_files,
3. upload_file/uploaded_files/tutors,
4. courses/media,
5. courses/media/tutors

DEVONO essere accessibili in scrittura dall'utente del server web.

Esempio nel caso di Linux, server web Apache con utente nobody.

cd upload_file/media_perupload
chown nobody.webmasters upload_file/media_perupload
chmod 775 upload_file/media_perupload

cd upload_file/uploaded_files
chown nobody.webmasters upload_file/uploaded_files (chown utente.gruppo - webmasters è un gruppo di esempio
chmod 775 upload_file/uploaded_files

cd upload_file/uploaded_files/tutors
chown nobody.webmasters upload_file/uploaded_files/tutors (chown utente.gruppo - webmasters e' un gruppo di esempio
chmod 775 upload_file/uploaded_files/tutors

cd courses/media
chown nobody.webmasters courses/media
chmod 775 courses/media

cd courses/media/tutors
chown nobody.webmasters courses/media/tutors
chmod 775 courses/media/tutors

Anche i seguenti files che si trovano nella directory user devono essere accessibili in scrittura dall'utente del server web:

• hlp_it.txt
• info_it.txt
• news_it.txt

(continua)

STEP 5
Impostazioni dei files di configurazione

1.config_path.inc.php
In questo file va definita la directory principale di ADA e va indicata la posizione del file di configurazione vero e proprio.
$root_dir = "/home/web/ada_test";
include_once("$root_dir/ada_config.php");

2.ada_config.php
Configurare le costanti di interfacciamento con il DB:
define('ADA_DB_TYPE', 'mysql'); // il tipo di database utilizzato
define('ADA_DB_NAME', 'ada_test'); // il nome del database utilizzato
define('ADA_DB_USER', 'db_user'); // l'utente utilizzato per la connessione al db
define('ADA_DB_PASS', 'db_password'); //password utilizzata per la connessione al db
define('ADA_DB_HOST', 'localhost'); //l'host sul quale risiede il db
$http_root_dir = 'http://vostro.dominio.it'; // l'indirizzo web dell'applicazione

Per motivi di sicurezza, si consiglia di tenere ada_config.php in una zona non accessibile da web.

STEP 6
Installazione dei programmi di Chat

cd ada_install
cp dir_di_download/ada_chat.tar.gz .

STEP 7
Creazione database e importazione tabelle per la chat
mysqladmin create adaChat
mysql ada < adaChat.sql

nota: è ovviamente necessario conoscere user name e password dell'utente mysql abilitato a creare DataBase

STEP 8
Impostare i permessi della directory log della chat
cd chat/chat
chown nobody.webmasters log
chmod 775 log

STEP 9
Impostazioni delle costanti nel file di configurazione della Chat, cioè chat/chat/config/config.lib.php3

define("C_DB_TYPE", "mysql"); //tipo di data base
define("C_DB_HOST", "localhost"); //host che ospita il data base
define("C_DB_NAME", "adaChat"); // nome del data base
define("C_DB_USER", "ada_user"); // utente abilitato per accedere al database.
define("C_DB_PASS", "ada_passwd"); // password dell'utente abilitato

STEP 10
Si comincia...
Puntare il browser sull'indirizzo in cui avete installato ADA e inserite i dati:

login: admin
passwd: admin

Se tutto è ok, vi trovate adesso nella home page dell'amministratore e potete cominciare a creare gli utenti e i corsi. Buon lavoro !