======= Installazione del data base =======

* Generali
------------

Il file di configurazione relativo al data base è /config/define_db.ini

L'applicazione è configurata di default e nel suo insieme per scambiare dei dati in formato UTF-8.

Creare l'utente 'linea' con password 'linea' e attribuitegli i diritti richiesti sulla base precedentemente creata (chiamarla 'linea' anche), oppure cambiate il nome utente e la password all'interno di /config/define_db.ini.

!!! Cambiate tassativamente la vostra coppia utente/password se desiderate dispiegare linea21 in produzione !!!


* Installazione sotto MySQL
------------------------

- Eseguire lo script /scripts_sql/buildDB.mysql.it.sql
- Eseguire le script /scripts_sql/input.mysql.it.sql per popolare la base (richiesto)

* Installazione sotto PostGreSQL
------------------------

- vedere la sezione "installazione sotto PostGreSQL"


======= Parametri specifici per la vostra installazione =======

Richiamo : da la versione 1.2, Linea21 integra un configuratore di file system on line sotto il nome modulo di configurazione.
Se non utilizzate il configuratore, il parametraggio specifico per la vostra installazione si effettua all'interno del file /config/define_release.ini
Per eseguire una installazione standard le sezioni seguenti devono essere parametrate : SERVER_SETTINGS, MAIL_INFORMATIONS e MAIL_SETTINGS
Linea21 è concesso con il nome di collettività mylinea di default, per la vostra installazione modificare le sezioni richieste con l'url, le mail e il nome della vostra collettività. 


======= Loggarsi sull'interfaccia di amministrazione =======

Per loggarsi sull'interfaccia di amministrazione, aprire linea21 col vostro browser.
L'indirizzo dovrà essere del tipo :

http://localhost/linea21/admin/

login : admin
password : linea

!!! Cambiate la vostra password di amministratore se desiderate dispiegare linea21 in produzione !!!


======= Definire la root del sito =======

Certe operazioni fanno appello alle costanti  SITE_CITY_URL, SITE_ROOT_URL e SITE_PATH definite all'interno di /config/define_release.ini
Assicuratevi che questo valore sia ben configurato.

SITE_CITY_URL = "http://localhost/linea21/public/" //locale
SITE_CITY_URL = "http://linea21.ilmiositoweb.com" //on line

SITE_ROOT_URL = "http://localhost/linea21/" //locale
SITE_ROOT_URL = "http://www.ilmiositoweb.com" //on line

SITE_PATH = "C:/server/apache/Apache2/htdocs/linea21/" // esempio sotto windows

Consultare la variabile $_SERVER["DOCUMENT_ROOT"] e concatenare il nome della vostra cartella di installazione Linea21 per conoscere il percorso della vostra applicazione e definite SITE_PATH


======= Avvertenza sulla codifica UTF-8 =======

I files dell'applicazione sono codificati in UTF-8. Per apportarvi delle modifiche, dovete tassativamente utilizzare un editor di testo che supporti questa codifica e salvare i vostri files nel medesimo formato.


======= Migrazione 1.1 verso 1.2.x =======
   
1 - salvare la webapps esistente : di default, directory linea21
2 - salvare il data base esistente : mysqldump -hlocalhost -ulinea -plinea linea21 > /home/backup_linea21/linea21_1_date.dmp
3 - integrare le patch di migrazione (dentro /scripts_sql/patches) verso linea21 1.2.x : mysql -hlocalhost -ulinea -plinea linea21 < /home/linea21/scripts_sql/patches/patch_1.2.mysql.it.sql
4 - eliminare la webapps esistente : rm -R /home/linea21 Altrimenti potete installarla in una nuova directory.
5 - decomprimere l'archivio della nuova versione di linea21 : linea21_1_2.zip o linea21_1_2.tgz verso la vostra directory di esecuzione apache es: /home/linea21
6 - applicare i parametraggi specifici per la vostra applicazione ai files seguenti :
	/config/define_release.php della vostra vecchia versione verso config/define_release.ini
	/config/define_db.php della vostra vecchia versione verso config/define_db.ini
7 - copiare i contenuti delle cartelle seguenti della vecchia versione verso la nuova :
	/contents/input
	/multimedia/input
	/news/input
	/newsletter/input
	/publication/contents
	/user/avatar


Se desiderate utilizzare l'URL Rewrite, verificate il parametraggio del file /public/.htaccess in concordanza con la vostra configurazione virtualhost
Trasferire ogni parametraggio specifico effettuato nella vecchia versione sui files del nuovo sistema (es :/public/tpl_home.php).
La versione 1.2.x integra un nuovo sistema di template. Di default, i files sono letti all'interno di /public/dist/. Potete creare il vostro personale templates
e metterli direttamente dentro /public/. I templates utenti hanno la precedenza sui templates di default.


======= Migrazione 1.2.x verso 1.3 =======

- Ripetere i passi 1, 2, 3, 4, 5, 6 (sopra)
- Per il passo 3 : Eseguire lo script /scripts_sql/patches/patch_1.3.mysql.sql


======= Documentazione e supporto =======

http://dev.linea21.com				Wiki - Bug tracker
http://www.linea21.com/forum		Forum
http://www.linea21.com				Sito web


======= Installazione sotto PostgreSQL =======

- Creare il data base 'linea'
- Eseguire lo script /scripts_sql/buildDB.pgsql.sql

Cambiare il valore della costante 'SQL' definita all'interno di /config/define_release.ini.  Sostituire il valore di default 'mysql' con 'pgsql'.

!!! La versione 1.2.x non permette il funzionamento del modulo 'ricerca' per le versioni di pgsql >= 8.3 !!!

Motore di ricerca PostgreSQL: Installazione di Tsearch2 (versione PGSQL <= 8.3)

Execuzione dello script SQL tsearch2.sql situato all'interno di /share/contrib/ della cartella di root di PostgreSQL al fine di implementare il motore di ricerca FTI (Full Text Indexing)

Infine, eseguire lo script/scripts_sql/buildDBindex.pgsql.sql al fine di generare gli indici necessari al buon funzionamento del motore di ricerca interno.

Per migliorare le funzionalità del motore di ricerca, è vivamente raccomandato l'accoppiamento di un dizionario all' FTI.

Dizionari disponibili e procedure di installazione :

http://www.sai.msu.su/~megera/postgres/gist/tsearch/V2/
http://www.sai.msu.su/~megera/postgres/gist/doc/intro.shtml

Se installate un dizionario, vi sarà probabilmente necessario cambiare lo schema specificato al momento della ricerca. Editate /search/pgsql.inc.php, cercate il valore \'default\' e rimpiazzatelo col valore che avete definito nel data base 


======= Errori frequenti =======

* Installazione del data base su postgresql.
   IF EXISTS unicamente disponibile a partire dalla versione 8.2.
   Eliminare l'istruzione nello script d'installazione
