Installazione TCExam












TCExam :: Installazione
IndiceRequisiti minimiConfigurazione dell'ambiente operativoInstallazione TCExamInstallazione automaticaInstallazione manualeModifica dei file di configurazioneInstallazione del databasePost installazioneConfigurazione del sistemaAccesso e Sicurezza

Requisiti minimiPrima di procedere all'installazione di TCExam è necessario verificare i requisiti minimi del sistema:Un web server (es: Apache [http://httpd.apache.org/], Microsoft® IIS [http://www.microsoft.com]).PHP 5 (http://www.php.net) - indispensabileLe seguenti librerie:PHP GD Library 2.0.1 (http://www.boutell.com/gd) - necessaria per le immagini ed i grafici in true colorQuesta libreria andrà installata con:libpng 1.2.2 - supporto immagini PNGjpegsrc.v6b - supporto immagini JPEGUno dei seguenti database:

MySQL 4.1 (http://www.mysql.com)
Controlla il link seguente in caso di problemi di autenticazione: http://dev.mysql.com/doc/mysql/en/Old_client.html
PostgreSQL 7.4 (http://www.postgresql.org)

Zend OptimizerTM 2.5.7 per eseguire i file codificati (non richiesto per la versione non codificata).Almeno 20MB per i file ed almeno 10MB per il databasePer l'installazione e la configurazione del server web e delle librerie richieste consultate i rispettivi manuali.I client dovranno essere dotati di un comune Web-browser che supporti XHTML 1.0 e JavaScript 1.2.[indice]

Configurazione dell'ambiente operativoPer il corretto funzionamento di TCExam è necessario configurare il PHP in modo che supporti i sistemi e le librerie sopra indicate, è necessario inoltre che alcuni parametri di PHP siano impostati come segue:su php.inisafe_mode = Offarg_separator.output = "&"oppure su modulo Apache (/etc/httpd/conf/httpd.conf):
<IfModule mod_php4.c>
php_admin_flag safe_mode off
php_value arg_separator.output "&amp;"
</IfModule>Per la configurazione degli aspetti generali del PHP o per diverse modalità di configurazione, fate riferimento alla guida ed alle annotazioni ufficiali sul sito www.php.net.Sarà inoltre necessario controllare le quote disco degli utenti che dovranno essere sufficienti a gestire i file ed il database.NOTA:Se utilizzate IIS su una versione di Microsoft® Windows non Server, utilizzate l'applicativo software di Microsoft MetaEdit 2.2 per modificare il numero di massime connessioni contemporanee consentite ed i timeout di IIS:LM/W3SVC/MaxConnections 40LM/W3SVC/CGITimeout 300LM/W3SVC/ROOT/CGITimeout 300
Nota: 300 rappresenta il numero di secondi in 5 minuti.[indice]

InstallazioneVerificate che l'ambiente operativo sia correttamente installato e configurato così come descritto nei paragrafi precedenti.Copiate tutto il contenuto della cartella TCExam nella web root del vostro server o in una sottocartella.Se utilizzate un FTP per trasferire la versione encoded di TCExam, assicuratevi di impostare il trasferimento dei file in modalità binaria prima di inviare i file al server.A questo punto è possibile procedere in due modi:

Installazione automaticaAttraverso questo processo è possibile installare automaticamente il database e configurare i parametri di sistema principali.Modificate i permessi dei seguenti file e directory in modo tale che siano scrivibili dal software (chmod 666 su sistemi unix-like):install/shared/config/tce_db_config.phpshared/config/tce_paths.phpadmin/phpMyAdmin/config.inc.phpadmin/phpPgAdmin/conf/config.inc.phpQuesti file potranno essere reimpostati su sola lettura al termine dell'installazione.Nel caso in cui il programma di installazione non riuscisse a modificare questi file, sarà sempre possibile modificarli manualmente come descritto nel paragrafo successivo.Usando un comune web browser (programma di navigazione internet come Microsoft® Internet Explorer, Mozilla o Netscape®) collegatevi all'indirizzo in cui si trova il programma di installazione di TCExam: http://<host>/install/install.phpSe l'ambiente operativo è correttamente configurato dovreste vedere il modulo di installazione di TCExam.



Nota che:Data la criticità di questo componente, il programma di installazione si presenta solo ed esclusivamente in lingua inglese.Il processo di installazione eliminerà qualsiasi dato delle precedenti installazioni di TCExam, se ci si trova in questo caso sarà quindi opportuno fare delle copie (backup) dei dati.Per procedere all'installazione sarà necessario compilare opportunamente il modulo e premere il pulsante INSTALL.Di seguito l'elenco dei campi richiesti dal modulo di installazione:db type: tipo di database utilizzato (il predefinito è MySQL)db host: nome dell'host del database (solitamente localhost:3306 per MySQL o localhost:5432 per PostgreSQL)db user: nome dell'utente del database (solitamente è root)db password: password utente per l'accesso al database db name: nome del database (solitamente TCExam). Sarà necessario cambiare il nome solo nel caso in cui nello stesso sistema esistano altre copie di TCExam.tables prefix: prefisso da aggiungere al nome delle tabelle (solitamente tce_)host URL: il nome di dominio del vostro sito (ad es: http://www.host.com)relative URL: percorso a partire dalla root del webserver dove sono stati copiati i file di TCExam (solitamente / oppure /<percorso ad TCExam>/)TCExam path: percorso reale completo della directory dove è stato installato TCExam (ad esempio: /usr/local/apache/htdocs/TCExam/ oppure c:/Inetpub/wwwroot/TCExam/)TCExam port: porta di connessione http predefinita (solitamente 80).Se l'installazione è andata a buon fine il sistema sarà pronto per la sua prima esecuzione.A questo punto si potrà rimuovere la cartella install dal server e ripristinare i permessi di sola lettura nei file di configurazione.In caso contrario si potrà completare o ripetere l'installazione usando la procedura manuale descritta di seguito.[indice]

Installazione manualePer installare manualmente TCExam occorre modificare i file di configurazione ed installare il database.

Modifica file di configurazioneI file e le costanti di configurazione essenziali per l'avvio di TCExam sono:shared/config/tce_db_config.phpK_DATABASE_TYPE (tipo di database, solitamente MYSQL oppure POSTGRESQL)K_DATABASE_HOST (nome dell'host del database, solitamente localhost)K_DATABASE_NAME (nome del database, solitamente TCExam)K_DATABASE_USER_NAME (nome dell'utente del database, solitamente è root)K_DATABASE_USER_PASSWORD (password per l'accesso al database)K_TABLE_PREFIX (prefisso da aggiungere al nome delle tabelle, solitamente tce_)shared/config/tce_paths.phpK_PATH_HOST (il nome di dominio del vostro sito ad es: http://www.host.com)K_PATH_PHPMYEXAM (percorso a partire dalla root del webserver dove sono stati copiati i file di TCExam, solitamente / oppure /<percorso a TCExam>/)K_PATH_MAIN (percorso reale completo della directory dove è stato installato TCExam, ad esempio: /usr/local/apache/htdocs/TCExam/ oppure c:/Inetpub/wwwroot/TCExam/)K_STANDARD_PORT (porta di comunicazione http, solitamente 80)

admin/phpMyAdmin/config.inc.php
cfg['PmaAbsoluteUri'] (indirizzo internet completo dove si trova installato il programma phpMyAdmin, solitamente http://<host>/admin/phpMyAdmin/)cfg['Servers'][$i]['host'] (nome dell'host del database MySQL, solitamente localhost)cfg['Servers'][$i]['user'] (nome dell'utente del database MySQL, solitamente è root)cfg['Servers'][$i]['password'] (password utente per l'accesso al database MySQL)

admin/phpPgAdmin/conf/config.inc.php

$conf['servers'][0]['host'] (nome dell'host del database PostgreSQL, solitamente localhost)
$conf['servers'][0]['port'] (port del database sul server, solitamente 5432)



Installazione del databaseAll'interno della cartella install sono contenuti i file SQL che contengono lo schema ed i dati del database:

mysql_db_structure.sql - contiene la struttura del database MySQL
mysql_db_data.sql - contiene i dati del database MySQL
pgsql_db_structure.sql - contiene la struttura del database PostgreSQL
pgsql_db_data.sql - contiene i dati del database PostgreSQL


Se si desidera cambiare il prefisso delle tabelle sarà necessario usare un editor di testi che abbia una funzione cerca e sostituisci e operare le seguenti sostituzioni:Nel file ..._db_structure.sql sostituire CREATE TABLE tce_ con CREATE TABLE vostroprefissoNel file ..._db_data.sql sostituire INSERT INTO tce_ con INSERT INTO vostroprefisso
Per eseguire i file SQL potete usare i comandi di shell dei rispettivi database.
Esempio MySQL:
mysql
mysql> CREATE DATABASE TCExam;
shell> mysql TCExam < db_structure.sql
shell> mysql TCExam < db_data.sql

Nell'esempio precedente si è supposto che il nome del database fosse TCExam.In alternativa (se avete già configurato il config.inc.php) potete usare l'utility http://<host>/admin/phpMyAdmin/index.php per MySQL o http://<host>/admin/phpPgAdmin/index.php per PostgreSQL con la quale potete creare il database ed eseguire i file SQL attraverso l'apposito comando.[indice]

Post installazioneUna volta terminato il processo di installazione occorre:eliminare la cartella install che non è più necessaria e rappresenta un pericolo per la sicurezza dell'attuale installazioneimpostare a sola lettura (chmod -R 644 su sistemi unix-like) i permessi dei file nelle cartelle:admin/config/shared/config/public/config/impostare opportunamente i permessi per quelle cartelle che dovranno essere accessibili in scrittura dal software TCExam (chmod -R 666):admin/logcacheimagespublic/logimpostare nel dettaglio i file di configurazione come indicato nel paragrafo successivo[indice]

Configurazione del sistemaTerminata l'installazione automatica, TCExam dovrebbe essere in grado di sfruttare tutte le sue funzioni.È possibile personalizzare alcune impostazioni e caratteristiche di base, modificando i seguenti file di configurazione:shared/config/tce_config.php - configurazione generale del sistemashared/config/tce_db_config.php - configurazione databaseshared/config/tce_extension.inc - estensione dei file usata dal sistema (.php)shared/config/tce_general_constants.php - costanti di uso generaleshared/config/lang/***/ - cartelle contenenti i file di linguashared/config/tce_paths.php - percorsi file e directory all'interno del sistemashared/config/tce_pdf.php - configurazione del formato dei documenti PDF e delle intestazioniadmin/config/tce_config.php - configurazione generale pannello di amministrazioneadmin/config/tce_auth.php - impostazione livello di accesso ai moduli di amministrazionepublic/config/tce_config.php - configurazione generale dell'area pubblica[indice]

Accesso e SicurezzaUna volta terminate le fasi di installazione e configurazione sopra descritte potete accedere al sistema collegandovi col browser all'indirizzo http://<host>/admin/code/index.php ed usando i seguenti dati:nome: adminpassword: 1234Al fine di proteggere il vostro sistema e garantirvi un accesso esclusivo, ricordatevi di cambiare la password tramite il modulo Utenti. Sempre tramite questo modulo potete anche inserire i vostri dati e le vostre preferenze.Per ottenere un maggior livello di sicurezza si consiglia vivamente di proteggere l'intera cartella admin con un sistema di autenticazione utente web-based.Uno dei modi più semplici e sicuri per proteggere una cartella su un server Apache consiste nell'utilizzare l'autenticazione Htaccess. Per maggiori informazioni consultate http://httpd.apache.org/docs/howto/htaccess.html.Se usate un diverso web server consultate la relativa documentazione.[indice]