Introduction

Apache est un serveur Web : il reçoit des requêtes HTTP émises depuis un navigateur, les analyse et envoie des pages Web en réponse au navigateur.

Lorsque les requêtes HTTP concernent des pages JSP (Java Server Pages), du code Java doit être exécuté pour construire les pages Web qu'Apache doit renvoyer au navigateur. Pour cela, Apache s'appuie sur un moteur de servlets qui prend en charge cette partie du traitement. Tomcat est l'un des moteurs de servlets les plus utilisés.

Pour communiquer entre eux, Apache et Tomcat utilisent un module intermédiaire, tel que mod_jk.

L'objet de cette fiche est de présenter les différentes étapes de l'installation de base d'Apache, Tomcat et mod_jk.

Installation d'Apache

Installation des paquets

Il faut commencer par installer le paquet apache2, ainsi que d'autres paquets apache et php qui peuvent s'avérer utiles.
Par exemple, avec Debian :

Fichiers de configuration d'Apache

Apache2 est en général installé dans /etc/apache2. Ce répertoire contient apache2.conf, le fichier de configuration principal d'Apache.

Remarque : apache2.conf peut faire appel à d'autres fichiers de configuration, via la directive "Include". Ainsi, lorsqu'on décrit des modifications à apporter à apache2.conf, il se peut selon les configurations que ces modifications soient à apporter dans d'autres fichiers inclus par apache2.conf.

Test de l'installation d'Apache

• Pour lancer le serveur Apache :

• Pour tester Apache :

Depuis un navigateur, aller à l'adresse http://localhost/. Une page vide doit s'afficher.

• Si cela ne fonctionne pas:
  • Vérifier si le port par défaut est bien le port 80 : le fichier /etc/apache2/ports.conf doit contenir :

• • Regarder les fichiers de log dans /var/log/apache2.
  • après modification, relancer Apache :

• Pour arrêter Apache :

• Pour afficher des pages HTML qui ne nécessitent pas de gestion de jsp (et qui peuvent être traitées directement par Apache, sans passer par Tomcat) : copier les fichiers HTML correspondants dans le répertoire /var/www (qui correspond par défaut à la racine du site http://localhost/).

Personnalisations d'Apache

Il faut ensuite activer les modules ssl, rewrite, suexec et include d'Apache : il s'agit de créer depuis le répertoire /etc/apache2/mods-enabled des liens symboliques vers les modules du répertoire /etc/apache2/mods-available dont on a besoin :

Ensuite, il faut relancer Apache :

Installation de JDK

Tomcat a besoin des bibliothèques Java disponibles dans le paquet contenant le JDK (Java Development Kit).

Pour l'installer (par exemple depuis Debian)

Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de JDK, on va utiliser un lien symbolique /usr/lib/jdk qui pointera sur la version de JDK de votre choix :

Installation de Tomcat

Installation des paquets

Il faut commencer par installer les paquets tomcat qui nous seront utiles.
Par exemple, avec Debian :

Lien symbolique qui pointe vers la bonne version de Tomcat

Pour ne pas avoir besoin de modifier tous les fichiers de configuration lorsque vous changerez de version de Tomcat, on va utiliser un lien symbolique /usr/lib/apache-tomcat qui pointera sur la version de Tomcat de votre choix :

Remarque : ce répertoire est référencé en tant que CATALINA_HOME dans la documentation Tomcat.

Fichiers de configuration de Tomcat

Tomcat est en général installé dans /etc/tomcatxxx. Ce répertoire contient entre autres les fichiers de configuration suivants :

• server.xml : permet de configurer les ports à utiliser. En général, le port HTTP est le port 8080 (ou 8180), et la communication avec le serveur Apache via mod_jk se fait sur le port 8009.
• web.xml : permet de définir la configuration des servlets de vos applications Java.
• tomcat-users.xml : permet de définir les utiliseurs et leurs droits. Il faut définir au moins un rôle "admin" et un utilisateur "admin" pour pouvoir administrer Tomcat :

Test de l'installation de Tomcat

• Pour lancer le serveur Tomcat :

• Pour tester Tomcat :
  • Regarder dans le fichier de configuration /etc/tomcatxxx/server.xml le numéro de port HTTP utilisé (en général, 8080 ou 8180).
  • Depuis un navigateur, aller à l'adresse http://localhost:8080 (ou http://localhost:8180 selon votre configuration). La page d'accueil de Tomcat, contenant une présentation de Tomcat, doit s'afficher.
• Si cela ne fonctionne pas, regarder les fichiers de log dans /var/log/tomcatxxx.
  • après modification, relancer tomcat :

• Pour arrêter Tomcat :

Installation de mod_jk

Installation des paquets

Par exemple, sous Debian :

Cette commande crée en particulier un fichier /usr/lib/apache2/modules/mod_jk.so correspondant au module mod_jk.

configuration de mod_jk

Tout d'abord, il faut indiquer à Apache comment utiliser mod_jk :

• Créer un fichier /etc/apache2/workers.properties (s'il n'existe pas), et indiquer les informations suivantes :

worker1 (on peut modifier ce nom) correspond aux caractéristiques du module mod_jk qui sera utilisé pour communiquer avec Tomcat : port 8009, machine localhost, protocole ajp13...

• Indiquer à Apache le chemin du fichier workers.properties (si ce n'est pas fait) ainsi que d'autres informations utiles : pour cela, il faut mettre à jour le fichier /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf), en indiquant les informations suivantes :

Il faut aussi faire figurer la référence à worker1 lors de la définition des hôtes virtuels (exemple : /etc/apache2/sites-enabled/000-default) :

Test de mod_jk

• Avant de tester mod_jk, il faut relancer Apache et Tomcat.

Remarque : il faut toujours lancer Tomcat en premier : lors du lancement d'Apache, le fichier de configuration de mod_jk est lu, et Apache sait alors qu'à tout moment il peut communiquer avec Tomcat via le port 8009. Il est donc préférable de lancer préalablement Tomcat, qui sera en attente de requêtes sur le port 8009.

• Ensuite, il faut vérifier qu'Apache fonctionne sur le port 80 (http://localhost/), et que Tomcat fonctionne sur le port 8080 (http://localhost:8080/) ou 8180 (http://localhost/:8180) selon votre configuration.
• Enfin, il faut vérifier que les requêtes aux adresses configurées via les directives JkMount dans /etc/apache2/mods-available/jk.load (ou, à défaut, /etc/apache2/apache2.conf) fonctionnent. Dans notre cas, l'adresse /jsp-examples qui, sous Tomcat, contient des exemples de jsp :
  • On vérifie que Tomcat contienne bien ces exemples, en allant voir directement dans le répertoire correspondant de Tomcat : http://localhost:8080/jsp-examples ou http://localhost:8180/jsp-examples selon votre configuration.
  • On vérifie qu'Apache redirige correctement les requêtes vers /jsp/examples à Tomcat, qui doit renvoyer à Apache la même page que celle obtenue précédemment en faisant directement la requête à Tomcat : http://localhost/jsp-examples

Installation terminée

A ce stade, vous pouvez :

• Définir des pages HTML traitées directement par Apache, en créant des fichiers HTML dans /var/www
• Définir des servlets et les intégrer dans Tomcat grâce au Tomcat Manager, accessible depuis le lien symbolique "Tomcat Manager" depuis la page d'accueil de Tomcat (http://localhost:8080/ ou http://localhost:8180/ selon votre configuration). Pour cela, il faut utiliser le login et le mot de passe "admin" définis dans /etc/tomcatxxx/tomcat-users.xml.

@ Retour à la rubrique Réseau et sécurité

Copyright

© 2008 Utilisateur:Nulix31

Ce document est publié sous licence Creative Commons Attribution, Partage à l'identique 2.0 : http://creativecommons.org/licenses/by-sa/2.0/