Comment installer Tomcat 9 sur Debian 10 Linux

Apache Tomcat est un serveur d'applications basé sur JAVA open source qui implémente les technologies Java Servlet, JavaServer Pages, Java Expression Language et Java WebSocket. Il s'agit aujourd'hui de l'une des applications et des serveurs Web les plus utilisés au monde.

Ce tutoriel explique comment installer Apache Tomcat 9.0 sur Debian 10 Buster et configurer l'interface de gestion Web Tomcat.

Conditions préalables

Les instructions supposent que vous êtes connecté en tant que root ou utilisateur avec des privilèges sudo.

Installation d'OpenJDK

Tomcat 9.0 nécessite l'installation de Java SE 8 ou version ultérieure sur le serveur.

Exécutez la commande suivante pour installer le package OpenJDK:

sudo apt install default-jdk

Création d'un utilisateur Tomcat

L'exécution de Tomcat en tant qu'utilisateur root représente un risque pour la sécurité et n'est pas recommandée. Nous allons créer un nouvel utilisateur qui sera utilisé pour exécuter le service Tomcat.

Exécutez la commande suivante pour créer un nouvel utilisateur système et un nouveau groupe avec un répertoire personnel /opt/tomcat :

sudo useradd -m -U -d /opt/tomcat -s /bin/false tomcat

Téléchargement de Tomcat

Au moment d'écrire ces 9.0.27 , la dernière version de Tomcat est la 9.0.27 . Avant de passer à l'étape suivante, vous devez consulter la page de téléchargement de Tomcat 9 pour voir si une version plus récente est disponible.

Accédez au /tmp et téléchargez la dernière version binaire de Tomcat:

cd /tmp wget

Une fois le téléchargement terminé, extrayez l'archive gzippée:

tar -xf apache-tomcat-9.0.27.tar.gz

Déplacez-y les fichiers source Tomcat dans le répertoire /opt/tomcat :

sudo mv apache-tomcat-9.0.27 /opt/tomcat/

Tomcat 9 est mis à jour périodiquement. Pour avoir plus de contrôle sur les versions et les mises à jour, créez un lien symbolique nommé latest qui pointe vers le répertoire d'installation de Tomcat:

sudo ln -s /opt/tomcat/apache-tomcat-9.0.27 /opt/tomcat/latest

Plus tard, lors de la mise à niveau de Tomcat, décompressez simplement la version la plus récente et modifiez le lien symbolique pour pointer vers la dernière version.

Modifiez la propriété du répertoire /opt/tomcat en utilisateur et en groupe tomcat , afin que l'utilisateur puisse accéder au répertoire d'installation:

sudo chown -R tomcat: /opt/tomcat

Rendez les scripts à l'intérieur du répertoire bin exécutables:

sudo sh -c 'chmod +x /opt/tomcat/latest/bin/*.sh'

Création d'un fichier d'unité SystemD

Ouvrez votre éditeur de texte et créez un nouveau fichier nommé tomcat.service avec le contenu suivant:

sudo nano /etc/systemd/system/tomcat.service /etc/systemd/system/tomcat.service

Description=Tomcat 9.0 servlet container After=network.target Type=forking User=tomcat Group=tomcat Environment="JAVA_HOME=/usr/lib/jvm/default-java" Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom" Environment="CATALINA_BASE=/opt/tomcat/latest" Environment="CATALINA_HOME=/opt/tomcat/latest" Environment="CATALINA_PID=/opt/tomcat/latest/temp/tomcat.pid" Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC" ExecStart=/opt/tomcat/latest/bin/startup.sh ExecStop=/opt/tomcat/latest/bin/shutdown.sh WantedBy=multi-user.target

Informez systemd qu'un nouveau fichier d'unité existe et démarrez le service Tomcat en tapant:

sudo systemctl daemon-reload sudo systemctl start tomcat

Vérifiez l'état du service Tomcat en tapant:

sudo systemctl status tomcat

● tomcat.service - Tomcat 9.0 servlet container Loaded: loaded (/etc/systemd/system/tomcat.service; disabled; vendor preset: Active: active (running) since Sat 2019-11-09 13:53:51 PST; 5s ago Process: 5752 ExecStart=/opt/tomcat/latest/bin/startup.sh (code=exited, status Main PID: 5759 (java)

S'il n'y a pas d'erreur, activez le démarrage automatique du service Tomcat au démarrage:

sudo systemctl enable tomcat

Vous pouvez démarrer, arrêter et redémarrer Tomcat comme tout autre service d'unité systemd:

sudo systemctl start tomcat sudo systemctl stop tomcat sudo systemctl restart tomcat

Réglage du pare-feu

sudo ufw allow 8080/tcp

Lors de l'exécution d'une application Tomcat dans un environnement de production, vous disposerez très probablement d'un équilibreur de charge ou d'un proxy inverse, et il est recommandé de restreindre l'accès au port 8080 uniquement à votre réseau interne.

Configuration de l'interface de gestion Web Tomcat

Maintenant que Tomcat est installé, l'étape suivante consiste à créer un utilisateur ayant accès à l'interface de gestion Web.

Les utilisateurs Tomcat et leurs rôles sont définis dans le fichier tomcat-users.xml .

sudo nano /opt/tomcat/latest/conf/tomcat-users.xml

Nous définirons le nouvel utilisateur dans le fichier tomcat-users.xml , comme indiqué ci-dessous. L'utilisateur aura accès à l'interface Web tomcat (manager-gui et admin-gui). Assurez-vous de changer le nom d'utilisateur et le mot de passe pour quelque chose de plus sécurisé:

/opt/tomcat/latest/conf/tomcat-users.xml

Par défaut, l'interface de gestion Web Tomcat autorise l'accès uniquement à partir de l'hôte local. Si vous souhaitez accéder à l'interface Web à partir d'une adresse IP distante ou de n'importe où, ce qui n'est pas recommandé car il s'agit d'un risque de sécurité, vous pouvez ouvrir les fichiers suivants et apporter les modifications suivantes.

/opt/tomcat/latest/webapps/manager/META-INF/context.xml

/opt/tomcat/latest/webapps/host-manager/META-INF/context.xml

/opt/tomcat/latest/webapps/manager/META-INF/context.xml

/opt/tomcat/latest/webapps/host-manager/META-INF/context.xml

La liste des adresses IP autorisées est une liste séparée par une barre verticale | . Vous pouvez ajouter des adresses IP uniques ou utiliser des expressions régulières.

Redémarrez le service Tomcat pour que les modifications prennent effet:

sudo systemctl restart tomcat

Testez l'installation

Ouvrez votre navigateur et tapez: http://:8080 http://:8080

Si l'installation réussit, un écran similaire au suivant apparaît:

Conclusion

Vous avez correctement installé Tomcat 9.0 sur votre système Debian 10. Vous pouvez maintenant visiter la documentation officielle d'Apache Tomcat 9.0 et en savoir plus sur les fonctionnalités d'Apache Tomcat.

java debian tomcat