======= Installation dela base de données =======

* Généralités
------------

Le fichier de configuration relatif à la base de donnée est /config/define_db.ini

L'application est configurée par défaut et dans son ensemble pour échanger des données au format UTF-8.

Créer l'utilisateur 'linea' avec le mot de passe 'linea' et donnez lui les droits requis sur la base précédemment créée, ou changez le nom d'utilisateur et le mot de passe dans /config/define_db.ini.

!!! Changez impérativement votre couple utilisateur/mot de passe si vous souhaitez déployer linea21 en production !!!


* Installation sous MySQL
------------------------

- Executer le script /scripts_sql/buildDB.mysql.fr.sql (le script créera automatiquement la base de données 'linea' si vous ne l'avez pas créée précédemment)

* Installation sous PostGreSQL
------------------------

- voir la section "installation sous PostGreSQL"


======= Paramétrages spécifiques à votre installation =======

Rappel : la version 1.2.x intègre un configurateur des fichiers système en ligne sous le terme module configuration.
Si vous n'utilisez pas le configurateur, le paramétrage spécifique à votre installation s'effectue dans le fichier define_release.ini
Pour une installation standard les sections suivantes doivent être paramétrées : SERVER_SETTINGS, MAIL_INFORMATIONS et MAIL_SETTINGS
Linea21 est livré avec le nom de collectivité mylinea par défaut, pour votre installation, modifier les sections requises avec l'url, les mails et le nom de votre collectivité. 


======= Se logguer sur l'interface d'administration =======

Pour se logguer sur l'interface d'administration, ouvrir linea21 dans votre navigateur web.
L'adresse devrait être du type :

http://localhost/linea21/admin/

login : admin
password : linea

!!! Changez votre mot de passe administrateur si vous souhaitez déployer linea21 en production !!!


======= Définir la racine du site =======

Certaines opérations font appel aux constantes SITE_CITY_URL, SITE_ROOT_URL et SITE_PATH définies dans /config/define_release.ini
Assurez vous que cette valeur soit bien configurée.

SITE_CITY_URL = "http://localhost/linea21/public/" //en local
SITE_CITY_URL = "http://linea21.monsiteweb.com" //en ligne

SITE_ROOT_URL = "http://localhost/linea21/" //en local
SITE_ROOT_URL = "http://www.monsiteweb.com" //en ligne

SITE_PATH = "C:/server/apache/Apache2/htdocs/linea21/" // exemple sous windows

Consulter la variable $_SERVER["DOCUMENT_ROOT"] et concaténer le nom de votre dossier d'installation Linea21 pour connaitre le chemin de votre application et définir SITE_PATH


======= Avertissement sur l'encodage UTF-8 =======

Les fichiers de l'application sont encodés en UTF-8. Pour y apporter des modifications, vous devez impérativement utiliser un éditeur de texte supportant cet encodage et enregistrer vos fichiers au même format.


======= Migration 1.1 vers 1.2.x =======
   
sauvegarder la webapps existante : par défaut, répertoire linea21
sauvegarder la base donnée existante : mysqldump -hlocalhost -ulinea -plinea linea21 > /home/backup_linea21/linea21_1_date.dmp
intégrer le patch de migration (dans /scripts_sql/) vers linea21 1.2.x : mysql -hlocalhost -ulinea -plinea linea21 < /home/linea21/scripts_sql/patch_1.2.x.mysql.fr.sql
supprimer la webapps existante : rm -R /home/linea21 Vous pouvez sinon l'installer dans un nouveau répertoire.
décompresser l'archive de la nouvelle version de linea21 : linea21_1_2.zip ou linea21_1_2.tgz vers votre répertoire d'execution apache ex: /home/linea21
appliquer les paramétrages spécifiques de votre application aux fichiers suivants :
config/define_release.php de votre ancienne version vers config/define_release.ini
config/define_db.php de votre ancienne version vers config/define_db.ini
copier les contenus des dossiers suivants de l'ancienne version vers la nouvelle :
/contents/input
/multimedia/input
/news/input
/newsletter/input
/publication/contents
/user/avatar


Si vous souhaitez utiliser l'URL Rewrite, vérifier le paramétrage du fichier /public/.htaccess en accord avec votre configuration virtualhost
Reporter tout paramétrage spécifique effectué dans l'ancienne version sur les fichiers du nouveau système (ex :/public/tpl_home.php).
La version 1.2.x intégre un nouveau système de template. Par défaut, les fichiers sont lus dans /public/dist/. Vous pouvez créer vos propre templates
et les mettre directement dans /public/. Les templates utilisateurs ont précédence sur les templates par défaut.


======= Installation sous PostgreSQL =======

- Créer la base de données nommée 'linea'
- Executer le script /scripts_sql/buildDB.pgsql.fr.sql

Changer la valeur de la constante 'SQL' définie dans /config/define_release.ini.  Remplacer la valeur par défaut 'mysql' par 'pgsql'.

!!! La version 1.2.x ne permet pas le fonctionnement du module 'recherche' pour les versions de pgsql >= 8.3 !!!

Moteur de recherche PostgreSQL: Installation de Tsearch2 (version PGSQL <= 8.3)

Execution du script SQL tsearch2.sql situé dans /share/contrib/ du dossier racine de PostgreSQL afin d'implementer le moteur de recherche FTI (Full Text Indexing)

Enfin, éxecuter le script/scripts_sql/buildDBindex.pgsql.fr.sql afin de générer les indexes nécessaires au bon fonctionnement du moteur de recherche interne.

Pour améliorer les fonctionnalités du moteur de recherche, il est vivement recommander de coupler un dictionnaire au FTI.

Dictionnaires disponibles et procédures d'installation :

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

Si vous installez un dictionnaire, il vous sera probablement nécessaire de changer le schéma spécifié lors de la recherche. Editez /search/pgsql.inc.php, recherchez la valeur \'default\' et remplacez là par la valeur que vous avez définie dans la base de données 


======= Erreurs fréquentes =======

* Installation de la base de données sur postgresql.
   IF EXISTS uniquement disponible à partir de la version 8.2.
   Supprimer l'instruction dans le script d'installation
   
   





