Configuration de base
La configuration de base ne s'effectue que dans le fichier suivant :
filters/esup.properties
################################################################################
## Configuration logs ##
################################################################################
environment.build.log.logfileDirectory=/home/esup4/logs
environment.build.log.logfileName=uPortal.log
environment.build.log.rootLevel=INFO
environment.build.log.layoutConversionPattern=[${environment.build.host.logicalName}]%5p [%t] %d{MMM/dd HH:mm:ss,SSS} %c{2}.[%x] - %m%n
environment.build.log.rollingLogFileDatePattern='.'yyyy-MM-dd-HH
Type de logger
Le logger est préconfiguré pour être un DailyRollingFileAppender. Il n'est pas possible d'en changer dans le fichier esup.properties.
Voici les détails des éléments de configuration :
Propriété | Définition | Détails supplémentaires |
|---|---|---|
environment.build.log.logfileDirectory | Dossier où sont stockés les fichiers de logs | Il est possible d'utiliser le séparateur slash ("/") sous Linux et Windows |
environment.build.log.logfileName | Nom du fichier de log pour le portail | Le choix du nom est libre |
environment.build.log.rootLevel | Niveau de log minimal pour lequel on souhaite garder les traces | Peut prendre les valeurs listées sur cette page |
environment.build.log.layoutConversionPattern | Format de la ligne de log | Doit se conformer au pattern PatternLayout |
environment.build.log.rollingLogFileDatePattern | Format de la date utilisé dans le nommage des fichiers lors de leur journalisation | Doit se conformer au pattern SimpleDateFormat |
Cette configuration impacte les applications suivantes :
uPortal
cas-proxy-test-portlet
cas
BookmarksPortlet
widget-portlets
WebProxyPortlet
WeatherPortlet
testsuite
NotificationPortlet
newsreader
FunctionalTestsPortlet
email-preview-portlet
Configuration avancée : SYSLOG
Prérequis
Avant de configurer le syslog pour uPortal, il faut posséder un serveur syslog et connaître son IP.
OPTIONNEL : Si vous désirez configurer le serveur syslog :
Couper le serveur syslog :
service syslog stop
Autoriser les connexion remote pour le serveur syslog. Ajouter l'option -r dans le fichier suivant :
/etc/sysconfig/syslogSYSLOGD_OPTIONS="-rm 0"
Redémarrer le service syslog
service syslog restart
Autoriser le firewall à laisser passer les messages :
iptables -I INPUT -p udp -i eth0 -s <IP_SERVEUR_SYSLOG> -d <IP_CLIENT_SYSLOG> --dport 514 -j ACCEPT
Il est également bon d'ajouter cette commande dans le fichier /etc/rc.local pour qu'elle soit exécutée lors du démarrage de la machine.
OBLIGATOIRE : Afin de configurer les applications pour envoyer les logs au serveur syslog, il faut procéder comme suit :
- Modifier chaque fichier de configuration de log, de :...\uportal-portlets-overlay\<PortletName>\src\main\webapp\WEB-INF\log4j.properties
log4j.appender.R=org.apache.log4j.DailyRollingFileAppender log4j.appender.R.File=/xxx/xxx/xxx/xxx.log log4j.appender.R.DatePattern='.'yyyy-MM-dd-HH log4j.appender.R.Encoding=UTF-8
En :...\uportal-portlets-overlay\<PortletName>\src\main\webapp\WEB-INF\log4j.propertieslog4j.appender.R=org.apache.log4j.net.SyslogAppender log4j.appender.R.SyslogHost=<IP_SERVEUR_SYSLOG> log4j.appender.R.Facility=LOCAL0
La nouvelle configuration sera prise en compte au prochain redéploiement. Il faut également autoriser le firewall à laisser passer les messages. Sous UNIX :
iptables -I OUTPUT -p udp -i eth0 -s <IP_SERVEUR_SYSLOG> -d <IP_CLIENT_SYSLOG> --dport 514 -j ACCEPT
Sous Windows, cela dépend du firewall utilisé.
De plus, il est bon d'ajouter cette commande dans le fichier /etc/rc.local pour qu'elle soit exécutée lors du démarrage de la machine.- Redémarrer Tomcat
Références