Configuration

Manuel de configuration de InterLDAP-ATE v 0.9.1.

Fichier de configuration

Les paramètres de configuration sont inscrits dans le fichier suivant :

# vi /etc/interldap/atransport-engine.conf

Ces paramètres respectent la syntaxe de configuration suivante :

domaine.propriete = valeur

Programme de traitement

Ce programme est appliqué aux fichiers avant leur envoi. Il est facultatif. Le nom du fichier est passé au programme à travers la macro %f.

treatment.program = /var/lib/interldap/atransport-engine/bin/treatment.pl %f

Paramètres d'exécution

Répertoire principal

Tous les fichiers manipulés par le programme y résident. Ne pas oublier le « / » à la fin.

exec.install_dir = /var/lib/interldap/atransport-engine/

Sous-répertoire d'entrée

C'est là que sont déposés les fichiers de données et leurs en-têtes. Il est situé dans le répertoire principal. Ne pas oublier le « / » à la fin.

exec.input_subdir = input/

Sous-répertoire d'échange

Dès que les fichiers sont lus dans le répertoire d'entrée, ils sont déplacés dans ce répertoire pour être traités. Il est situé dans le répertoire principal. Ne pas oublier le « / » à la fin.

exec.fifos_subdir = fifos/

Sous-répertoire des fichiers traités

Lorsque le traitement des fichiers est terminé, ceux-ci sont déplacés dans ce répertoire. Il est situé dans le répertoire principal. Ne pas oublier le « / » à la fin.

exec.done_subdir = done/

Sous-répertoires des fichiers en erreur

En cas d'erreur de traitement, les fichiers sont déplacés dans ce répertoire. Il est situé dans le répertoire principal. Ne pas oublier le « / » à la fin.

exec.error_subdir = error/

Fréquence d'analyse du répertoire d'entrée

C'est le temps en secondes entre chaque analyse du répertoire d'entrée.

exec.time_between_distributions = 2

Fréquence des envois

C'est le temps en secondes entre deux envois consécutifs de fichiers.

exec.time_between_sending = 1

Paramètres de messagerie

Remarque : ces paramètres ne sont utilisés que pour le protocole SMTP.

Nom de l'expéditeur

C'est le nom qui apparaîtra dans le champ « FROM » du message électronique.

mail.from_name = InterLDAP atransport-engine

Adresse de l'expéditeur

C'est l'adresse qui apparaîtra dans le champ « FROM » du message électronique. Il est possible d'utiliser les macros suivantes :

  • %u : identifiant UNIX de l'utilisateur exécutant le programme atransport-engine.
  • %h : nom DNS complet de la machine (FQDN).
mail.from_address = %u@%h

Sujet du message

C'est ce qui apparaîtra comme sujet du message électronique. La macro %f peut être utilisée pour le nom du fichier transféré.

mail.subject = [atransport-engine] transfer of %f

Paramètres des traces applicatives

Remarque : la syntaxe de ces paramètres est calquée sur celle de log4j.

Niveau et nom du flux

Le niveau de trace peut être choisi parmi la liste suivante :

  • DEBUG
  • INFO
  • WARN
  • ERROR
  • FATAL
Ces niveaux sont inclus les uns dans les autres, c'est-à-dire que choisir le niveau WARN active également les niveaux ERROR et FATAL. Ils déterminent la nature des messages qui seront tracés, un niveau DEBUG prend toutes les traces, tandis que le niveau FATAL ne prendra que les messages d'arrêts inopportuns du programme. Le niveau WARN est généralement utilisé en production.

Un ou plusieurs noms peuvent être ensuite inscrits, ils permettent de définir les flux qui seront ensuite configurés. Il est courant de les nommer en fonction du type de sortie utilisée.

log4perl.rootLogger = WARN, SYSLOG

Type de sortie

C'est ici qu'est déterminé le type de sortie du flux. De nombreux types sont disponibles :
  • Log::Log4perl::Appender::Screen
  • Log::Log4perl::Appender::ScreenColoredLevels
  • Log::Log4perl::Appender::File
  • Log::Log4perl::Appender::Socket
  • Log::Log4perl::Appender::DBI
  • Log::Log4perl::Appender::Synchronized
  • Log::Log4perl::Appender::RRDs
  • Log::Dispatch::ApacheLog
  • Log::Dispatch::DBI
  • Log::Dispatch::Email,
  • Log::Dispatch::Email::MailSend,
  • Log::Dispatch::Email::MailSendmail,
  • Log::Dispatch::Email::MIMELite
  • Log::Dispatch::File
  • Log::Dispatch::FileRotate
  • Log::Dispatch::Handle
  • Log::Dispatch::Screen
  • Log::Dispatch::Syslog
  • Log::Dispatch::Tk
Par défaut, c'est syslog qui est utilisé.

log4perl.appender.SYSLOG = Log::Dispatch::Syslog

Facilité syslog

Lorsque syslog est choisi, il est possible de configurer sa facilité. Cette facilité est ensuite associée aux fichiers de trace du système à travers la configuration de syslog, indépendante de atransport-engine :

# vi /etc/syslog.conf

log4perl.appender.SYSLOG.facility = dameon

Format de sortie

Cela permet de configurer le format des messages de sortie :
  • SimpleLayout : niveau – message.
  • PatternLayout : basé sur des macros.
log4perl.appender.SYSLOG.layout = PatternLayout

Macros du format de sortie

Si PatternLayout est choisi, il est possible de personnaliser les messages à partir des macros suivantes :

  • %c : catégorie du message.
  • %C : nom complet du paquet (ou de la classe) produisant le message.
  • %d : date au format AAA/MM/JJ hh:mm:ss.
  • %F : nom du fichier où a eu lieu l'erreur.
  • %H : nom d'hôte.
  • %l : description complète de la méthode, du fichier et de la ligne responsable de l'erreur.
  • %L : numéro de la ligne où a eu lieu l'erreur.
  • %m : le message en lui-même.
  • %M : méthode ou fonction où a eu lieu l'erreur.
  • %n : retour à la ligne.
  • %p : niveau de trace concerné.
  • %P : PID du processus.
  • %r : nombre de millisecondes depuis le démarrage du programme.
log4perl.appender.SYSLOG.layout.ConversionPattern = [%p][%M] %m%n