|
Le Guide d'installation de Tomcat pour Windows
25 novembre 2001
Intégration avec Apache / Conclusion
L'intégration de Tomcat et d'Apache se fait par l'intermédiaire
du module mod_webapp.
Assurez-vous tout d'abord de disposer d'une installation fonctionnelle d'Apache.
Télécharger ensuite mod_webapp via notre section Téléchargement,
rubrique Tomcat.
Décompactez le contenu de l'archive téléchargée
dans le sous-répertoire modules d'Apache.
Editez le fichier httpd.conf et, dans la section 1, dans la partie relative
aux modules, ajoutez la ligne suivante après toute autre concernant le
chargement de modules optionnels :
LoadModule webapp_module modules/mod_webapp.so
et un peu plus loin
AddModule mod_webapp.c
Ajoutez ensuite les lignes suivantes juste avant la section 3 (consacrée
aux hôtes virtuels) :
# Tomcat
<IfModule mod_webapp.c>
WebAppConnection warpConnection warp localhost:8008
WebAppDeploy examples warpConnection /examples/
WebAppInfo /webapp-info
</IfModule>
Voici une description des directives utilisées :
WebAppConnection warpConnection warp localhost:8008
Indique à Apache d'établir une connexion avec Tomcat par l'intermédiaire
d'un processus spécifique, Warp, écoutant sur le port 8008.
Un bref aperçu de la directive ci-dessus :
WebAppConnection [connection name] [provider] [host:port]
[connection name]
Un nom qui va être utilisé pour décrire la connexion entre
Apache et Tomcat.
[provider]
Le nom du fournisseur de service permettant de se connecter à Tomcat.
Actuellement, seul le mot-clé "warp" est utilisable.
[host:port]
Le couple nom d'hôte:port décrivant le nom du serveur Tomcat et
le port utilisé pour se connecter au fournisseur de service décrit
ci-dessus.
Il faut remplacer localhost par le nom du serveur Tomcat si Apache et Tomcat
ne sont pas sur la même machine.
Le port utilisé pour la connexion entre Apache et Tomcat est défini
dans le fichier server.xml, dans la section "org.apache.catalina.connectors.warp.WarpConnector",
pas la section HTTP. Ce fichier peut être trouvé dans le sous-répertoire
conf de Tomcat.
WebAppDeploy examples warpConnection /examples/
Cette directive indique de "déployer", c'est-à-dire
mettre à disposition une application Web.
Dans le cas présent, nous déployons une application nommée
"examples" (à laquelle correspond un sous-répertoire
examples dans le répertoire webapps de Tomcat), accédée
par Apache au travers de la connexion "warpConnection" et disponible
pour l'utilisateur à l'URL "/examples/".
Voici le détail de la directive ci-dessus :
WebAppDeploy [application name] [connection name] [url path]
[application name]
Le nom de l'application Web correspond à un répertoire dans le
sous-répertoire webapps de Tomcat. Celui-ci contient une structure
complète décrivant l'application.
Si l'application se présente sous la forme de fichier portant l'extension
"war", il convient de spécifier le nom du fichier, par exemple
"monApplication.war".
[connection name]
Le nom de connexion précédemment déclaré au niveau
de la directive WebAppConnection..
[url path]
L'URL par laquelle l'application Web sera joignable.
La directive "WebAppDeploy" est liée à la déclaration
d'un hôte. Ainsi, si une directive "WebAppDeploy" se trouve
déclarée au niveau d'une section <VirtualHost..>, l'application
Web ne sera disponible que pour cet hôte virtuel.
WebAppInfo /webapp-info
Cette dernière directive permet de connaître le statut de toutes
les connexions configurées et des applications déployées.
Son utilisation est très simple : WebAppInfo /URL
Le statut du serveur Tomcat pourra être consulté à l'URL
http://server.name:port/webapp-info/ (le "/" à la fin est indispensable).
Après avoir modifié le fichier httpd.conf, stoppez et rédemarrez
Apache.
Dans votre navigateur, saisissez l'URL suivante : http://nomduserveurApache/webapp-info/.
Vous devriez voir apparaître le contenu suivant :
Rendez-vous ensuite à l'URL http://nomduserveurApache/examples/jsp/index.html.
La page suivante devrait apparaître :
Au terme de cet article, vous devriez disposer d'une plate-forme permettant
de développer des applications Web basées sur Java.
Attention : j'ai relevé de gros problèmes d'instabilité
lors de l'utilisation de Tomcat au travers d'Apache alors que Tomcat seul fonctionne
parfaitement. J'attends de tester la même fonctionnalité sur Linux
pour comparer. Si quelqu'un a des indications complémentaires, n'hésitez
pas à poster un message dans le Forums
Tomcat.
|
