Introduction : Tomcat

Apache Tomcat est un serveur Web et un conteneur de servlets utilisés pour servir les applications Java. Tomcat est une implémentation open source des technologies Java Servlet et JavaServer Pages, publiée par Apache Software Foundation. Ce tutoriel couvre l'installation de base et certaines configurations de la dernière version de Tomcat 9 sur votre serveur Debian 10.

Etape 0 - Installation de debian 10

Téléchargez l'ISO netinstall de debian 10 et installez une nouvelle machine virtuelle.

Etape 1 - Installation de Java

Tomcat nécessite que Java soit installé sur le serveur afin que tout code d'application Web Java puisse être exécuté. Nous pouvons satisfaire cette exigence en installant OpenJDK avec apt.Tout d'abord, mettez à jour votre index de package apt:

sudo apt update

Ensuite, installez le package Java Development Kit avec apt:

sudo apt install default-jdk

Maintenant que Java est installé, nous pouvons créer un utilisateur tomcat, qui sera utilisé pour exécuter le service Tomcat.

Etape 2 - Création de l'utilisateur

Pour des raisons de sécurité, Tomcat doit être exécuté en tant qu'utilisateur non privilégié (c'est-à-dire non root). Nous allons créer un nouvel utilisateur et un groupe qui exécuteront le service Tomcat.Tout d'abord, créez un nouveau groupe tomcat:

sudo groupadd tomcat

Ensuite, créez un nouvel utilisateur tomcat. Nous allons faire de cet utilisateur un membre du groupe tomcat, avec un répertoire personnel :

/opt/tomcat (où nous installerons Tomcat)

et avec un shell :

/bin/false (afin que personne ne puisse se connecter au compte)

sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat

Maintenant que notre utilisateur tomcat est configuré, téléchargeons et installons Tomcat.

Etape 3 - Installation de Tomcat

La meilleure façon d'installer Tomcat 9 est de télécharger la dernière version binaire puis de la configurer manuellement.Recherchez la dernière version de Tomcat 9 sur la page de téléchargement de Tomcat 9 :

https://tomcat.apache.org/download-90.cgi

Au moment de la rédaction de cet article, la dernière version est la 9.0.37. Si celle-ci est indiquée comme "non stable", cherchez une version ultérieure, la dernière version stable.

Sous la section "Binary Distributions", puis sous la liste "Core", copiez le lien vers le «tar.gz».

Au moment de la rédaction de cet article, le lien est :

https://mirroir.wptheme.fr/apache/tomcat/tomcat-9/v9.0.37/bin/apache-tomcat-9.0.37.tar.gzEnsuite, revenez à votre session SSH et accédez au répertoire /tmp de votre serveur. C'est un bon répertoire pour télécharger des éléments éphémères, comme l'archive tar Tomcat, dont nous n'aurons plus besoin après l'extraction du contenu Tomcat:

cd /tmp

Nous utiliserons l'outil de ligne de commande curl pour télécharger l'archive tar. (vous pourriez aussi utiliser wget)

Installez curl :

sudo apt install curl

Maintenant, utilisez curl pour télécharger le lien que vous avez copié à partir du site Web de Tomcat:

curl -O <le_lien_que_vous_avez_trouvé_précédemment>

Exemple :

curl -O https://mirroir.wptheme.fr/apache/tomcat/tomcat-9/v9.0.37/bin/apache-tomcat-9.0.37.tar.gz

👨‍🏫 Attention ! "curl -O" avec un "O" majuscule

Nous installerons Tomcat dans le répertoire :

/opt/tomcat

👨‍🏫 Le dossier "/opt" est utilisé pour l'installation des logiciels commerciaux

Pour plus d'informations sur la structure des répertoires sous linux, je vous invite à consulter ce lien :

http://www.linux-france.org/article/sys/fichiers/fichiers-2.html

Créez le répertoire, puis extrayez-y l'archive avec ces commandes:

sudo mkdir /opt/tomcatsudo tar xzvf apache-tomcat-9*tar.gz -C /opt/tomcat --strip-components=1

Ensuite, nous allons configurer les autorisations utilisateur appropriées pour notre installation.

Etape 4 - Configuration des permissions

L'utilisateur tomcat que nous avons créé doit avoir accès à l'installation Tomcat. Nous allons configurer cela maintenant.Accédez au répertoire dans lequel nous avons décompressé l'installation de Tomcat:

cd /opt/tomcat

Donnez la propriété du groupe tomcat sur tout le répertoire d'installation:

sudo chgrp -R tomcat /opt/tomcat

Ensuite, donnez au groupe tomcat un accès en lecture au répertoire conf et à tout son contenu, et exécutez l'accès au répertoire lui-même:

sudo chmod -R g+r confsudo chmod g+x conf

Faites de l'utilisateur tomcat le propriétaire des répertoires webapps, work, temp et logs :

sudo chown -R tomcat webapps/ work/ temp/ logs/

Maintenant que les autorisations appropriées sont configurées, nous allons créer un fichier de service systemd pour gérer le processus Tomcat.

Etape 5 - Création d'un fichier de service systemd

Nous voulons pouvoir exécuter Tomcat en tant que service, nous allons donc configurer le fichier de service systemd.Tomcat a besoin de savoir où Java est installé. Ce chemin est communément appelé JAVA_HOME. Le moyen le plus simple de rechercher cet emplacement consiste à exécuter cette commande:

sudo update-java-alternatives -l

Au moment de l'écriture de cet article, le résultat est le suivant :

java-1.11.0-openjdk-amd64 1111 /usr/lib/jvm/java-1.11.0-openjdk-amd64

Ce résultat pourra être différent si votre version de java est plus récente.

Avec cette information, nous pouvons créer le fichier de service systemd. Ouvrez un fichier appelé tomcat.service dans le répertoire /etc/systemd/system en tapant:

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

👨‍🏫 Je vous conseille d'utiliser "nano" plutôt que "vim" (pour ceux qui y seraient habitués) car nano permet de coller directement dans le fichier. Exemple avec Putty, en faisant un clic droit pour coller.

Pour rappel pour sortir de nano : CTRL + X

(lisez les informations en bas de console pour plus de commandes)

Collez le contenu suivant dans votre fichier de service. Modifiez la valeur de JAVA_HOME si nécessaire pour qu'elle corresponde à la valeur que vous avez trouvée sur votre système.

[Unit]

Description=Apache Tomcat Web Application ContainerAfter=network.target [Service]

Type=forking Environment=JAVA_HOME=/usr/lib/jvm/java-1.11.0-openjdk-amd64Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pidEnvironment=CATALINA_HOME=/opt/tomcatEnvironment=CATALINA_BASE=/opt/tomcatEnvironment='CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC'Environment='JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom' ExecStart=/opt/tomcat/bin/startup.shExecStop=/opt/tomcat/bin/shutdown.shUser=tomcatGroup=tomcatUMask=0007RestartSec=10Restart=always

[Install]

WantedBy=multi-user.target

👨‍🏫 Attention à bien renseigner la valeur :

Environment=JAVA_HOME=" ........ "

Lorsque vous avez terminé, enregistrez et fermez le fichier.Ensuite, rechargez le démon systemd pour qu'il connaisse notre fichier de service:

sudo systemctl daemon-reload

Démarrez le service Tomcat en tapant:

sudo systemctl start tomcat

Vérifiez qu'il a démarré sans erreur en tapant:

sudo systemctl status tomcat

Vous devriez voir un résultat du genre :

Cela confirme que Tomcat est opérationnel sur votre serveur.

Etape 6 - Configuration du pare-feu et test d'accès

Maintenant que le service Tomcat est démarré, nous pouvons tester pour nous assurer que la page par défaut est disponible.Avant de faire cela, nous devons ajuster le pare-feu pour permettre à nos demandes d'accéder au service. Personnellement, j'utilise le pare-feu ufw qui est très simple à configurer. Voici les commandes :

Installation d'ufw :

sudo apt-get install ufw

Tomcat utilise le port 8080 pour accepter les demandes. Autorisez le trafic vers ce port en tapant:

sudo ufw allow 8080

Et voilà c'est tout pour le pare-feu 😊

Une fois le pare-feu modifié, vous pouvez accéder à la page d'accueil par défaut en accédant à votre domaine ou à votre adresse IP suivi de: 8080 dans un navigateur Web:

http://IP_du_serveur:8080

Vous verrez la page de démarrage Tomcat par défaut, en plus d'autres informations. Cependant, si vous cliquez sur les liens de l'application Manager, par exemple, l'accès vous sera refusé. Nous allons configurer cet accès par la suite.Si vous avez réussi à accéder à Tomcat, il ne vous reste plus qu'à activer le fichier de service pour que Tomcat démarre automatiquement au lancement de votre debian.

sudo systemctl enable tomcat

Etape 7 - Configuration de l'interface web de management (optionnel)

Pour utiliser l'interface web de management de Tomcat, vous devez ajouter un identifiant à notre serveur Tomcat. Nous allons le faire en éditant le fichier tomcat-users.xml:

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

Pour configurer les accès, vous n'avez qu'à renseigner le username, le password et les deux rôles comme ci-dessous :

<tomcat-users> . . . <user username="admin" password="password" roles="manager-gui,admin-gui"/></tomcat-users>

Enregistrez et fermez le fichier lorsque vous avez terminé.Par défaut, les nouvelles versions de Tomcat limitent l'accès aux applications Manager et Host Manager aux connexions provenant du serveur lui-même. Puisque nous installons sur une machine distante, vous voudrez probablement supprimer ou modifier cette restriction. Pour modifier les restrictions d'adresse IP sur ces derniers, ouvrez les fichiers context.xml appropriés.

Pour l'application Manager, saisissez:

sudo nano /opt/tomcat/webapps/manager/META-INF/context.xml

Pour l'application Host Manager, saisissez:

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

À l'intérieur, commentez la restriction d'adresse IP pour permettre les connexions de n'importe où. Sinon, si vous souhaitez autoriser l'accès uniquement aux connexions provenant de votre propre adresse IP, vous pouvez ajouter votre adresse IP publique à la liste:

Enregistrez et fermez les fichiers lorsque vous avez terminé.Pour appliquer nos modifications, redémarrez le service Tomcat:

sudo systemctl restart tomcat

Etape 8 - Prise en main de l'interface web de management (optionnel suite)

Maintenant que nous avons créé un utilisateur, nous pouvons à nouveau accéder à l'interface de gestion Web dans un navigateur Web. Une fois de plus, vous pouvez accéder à la bonne interface en entrant le nom de domaine ou l’adresse IP de votre serveur suivi sur le port 8080 dans votre navigateur:

http://IP_du_serveur:8080

La page que vous voyez doit être la même que celle que vous avez reçue lors du test précédent:

Jetons un coup d'œil à l'application Manager, accessible via le lien ou :

http://IP_du_serveur:8080/manager/html

Vous devrez entrer les informations d'identification du compte que vous avez ajoutées au fichier tomcat-users.xml. Ensuite, vous devriez voir une page qui ressemble à ceci:

Le gestionnaire d'applications Web est utilisé pour gérer vos applications Java. Vous pouvez démarrer, arrêter, recharger, déployer et annuler le déploiement ici. Vous pouvez également exécuter des diagnostics sur vos applications (c'est-à-dire trouver des fuites de mémoire). Enfin, des informations sur votre serveur sont disponibles tout en bas de cette page.Si vous souhaitez accéder au gestionnaire d'hôte, à partir duquel vous pouvez ajouter des hôtes virtuels à partir desquels servir vos applications :

http://IP_du_serveur:8080/host-manager/html

Conclusion

Votre installation de Tomcat est terminée! Vous êtes désormais libre de déployer vos propres applications Web Java. C'est que nous allons faire dans la prochaine partie avec Guacamole.Actuellement, votre installation Tomcat est fonctionnelle, mais entièrement non chiffrée. Cela signifie que toutes les données, y compris les éléments sensibles comme les mots de passe, sont envoyées sous forme de texte brut qui peut être intercepté et lu par d'autres personnes sur le réseau. Afin d'éviter que cela ne se produise, il est fortement recommandé de chiffrer vos connexions avec SSL. (nous ne traiterons pas cette partie dans ce TP).

Installation d’un serveur Tomcat 9 sur Debian 10