4.5-00 : release note du socle technique (juin 2003)

Contexte

Ce socle est le résultat de l'écrasement du socle 4.5.0 de Mars 2003 par le socle 5.0.0 lors de la fin des développements de la gestion des traces et des pools de connexion BDD.

Ce socle conserve le nom de version 4.5.0 en rapport à la version d'eGX qui correspond à sa mise en production,

Cette version est destinée à être mise en production pour la version 4.5.0 du mode web.

Modifications pour l'installation

Modifications d'environnement

Le socle technique utilise l'implémentation LOG4J version 1.2.8.

un nouveau fichier jar :

log4j-1.2.8.jar

Modifier fichier de démarrage de OC4J. Il doit contenir les quatre options suivantes en plus des autres déjà présentes :

Dlog4j.configuration=default_log4j.xml
DSessionClass=fr.ACE.technicalframework.business.applicationmodule.GnxSessionImpl
Djbo.initpoolsize=0
Djbo.maxpoolsize=0

Attention : ce fichier de démarrage devient spécifique à la version 4.5.0. Pour continuer de lancer OC4J pour les autres versions, il faut conserver une copie du fichier de démarrage précédent.

Modifier la configuration de l'application (fichier web.xml)

Le nom du fichier de paramétrage de LOG4J sera paramétrable par les variables d'environnements de la servlet, comme c'est déjà le cas pour le fichier de configuration d'eGX.

fichier : web.xml

< web-app >

< description > web Application </ description >

< context-param >

< param-name > egx_context_url </ param-name >

< param-value />

</ context-param >

< context-param >

< param-name > egx_traceconf_path </ param-name >

< param-value > default_log4j.xml </ param-value >

</ context-param >

< context-param >

< param-name > egx_configuration_path </ param-name >

< param-value > configuration.xml </ param-value >

</ context-param >

< context-param >

< param-name > egx_instance_name </ param-name >

< param-value />

</ context-param >

< servlet >

…

</ web-app >

fichier : orion-web.xml

< orion-web-app deployment-version =" 9.0.2.1.0 " jsp-cache-directory =" ./persistence " temporary-directory =" ./temp " internationalize-resources =" false " default-mime-type =" application/octet-stream " servlet-webdir =" /servlet/ ">

< context-param-mapping name =" egx_traceconf_path "> develop_log4j.xml </ context-param-mapping >

< context-param-mapping name =" egx_configuration_path "> configuration.xml </ context-param-mapping >

< context-param-mapping name =" egx_instance_name "> instance_SocleTechCourant </ context-param-mapping >

< virtual-directory virtual-path =" / " real-path =" ../../../default-web-app/egx450/btoc "/>

< resource-ref-mapping name =" jdbc/eGX-DS " location =" jdbc/OracleSoc1CoreDS "/>

</ orion-web-app >

Copier et/ou écraser des fichiers dans OC4J. (en 4.5.0 uniquement)
écraser les versions précédentes de configuration.xsd par celle qui se trouve dans le répertoire "doc/config".
copier dans la racine de chaque web module egx 4.5.0 les fichiers "develop_log4j.xml" et "log4j.dtd" que vous trouverez dans le répertoire "doc/config".
copier dans chaque répertoire "classes" des web module, les fichiers "default_log4j.xml" et "log4j.dtd" que vous trouverez dans le répertoire "src".

Ajouts dans le fichier de configuration

La gestion des traces nécessite l'ajout d'un ApplicationModule et de trois actions.

Modèle de configuration :

< applicationmodule name =" AdminManager " defFullName =" fr.ACE.technicalframework.businesscomponent.applicationmodule.AdminManager " sessionType =" statefull "/>

< action name =" trace_reload " class =" fr.ACE.technicalframework.application.action.TraceReload "/>

< action name =" trace_enable " class =" fr.ACE.technicalframework.application.action.TraceEnable ">

< required >

< param name =" loggerName " type =" String "/>

</ required >

</ action >

< action name =" trace_disable " class =" fr.ACE.technicalframework.application.action.TraceDisable ">

< required >

< param name =" loggerName " type =" String "/>

</ required >

</ action >

Modifications de la structure du fichier de configuration

deconnectFrequency

Ce nouvel attribut de l'élément "business_session" permet de paramétrer la fréquence de déconnexion au SGBD.

Valeurs possibles

Valeurs	Signification
none	Pas de déconnexion automatique.
session	Déconnexion à la fin de la session http.
request	Déconnexion à la fin du traitement de chaque requête. Voir les limites ci dessous.

Exemple de paramétrage

< business_session defFullName =" fr.generix.metier.bc4j.parametrage.SessionMetier " lockingMode =" pessimistic " sessionType =" statefull " minInstance =" 1 " maxInstance =" 25 " deconnectFrequency =" request "/>

Cohérence du paramétrage

Cette gestion de la fréquence de déconnexion est principalement utilisée dans le cadre de la gestion des pools de connexion.

Rappel :

Deux modes de connexion à la base sont disponibles dans eGX:

L'utilisation des "data source" (géré par le serveur d'application, pool de connexion possible)
Saisie directe de la chaîne de connexion (dans le fichier de configuration, pas de pool de connexion )

Pour des raisons de performance, il y a une incompatibilité de paramétrage entre une fréquence de déconnexion trop rapide et le paramétrage par chaîne de connexion.

type de connexion	Fréquence demandée	none	session	request
data source		none	session	request
chaîne de connexion		none	session	session

En cas de paramétrage incohérent, la trace contiendra un message d'information.

Limite

Taille des libellés

La taille maximum des libellés des messages est de 80 caractères. (taille du champ libut_mes)

Evolutions diverses

Fichiers XML de présentation

Un fichier par frame.

Libération de la connection BDD

selon trois fréquences : none, session, request.

Nouvelles cinématiques

rechargement du fichier de configuration des traces :

cinematic=trace_reload();display(0)

activation et désactivation des traces:

trace timer

cinematic=trace_enable(timer);display(0)

cinematic=trace_disable(timer);display(0)

trace data

cinematic=trace_enable(data);display(0)

cinematic=trace_disable(data);display(0)

date	auteur	version	modif
10/04/03	TIF	1.0	· modification pour l'installation par rapport à LOG4J.
04/06/03	CAF	1.0	· Ajout d'infos pour le paramétrage de Log4J et sur l'attribut "deconnectFrequency".
13/06/03	TIF	1.0	· Ajout de jbo.initpoolsize=0 et jbo .maxpoolsize =0
17/06/03	TIF	1.0	· Ajout de détails pour les modifications de l'installation.