Installation de Apache Tomcat 5.5 sous Windows

Pierre Chauvin

Voici les différentes étapes nécessaires à l'installation d'un serveur Jakarta Tomcat 5.5.12 sous Windows.

Mise à jour le 02/01/2006 (ancienne version pour Tomcat 5.x) : Tomcat est maintenant disponible en version 5.5.12, la fondation Apache a dernièrement jugé bon de modifier le packaging de distribution, en séparant Tomcat en différents modules. Je vous propose donc un survol de ce nouveau packaging, probablement déroutant pour les débutants.
Merci à Vincent Brabant pour sa relecture.

- Titre : Installation de Apache Tomcat 5.5 sous Windows

- Auteur : Pierre Chauvin

- Parution : 17 janvier 2006

- Mise à jour : 5 mars 2020

- Licence : Copyright ® 2005-2006 Pierre Chauvin. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Présentation

- II. Installer le JRE/JDK de Sun Microsystems

- III. Installer Jakarta Tomcat 5.5.12

- III-A. Télécharger Apache Tomcat

- III-B. Installation des différents packages

- III-B-1. Le package de base ou « Core »

- III-B-2. Le package de compatibilité Java 1.4.x

- III-B-3. Le package pour l'interface d'administration

- III-C. Variable d'environnement

- III-D. Procrun Service Management Tool

- IV. Quelques liens…

I - 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.

II - 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'ailleurs configurable, si vous désirez compiler les JSP 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.

III - Installer Jakarta Tomcat 5.5.12

III-A - 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.

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.

III-B - Installation des différents packages

III-B-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 :

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

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. 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 bibliothèques 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…

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.

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éférez 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.

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).

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

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.

Voilà, 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.

III-B-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 correspondants 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).

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…

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.

III-B-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.

III-C - 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.

III-D - 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.

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…

IV - Quelques liens…

- Site de la fondation Apache

- Le projet Jakarta Tomcat

- Installer Jakarta Tomcat 5.x sous Windows

- Installer le JDK Java 1.4.x sous Windows

- Mise en place d'une authentification via un formulaire sous Tomcat (versions 5.0.28 et 5.5.x)

- Utilisation de JDO dans une application web (JPox/Tomcat) (version 5.x)

- Créer et déployer un premier servlet avec Tomcat (version 4.1)

- Gestion d'un pool de connexions SGBD par Tomcat

- Intégration JSF et Hibernate dans JOnAS 4.0.0/ Tomcat 5.0.21

- Développement web avec Java, Eclipse et Tomcat

- Le site de Sun Microsystems

- Les forums Java et la section Java de Developpez.com