Sites


Lutece : guide développeur

Configuration Lutece avancée

Configuration de l'application

Les fichiers de configuration de l'application se trouvent dans le répertoire WEB-INF/conf de la webapp. Les fichiers à configurer sont les suivants :

  • config.properties
  • db.properties

Configuration du fichier config.properties

Ce fichier est à mettre à jour au moment du déploiement de l'application :

Lors du premier lancement de l'application, autoInit est à true pour vous permettre la mise à jour automatique des chemins absolus du fichier. Par la suite, il est positionné à false.

# AutoInit for first deployment 
autoInit=false

Renseigner ici les informations nécessaires pour l'envoi de mail (notamment l'adresse IP du serveur SMTP).

 # Mail sending parameters
 mail.server=
 mail.list.separator=;
 mail.type.plain=text/plain;charset=
 mail.type.html=text/html;charset=
 mail.noreply.email=noreply@nowhere.org
 mail.charset=utf-8

Renseigner ici les chemins complets pour accéder aux fichiers properties lutece, jtidy et webmaster

 # Properties files
 file.lutece.properties=C:/tomcat/webapps/lutece/WEB-INF/conf/lutece.properties
 file.jtidy.properties=C:/tomcat/webapps/lutece/WEB-INF/conf/jtidy.properties
 file.webmaster.properties=C:/tomcat/webapps/lutece/WEB-INF/conf/webmaster.properties
 file.dir.plugins=C:/tomcat/webapps/lutece/WEB-INF/conf/plugins

Renseigner ici les chemins complets des fichiers de log (ces champs sont automatiquement mis à jour quand la propriété autoInit=true)

# Logs files
 file.lutece.error.log=C:/tomcat/webapps/lutece/WEB-INF/logs/errors.log
 file.lutece.app.log=C:/tomcat/webapps/lutece/WEB-INF/logs/application.log
 file.pool.log=C:/tomcat/webapps/lutece/WEB-INF/logs/pool.log

Si error.page.debug=true, le détail de l'erreur s'affiche dans la page. Si error.page.debug=false, le message défini dans error.page.message s'affiche dans la page.

# Error page management
 error.page.debug=true
 error.page.message=Veuillez contacter immédiatement l'administrateur de l'application

Activer ou non la gestion du cache pour les templates, le contenu des pages ou les articles. En production, il est recommandé de mettre ces valeurs à true.

 # Caches management
 service.templates.cache.enable=false
 service.pages.cache.enable=false
 service.articles.cache.enable=false

Renseigner ici les chemins d'accès aux fichiers de log : application.log, error.log et pool.log.

 # log4j parameters
 log4j.rootLogger=WARNING, Error
 log4j.logger.lutece.error=ERROR, Error, Console
 log4j.logger.lutece.pool=ERROR, Error
 ...
 log4j.appender.Error.File=C:/tomcat/webapps/lutece/WEB-INF/logs/error.log
 log4j.appender.Application.File=C:/tomcat/webapps/lutece/WEB-INF/logs/application.log
 ...

Mise à jour du fichier db.properties

Choix du service de connexion :

  • LuteceConnectionService pour utiliser le pool de connexion de l'application Lutèce.
  • TomcatConnectionService pour utiliser le pool de connexion de Tomcat.
 portal.poolservice=fr.paris.lutece.util.pool.service.LuteceConnectionService

OU

portal.poolservice=fr.paris.lutece.util.pool.service.TomcatConnectionService

Renseigner ici le nom du pilote à charger pour la connection à une base MySQL.

portal.driver=org.gjt.mm.mysql.Driver

Renseigner portal.url pour identifier la source des données JDBC de la base Lutece. portal.user et portal.password renseignent le code et le mot de passe pour que l'application se connecte à la base lutece.

portal.url=jdbc:mysql://127.0.0.1
 /lutece?autoReconnect=true&useUnicode=yes& 
 characterEncoding=utf8
 portal.user=lutece
 portal.password=lutece

Renseigner ici le nombre de connexions que le pool doit créer lors de son initialisation.

portal.initconns=2

Renseigner ici le nombre maximal de connexions simultanées pour le pool portal.

portal.maxconns=20

Renseigner ici le temps maximum d'attente lors d'une connexion à la base de données (en millisecondes).

portal.logintimeout=2

Requête permettant de tester la validité de la connexion. La valeur varie selon la base de données concernée :

  • SELECT 1 pour une base de type MySQL
  • SELECT SYSDATE FROM dual pour une base Oracle.
portal.checkvalidconnectionsql=SELECT 1

Remarque : si vous modifiez un des fichiers properties, pensez à arrêter tomcat et à le relancer pour que les nouveaux paramètres soient pris en compte.

Le fichier webmaster.properties est également paramétrable. Une interface permet de le faire simplement depuis le module d'administration.

Il y a une erreur de communication avec le serveur Booktype. Nous ne savons pas actuellement où est le problème.

Vous devriez rafraîchir la page.