Comment installer Apache Tomcat avec Nginx Reverse Proxy sur Ubuntu 24.04

Apache Tomcat ou “Tomcat” est un conteneur de servlets Java gratuit et open-source pour le code et les applications Java. Il fournit un environnement de serveur HTTP “pure Java” où le code Java peut s’exécuter. Tomcat implémente également JavaServer Pages, Java Expression Language et les technologies WebSocket. Il prend en charge SSL pour sécuriser les données sensibles telles que l’authentification.

Ce guide vous apprendra comment installer Apache Tomcat sur un serveur Ubuntu 24.04. Vous installerez Apache Tomcat 10 avec Java OpenJDK 21, puis installerez et configurerez Nginx en tant que reverse proxy.

Prérequis

Avant de continuer, assurez-vous d’avoir :

Un serveur Ubuntu 24.04.
Un utilisateur non-root avec des privilèges d’administrateur.

Installation de Java OpenJDK

Avant d’installer Apache Tomcat, vous devez vous assurer que Java est installé. La dernière version d’Apache Tomcat 10 nécessite au moins Java 11 ou une version ultérieure. Dans cette section, vous installerez Java OpenJDK 21 à partir du dépôt officiel d’Ubuntu.

Pour commencer, mettez à jour l’index des paquets Ubuntu avec la commande ci-dessous.

sudo apt update

update repo

Maintenant, installez Java OpenJDK avec la commande suivante. Sur Ubuntu 24.04, le ‘default-jdk’ fait référence à l’OpenJDK 21, qui est la version LTS de Java.

sudo apt install default-jdk

Entrez Y pour continuer l’installation.

install java

Après l’installation, vérifiez la version de Java en utilisant la commande suivante. Vous devriez voir que Java OpenJDK 21 est installé sur votre serveur Ubuntu.

java --version

Installation d’Apache Tomcat 10

Apache Tomcat 10 est disponible par défaut dans le dépôt Ubuntu sur la dernière version d’Ubuntu. Cela vous permet d’installer Tomcat facilement en utilisant le gestionnaire de paquets APT.

Tout d’abord, vérifiez les informations du paquet ‘tomcat10‘ avec la commande suivante.

sudo apt info tomcat10

Ce qui suit montre que Apache Tomcat 10.1.16 est disponible dans le dépôt ‘universe/java‘ d’Ubuntu.

info tomcat10 package

Maintenant, installez Apache Tomcat sur votre système Ubuntu avec la commande ci-dessous. Avec cette commande, vous installerez également les applications web d’administration Tomcat, des outils pour créer des utilisateurs et des exemples d’applications web Tomcat.

sudo apt install tomcat10 tomcat10-common tomcat10-admin tomcat10-user tomcat10-examples

Entrez Y pour confirmer l’installation.

installing apache tomcat

Le service ‘tomcat10’ sera créé lorsque l’installation sera terminée.

Vérifiez l’état du service ‘tomcat10‘ avec la commande suivante :

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Vous pouvez voir ci-dessous, le service ‘tomcat10‘ est activé et actif (en cours d’exécution). Le service ‘tomcat10‘ démarrera automatiquement au démarrage.

check tomcat service

Maintenant, exécutez la commande ci-dessous pour vérifier le port 8080 d’Apache Tomcat. Si Tomcat fonctionne, vous verrez que l’application Java utilise le port 8080.

ss -tulpn

Enfin, visitez http://192.168.5.30:8080/ en utilisant votre navigateur web et vous verrez la page d’index par défaut d’Apache Tomcat comme suit :

tomcat index

Configuration de l’authentification Apache Tomcat

Dans cette section, vous allez configurer l’authentification de base et autoriser l’accès au gestionnaire d’hôtes Tomcat et au gestionnaire. Vous allez activer l’authentification de base de Tomcat en modifiant le fichier ‘tomcat-users.xml’, puis en permettant l’accès à la fois au gestionnaire d’hôtes et au gestionnaire Tomcat via le paquet ‘tomcat10-admin’.

Ouvrez la configuration des utilisateurs Tomcat ‘/etc/tomcat10/tomcat-users.xml’ en utilisant l’éditeur nano.

sudo nano /etc/tomcat10/tomcat-users.xml

Insérez la configuration suivante entre les ‘ …. ’. Dans cet exemple, vous allez créer un utilisateur Apache Tomcat ‘admin‘ avec le mot de passe ‘tomcatadmin‘ et plusieurs rôles, y compris ‘admin-gui’ et ‘manager-gui’.

Lorsque vous avez terminé, enregistrez et quittez le fichier.

Maintenant, ouvrez la configuration pour le ‘ host-manager ‘ et le ‘ manager ‘ de Tomcat avec la commande de l’éditeur nano ci-dessous.

sudo nano /usr/share/tomcat10-admin/host-manager/META-INF/context.xml  
sudo nano /usr/share/tomcat10-admin/manager/META-INF/context.xml

‘. Avec cela, vous permettrez l’accès à distance au ‘ host-manager ‘ et au ‘ manager* ‘ d’Apache Tomcat.

Enregistrez et quittez le fichier.

Après avoir modifié, exécutez la commande suivante pour redémarrer le service ‘tomcat10’ et appliquer les nouvelles modifications à votre installation Apache Tomcat.

sudo systemctl restart tomcat10

Enfin, visitez http://192.168.5.30:8080/host-manager/ pour accéder au gestionnaire d’hôtes virtuel d’Apache Tomcat et http://192.168.5.30:8080/manager/ pour accéder au gestionnaire Tomcat.

Tapez l’utilisateur ‘admin‘ et le mot de passe ‘tomcatadmin‘ lorsque vous y êtes invité.

Si l’authentification est réussie, vous devriez obtenir la page du gestionnaire d’hôtes et du gestionnaire d’Apache Tomcat comme suit :

Gestionnaire Apache Tomcat.

tomcat manager

Gestionnaire d’hôtes Apache Tomcat.

tomcat manager

Configuration de Nginx en tant que reverse proxy

Dans ce guide, vous allez installer le serveur web Nginx et le configurer en tant que reverse proxy pour votre installation Apache Tomcat. En utilisant un reverse proxy, vous pouvez facilement accéder à votre application Tomcat via votre nom de domaine local.

Pour installer le serveur web Nginx sur votre Ubuntu, exécutez ce qui suit :

sudo apt install nginx -y

install nginx

Lorsque l’installation est terminée, créez une nouvelle configuration de bloc de serveur ‘ /etc/nginx/sites-available/tomcat10 ‘ qui sera utilisée comme reverse proxy pour Apache Tomcat.

sudo nano /etc/nginx/sites-available/tomcat10

Ajoutez la configuration ci-dessous et changez votre nom de domaine local en utilisant l’option server_name.

server {  
 listen 80;  
  
 server_name tomcat10.howtoforge.local;  
 access_log /var/log/nginx/tomcat-access.log;  
 error_log /var/log/nginx/tomcat-error.log;  
  
 location / {  
  proxy_set_header X-Forwarded-Host $host;  
  proxy_set_header X-Forwarded-Server $host;  
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
  proxy_pass http://127.0.0.1:8080/;  
 }  
}

Enregistrez et quittez le fichier lorsque vous avez terminé.

Maintenant, exécutez la commande ci-dessous pour activer la configuration du bloc de serveur ‘tomcat10’ et tester votre syntaxe Nginx.

sudo ln -s /etc/nginx/sites-available/tomcat10 /etc/nginx/sites-enabled/  
sudo nginx -t

Si vous avez une syntaxe Nginx correcte et appropriée, vous verrez une sortie ‘syntax is ok … test is successful‘.

Ensuite, exécutez la commande suivante pour redémarrer le service Nginx et appliquer le bloc de serveur ‘tomcat10’. Ensuite, vérifiez l’état du service Nginx pour vous assurer qu’il fonctionne.

sudo systemctl restart nginx  
sudo systemctl status nginx

La sortie ci-dessous montre que le serveur web Nginx fonctionne. Et vous pouvez accéder à votre installation Apache Tomcat en utilisant un nom de domaine tel que ‘tomcat10.howtoforge.local‘.

check nginx service

Vous pouvez ajouter la configuration suivante au fichier ‘hosts’ sur votre machine locale. Pour les utilisateurs de Linux ou Mac, ajoutez ce qui suit au fichier ‘/etc/hosts‘. Quant aux utilisateurs de Windows, ajoutez la configuration ci-dessous au fichier ‘C:\Windows\System32\drivers\etc\hosts‘.

192.168.5.30 tomcat10.howtoforge.local

Enfin, visitez http://tomcat10.howtoforge.local en utilisant votre navigateur web. Si votre installation de reverse proxy Nginx est réussie, vous verrez la page d’index d’Apache Tomcat comme suit :

tomcat index

Visitez http://tomcat10.howtoforge.local/host-manager/ pour accéder au gestionnaire d’hôtes d’Apache Tomcat et http://tomcat10.howtoforge.local/manager/ pour accéder au gestionnaire d’Apache Tomcat. Vous verrez les deux applications fonctionner sous le reverse proxy Nginx.

Conclusion

Félicitations ! Vous avez réussi à installer Apache Tomcat sur le serveur Ubuntu 24.04. Vous avez installé Tomcat 10 avec Java OpenJDK 21 sur Ubuntu. De plus, vous avez installé et configuré Nginx en tant que reverse proxy pour Apache Tomcat.