Démarrage d’Apache Tomcat : startup, Bootstrap et Catalina
Date de publication:
Mise à jour :
Articles > Démarrage d’Apache Tomcat : startup, Bootstrap et Catalina
Statut 2026 et utilisation sûre
Conclusion : startup.sh ou startup.bat délègue à catalina, qui assemble les variables d'environnement, les chemins de classe, les options JVM et les propriétés système avant de lancer la classe Bootstrap de Tomcat. Un gestionnaire de services peut appeler le même environnement d'exécution via un wrapper différent.
Ce que vous apprendrez
- Comment
CATALINA_HOME,CATALINA_BASE,JAVA_HOMEetJRE_HOMEaffectent le démarrage. - Comment les arguments shell ou batch deviennent une commande Java, puis une opération du cycle de vie Catalina.
- Où inspecter la commande finale sans copier les indicateurs JVM obsolètes.
À qui s'adresse : Les opérateurs dépannant les wrappers de démarrage et les développeurs qui apprennent les composants internes de Tomcat.
Note de mise à jour (2026) : La trace de commande ci-dessous provient de Tomcat 9.0.27 sur Java 11. Utilisez-la pour comprendre le flux, puis inspectez les scripts fournis avec votre version Tomcat prise en charge ; les indicateurs internes et les versions Java compatibles changent.
Note de sécurité : les commandes et exemples de configuration de l'article d'origine n'ont pas été rejoués dans un environnement de production actuel. Avant toute application, vérifiez les versions prises en charge, les sauvegardes, les contrôles d'accès et la procédure de retour arrière dans un environnement de test isolé.
Sources primaires officielles
Vue d’ensemble
Cet article suit la séquence de démarrage de Tomcat. L'administrateur lance généralement startup.bat ou startup.sh, mais ces scripts préparent plusieurs éléments avant que le serveur soit opérationnel. L'exemple historique repose sur Tomcat 9.0.27.
Le guide de téléchargement de Tomcat indique où se trouvait cette archive. Pour une installation réelle, choisissez une version encore prise en charge.
Table des matières
1. Comment Tomcat démarre
Dans cet exemple utilisant Tomcat 9.0.27 et OpenJDK 11 sous Windows, les scripts finissent par assembler puis exécuter la commande Java suivante :
"C:\Program Files (x86)\Java\jdk-11\bin\java.exe" -Djava.util.logging.config.file="C:\apache-tomcat-9.0.27\conf\logging.properties" -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Djdk.tls.ephemeralDHKeySize=2048 -Djava.protocol.handler.pkgs=org.apache.catalina.webresources -Dignore.endorsed.dirs="" -classpath "C:\apache-tomcat-9.0.27\bin\bootstrap.jar;C:\apache-tomcat-9.0.27\bin\tomcat-juli.jar" -Dcatalina.base="C:\apache-tomcat-9.0.27" -Dcatalina.home="C:\apache-tomcat-9.0.27" -Djava.io.tmpdir="C:\apache-tomcat-9.0.27\temp" org.apache.catalina.startup.Bootstrap start
Cette commande construit le classpath et les propriétés système, puis appelle la méthode main de org.apache.catalina.startup.Bootstrap avec l'argument start.
Le guide sur les propriétés système Java -D explique les options transmises au lanceur.
Pour comprendre l'origine de cette ligne, examinons le rôle de startup.bat.
1-1. Contenu du fichier startup.bat
startup.bat vérifie l'environnement de lancement, puis appelle catalina.bat avec l'argument start. C'est catalina.bat qui construit l'essentiel de la commande.
Les scripts déterminent notamment :
- l'exécutable Java à utiliser ;
- les répertoires de base et d'installation de Tomcat ;
- le classpath et la classe principale ;
- les propriétés système et les autres options de la JVM.
La commande exacte dépend des versions de Tomcat et de Java, des variables d'environnement et de la configuration du service.
2. Conclusion
Le script de démarrage prépare l'environnement de Tomcat avant d'appeler Java. Dans cette version, le point d'entrée est org.apache.catalina.startup.Bootstrap. Pour diagnostiquer un échec, inspectez les scripts de la version installée et l'environnement effectif au lieu de recopier cette ancienne commande.