PROCEDURE INSTALLATION MOD_JK / JONAS4.8.x Table des

PROCEDURE INSTALLATION MOD_JK / JONAS4.8.x
Par JL PASTUREL
Table des matières
1CONTEXTE DE L’INSTALLATION...............................................................................................1
2INSTALLATION MOD_JK.............................................................................................................. 1
3COMMENT CA MARCHE EN DEUX MOTS................................................................................ 2
4CONFIGURATION........................................................................................................................... 3
4.1Fichier httpd.conf........................................................................................................................3
4.2Fichier workers.properties.......................................................................................................... 4
4.3Fichier server.xml....................................................................................................................... 4
1 CONTEXTE DE L’INSTALLATION
Poste Windows XP
Apache 2.2.4 sous C:\opt\apache224
Mod_jk : mod_jk-apache2.2.3.so
Jonas 4.8.3 :
JONAS_ROOT = C:\opt\JOnAS-4.8.3
JONAS_BASE = C:\opt\jonas_base
On suppose que l’installation de JONAS avec la création de JONAS_BASE ne pose pas problême
pas plus que l’installation de Apache qui est sous la forme d’un setup.exe classique sous Windows.
A noter que l’installation de mod_jk sera semblable sur un système unix. Le test a été fait sur une
version 4.8.3 de JONAS, cela doit marcher avec d’autres versions 4.x.
On notera aussi que l’installation faite ici n’est qu’une installation d’un serveur Apache en frontal
d’un serveur JONAS, il n’y a pas ici de mécanisme de load-balancing ou de fail-over. Il ne s’agit en
aucun cas de la mise en cluster. Pour cela se reporter à la documentation JONAS pour cette mise en
place avec le protocole CMI.
2 INSTALLATION MOD_JK
Récupérer sur le site de Apache le mod_jk aussi appelé Tomcat Connector à l’URL suivante :
http://tomcat.apache.org/connectors-doc/
Suivre le site de download du binaire et choisir le module correspond à votre système
d’exploitation et à votre version d’apache ( prendre la plus approchante 2.2.3 pour mon cas )
Copier le binaire : mod_jk-apache-2.2.3.so sous l’arborescence des modules d’apache.
Pour mon cas sous C:\opt\apache224\modules
et c’est tout pour l’installation! mais faut configurer diverses choses.
Mais avant cela, voir paragraphe suivant:
3 COMMENT CA MARCHE EN DEUX MOTS
http
1
Contexte Apache
2
APACHE
httpd.conf
3
mod_jk
ajp13
4
workers.properties
6
Contexte JONAS
JONAS
TOMCAT
Connector
5
server.xml
Containers
EJB/JMS/WS/JDBC
N°
Explication
1
Arrivée d’une requête http sur le serveur Apache
2
A l’aide du contexte* de la requête, détermination du module de traitement par
Apache. Voir extrait du fichier httpd.conf (placé sous <APACHE_ROOT>/conf)
dans le paragraphe suivant
3
Correspond au cas du traitement de la requête via mod_jk. A l’aide du contexte de
la requête, association d’un worker chargé de la traiter. Localisation du fichier
workers.properties (On peut placer ce fichier au même endroit que httpd.conf : ce
fichier contient toutes les configurations des workers)
4
Récupération dans le fichier worker.properties, de la configuration du worker
chargé de traiter la requête et en particulier :
- adresse et port du connector listener de Tomcat chargé de traiter la requete.
5
Lors du lancement de JONAS, il faut que le Connecteur listener du protocole
N°
Explication
ajp13** soit lancé sur le bon port décrit dans le point 4. C’est dans le fichier
server.xml (placé sous <JONAS_BASE>/conf) que se paramètre ce connecteur.
Voir paragraphe suivant..
6
Traitement de la requête si les étapes précédentes se sont bien déroulées.
*Le contexte de la ressource correspond au chemin d'accès de la ressource et la ressource sur le
serveur.Par exemple cela correspond à ce qui en gras dans =>
http://localhost/monAppli/maPageJsp.jsp
** ajp13 = Apache Java Protocol version 1.3
4 CONFIGURATION
4.1 Fichier httpd.conf
Positionné sous <APACHE_ROOT>/conf
Extraits des rajouts à insérer pour la prise en compte de mod_jk.
A la partie des chargements de modules ( ligne commençant par LoadModule ), rajouter les lignes
suivantes :
## JLP rajout module mod_jk
LoadModule jk_module modules/mod_jk-apache-2.2.3.so
Puis rajouter le paragraphe <IfModule> correspondant à mod_jk comme indiqué ci-dessous :
#Rajout de mod_jk
<IfModule jk_module>
# Ou trouver workers.properties ?
JkWorkersFile /opt/apache224/conf/workers.properties
# Ou mettre la memoire partagee de jk
JkShmFile /opt/apache224/logs/mod_jk.shm
# Ou mettre les logs jk
JkLogFile /opt/apache224/logs/mod_jk.log
# Positionner le niveau des logs jk [debug/error/info]
JkLogLevel info
# Selectionner lef ormat des logs pour le timestamp
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
#Format des logs
JkRequestLogFormat "%w %m %V %T"
# Envoyer les contextes dont le nom commence par test : /test* vers le worker nommé worker1
JkMount /test*/* worker1
# On peut placer ici plusieurs JkMount si on a plusieurs contextes traites
# par des workers differents
</IfModule>
4.2 Fichier workers.properties
Positionné sous <APACHE_ROOT>/conf
Il s’agit ici d’un fichier minimal qui permet de démarrer. Voir ensuite la documentation Apache
Tomcat connector pour d’autres paramètres à l’URL suivante.
http://tomcat.apache.org/connectors-doc/reference/workers.html
# Define 1 workers
worker.list=worker1
# Set properties for worker1 (ajp13)
worker.worker1.type=ajp13
worker.worker1.host=localhost
worker.worker1.port=8009
4.3 Fichier server.xml
Il s’agit d’un fichier de configuration de Tomcat dans Jonas
Positionné sous <JONAS_BASE>/conf:
Dans ce fichier il suffit de rendre actif l’élément xml correspondant au listener mod_jk comme
indiqué dans l’extrait ci-dessous.
<!-- Define an AJP 1.3 Connector on port 8009-->
<Connector port="8009"
enableLookups="false" redirectPort="9043" protocol="AJP/1.3" />
Les traces de démarrage de Jonas montre ce listener :
2007-01-28 11:51:33,328 : INFO : jonas Main : Logger.logp :
2007-01-28 11:51:33,359 : INFO : jonas Main : Logger.logp :
JK: ajp13 listening on /0.0.0.0:8009
Jk running ID=0 time=0/94 config=null