Apache Tomcat

1. Présentation

Créer un site web dynamique est possible grâce à différentes technologies, comme ASP, JSP, Python, PHP. Ce document présente simplement la méthode d'installation d'un serveur Jakarta Tomcat, qui est un conteneur Java vous permettant de développer vos sites en Java (JSP, Servlets). Tomcat est l'implémentation de référence (RI) de Sun Microsystems concernant la JSR 154: Java Servlet 2.4, ainsi que la JSR 152: JavaServer Pages 2.0.

Pour le moment, ce tutoriel d'installation concerne le système d'exploitation Microsoft Windows. Néanmoins les étapes d'installation sont plus ou moins les mêmes pour une installation sous Linux.

2. Installer le JRE/JDK de Sun Microsystems

Tomcat 5.5.12 nécessite nativement J2SE 5.0 pour pouvoir fonctionner, néanmoins il est possible de rajouter un package de compatibilité pour une version inférieure 1.4.x.

De plus, Tomcat 5.5.12 utilise Eclipse JDT Java Compiler pour compiler les JSP, vous n'avez donc pas besoin d'installer un JDK (Java Development Kit) complet, un simple JRE (Java Runtime Environnement) suffira. Tomcat est d'ailleur configurable, si vous désirez compiler les JSPs et Servlet avec un autre compilateur que Eclipse JDT Java Compiler. Vous pouvez installer un JDK version 1.4.x de Sun en suivant le procédé d'installation pour Windows décrit sur cette page.

3. Installer Jakarta Tomcat 5.5.12

3.0. Télécharger Apache Tomcat

Le projet Jakarta Tomcat est un projet issu de la fondation Apache. Vous pouvez donc librement le télécharger à l'adresse http://tomcat.apache.org/download-55.cgi. Il vous en coutera au total une petite dizaine de Mo pour les versions EXE/ZIP pour Windows que nous allons installer.

Apache Tomcat 5.5.12 - Download


Voici donc la nouveauté: on ne télécharge plus une seule archive contenant le conteneur Java et les applications utilitaires, mais n archives (ou *.exe pour Windows) scindées par nature. On appréciera d'ailleurs cette nouvelle façon de procéder, permettant ainsi de bien différencier les différents modules nécessaires à Tomcat et leurs fonctionnalités.

Ces différents modules sont donc:

  • "Core": Il s'agit du module de base, c'est à dire du conteneur Servlet 2.4 et JSP 2.0 et des interfaces standards (déploiement par exemple). Il est indispensable.
  • "Deployer": C'est un module autonome de déploiement d'applications Web (Tomcat Client Deployer: TCD). Il s'agit en fait d'un script Ant (build.xml) qui permet de valider, compiler et déployer une application Web.
  • "Embedded": Distribution à utiliser si vous utilisez Tomcat dans un environnement embarqué (c'est à dire instancié à partir d'un autre programme Java).
  • "Administration Web Application": Distribution qui contient l'interface d'administration avancée (gestion utilisateurs, ressources, contextes...)
  • "JDK 1.4 Compatability Package": Vous devrez installer ce module si vous voulez utiliser Tomcat 5.5 avec une machine virtuelle version 1.4.x.
  • "Documentation": Documentation de Tomcat et des spécifications et API pour Servlet/JSP. Il peut être installé directement avec la version "Core"

Pour l'installation que je vous propose, nous n'aurons besoin que des distributions "Core", "Administration Web Application" et "JDK 1.4 Compatability Package".

Je vous conseille fortement, dans un environnement de production avec les contraintes sous-entendues, d'installer strictement le minimum de ces modules. On peut réaliser certaines opérations en ligne de commande au lieu d'installer une WebApp WAR plus "lourde". De plus Tomcat 5.5.x est conçu pour fonctionner nativement avec une JVM 5.0, vous pouvez utiliser une JVM 1.4.2, mais vous ne bénéficierez pas des toutes dernières améliorations et optimisations du serveur.

3.1. Installation des différents packages

3.1.1. Le package de base ou "Core"

Après avoir téléchargé l'exécutable pour Windows (apache-tomcat-5.5.12.exe), exécutez-le puis suivez simplement le mode opératoire ci dessous:

Tomcat Core Installation

Lisez et acceptez la licence ASL (Apache Software Licence).

Tomcat Core Installation

Sélectionnez le mode d'installation "Custom" (personnalisé) et assurez vous que les éléments suivants sont sélectionnés:

  • - Service: il s'agit d'un des avantages de passer par un programme d'installation pour Windows: il vous permet d'installer automatiquement le service Windows automatiquement. Vous pourrez directement agir au niveau de son exécution (si plusieurs échecs consécutifs lors du démarrage, démarrage automatique à l'allumage du PC, etc...)
  • - Native: l'installateur configure Tomcat pour utiliser certaines librairies natives dépendantes de la plateforme. L'avantage est au niveau des performances, en environnement de production il est préférable de choisir cette option.
  • - Documentation: vous pouvez l'installer, mais un autre package permet également de la télécharger de manière indépendante...
Tomcat Core Installation

Vous pouvez modifier le répertoire d'installation de Tomcat. Pour la suite de ce tutoriel, le répertoire d'installation sera exprimé par TOMCAT_HOME.

Tomcat Core Installation

Le port HTTP étant le 80, il est préférable de choisir un numéro de port différent. Traditionnellement, il s'agit du port 8080.
On vous propose également ici de changer les paramètres du compte administrateur "admin". Renseignez un mot de passe pour cet utilisateur. Préferez un mot de passe sécurisé, c'est à dire combinant lettre, chiffres et caractères spéciaux (%,_,etc...). Inutile de rappeler que dans un environnement de production il est déconseillé de laisser les paramètres par défaut, même si, à priori, votre serveur Tomcat se situe topologiquement derrière une DMZ (Zone Démilitarisée: machines situées entre une zone publique et une zone interne), un Firewall, dans une zone privée.

Tomcat Core Installation

Ensuite, l'assistant vous propose de sélectionner un JRE (Java Runtime Environment), sélectionnez donc celui que vous avez choisi d'utiliser (5.0 conseillé, mais pour ce tutoriel nous utiliserons un 1.4.2_10).

Tomcat Core Installation

Voilà! le processus d'installation copie les fichiers et installe le service Windows.

Tomcat Core Installation

L'arborescence est maintenant créée, le service Windows est prêt à être démarré. Pour plus d'informations sur le service Windows, veuillez vous reporter à la documentation de Tomcat.

Tomcat Core Installation

Voila, notre distribution de base est installée. Si vous avez choisi un JRE 5.0, vous pouvez l'exécuter dés maintenant; si vous avez choisi un JRE antérieur, il vous faut préalablement installer la distribution de compatibilité 1.4.x suivante.

3.1.2. Le package de compatibilité Java 1.4.x

Décompressez l'archive "apache-tomcat-5.5.12-compat.zip" téléchargée dans le répertoire d'installation de Tomcat. Vous pouvez également copier manuellement les fichiers de l'archive extraite vers les répertoires correspondant de Tomcat. Démarrez Tomcat via le service Windows si vous l'avez installé, sinon via l'exécutable "tomcat5.exe" situé dans TOMCAT_HOME/bin/.
Ouvrez votre fidèle Mozilla Firefox et testez le bon démarrage du serveur grâce à l'URL: http://adresse_ip:num_port (http:/localhost:8080 par exemple).

Tomcat Test

Si vous voyez cette page apparaître, c'est que vous avez réussi ;-). Vous pouvez obtenir des informations sur Tomcat en cliquant sur "Status" dans le menu de gauche de cette interface. Une fenêtre d'authentification vous demandera de renseigner un utilisateur ayant les droits sur cette interface; utilisez le compte créé lors du processus d'installation. Vous y verrez les informations suivantes:

  • Version de Tomcat,
  • Version de la JVM,
  • Fournisseur de la JVM,
  • Informations sur le système d'exploitation et l'architecture processeur,
  • Informations sur la mémoire utilisée et disponible,
  • Statistiques des ports écoutés par Tomcat...
Tomcat Test
Tomcat Test

Vous ne pourrez par contre pas accéder à l'interface "Tomcat Administration", elle n'est plus installée par défaut avec Tomcat, mais nous l'ajouterons plus loin dans ce tutoriel.
Enfin vous disposerez de l'interface "Tomcat Manager", qui vous permet de visualiser les applications Web installées, de les démarrer, et d'en déployer des nouvelles.

Tomcat Test

3.1.3. Le package pour l'interface d'administration

Cette distribution contient les fichiers nécessaires à l'installation de l'interface (faite en JSP) d'administration de Tomcat:

  • - Connecteurs et ports
  • - Contextes d'applications
  • - Ressources
  • - Sécurité
  • - Gestion des utilisateurs

Bien entendu, l'interface n'est qu'un moyen de visionner et modifier la configuration de façon plus "user-friendly". Toutes les opérations réalisables via cette interface le sont également en modifiant les fichiers de configuration XML de Tomcat.

Comme pour l'installation de la distribution de compatibilité Java 1.4, il faut extraire le package "apache-tomcat-5.5.12-admin.zip" dans le répertoire d'installation de Tomcat, ou alors copier manuellement les fichiers en respectant les répertoires.
Redémarrez le service Apache Tomcat, puis retournez sur l'adresse de test "http://adresse_ip:num_port". Vous pouvez maintenant vous rendre dans l'interface "Tomcat Administration", une page intermédiaire vous demandera de vous authentifier.

Apache Tomcat - Tomcat Administration
Apache Tomcat - Tomcat Administration

3.2. Variable d'environnement

Avec l'installation à partir de l'exécutable, il n'est pas nécessaire de positionner une variable d'environnement. Cependant avec une installation basée sur un ZIP ou un TAR/GZ, cette opération est nécessaire.
Je vous renvoie donc à la section "Variable d'environnement" du mode opératoire d'installation du JDK. Vous devez donc positionner une variable CATALINA_HOME sur le répertoire d'installation de Tomcat.

3.3. Procrun Service Management Tool

Avec l'installation sous Windows à partir de l'exécutable, vous bénéficierez également d'un utilitaire de gestion du processus Apache Tomcat. Il est accessible dans la barre des tâches de windows "Tray Icon". Son processus windows est nommé "tomcat5w.exe" dans le gestionnaire des tâches windows.

Apache Tomcat - Procrun Service Management Tool

Cette interface autorise la gestion du service Windows et la sécurité de ce service, les paramètres de Logging de Tomcat (c'est à dire rediriger les sorties standards et sorties d'erreurs), choix de la JVM, du classpath et des options, modification des paramètres de gestion mémoire...

4. Quelques liens ...