Comment installer Tomcat 9 sur Debian 9

Apache Tomcat est un serveur d'applications open source qui prend en charge 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 vous montrera comment installer Apache Tomcat 9.0 sur Debian 9 et configurer l'interface de gestion Web Tomcat.

Conditions préalables

Avant de poursuivre ce didacticiel, assurez-vous que vous êtes connecté en tant qu'utilisateur avec les privilèges sudo.

Nous téléchargerons le fichier zip Tomcat à l'aide de wget. Si vous n'avez pas installé wget sur votre système, vous pouvez le faire en tapant:

sudo apt install wget

Installation d'OpenJDK

Tomcat 9.0 nécessite Java SE 8 ou une version ultérieure. Pour installer le paquet OpenJDK par défaut à partir des référentiels Debian 9, exécutez la commande suivante:

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.

Créez un nouvel utilisateur et groupe système avec un répertoire personnel /opt/tomcat en exécutant la commande suivante:

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

Cet utilisateur sera utilisé pour exécuter le service Tomcat.

Téléchargement de Tomcat

Nous téléchargerons la dernière version de Tomcat 9.0.x à partir de la page de téléchargement de Tomcat.

Au moment d'écrire ces lignes, 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 le fichier zip avec wget :

cd /tmp wget

Une fois le téléchargement terminé, extrayez le fichier tar:

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 fréquemment mis à jour. Pour avoir plus de contrôle sur les versions et les mises à jour, créez un lien symbolique appelé 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 la version Tomcat, vous pouvez simplement décompresser la version la plus récente et modifier le lien symbolique pour pointer vers la dernière version.

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

sudo chown -R tomcat: /opt/tomcat

rendre également les scripts dans le répertoire bin exécutables:

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

Créer un fichier d'unité systemd

Créez un nouveau fichier d'unité tomcat.service dans le répertoire /etc/systemd/system/ avec le contenu suivant:

/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 que nous avons créé un nouveau fichier d'unité et démarrez le service Tomcat en exécutant:

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 servlet container Loaded: loaded (/etc/systemd/system/tomcat.service; enabled; vendor preset: disabled) Active: active (running) since Thu 2018-12-01 20:47:50 UTC; 4s ago Process: 1759 ExecStart=/opt/tomcat/latest/bin/startup.sh (code=exited, status=0/SUCCESS) Main PID: 1767 (java) CGroup: /system.slice/tomcat.service

S'il n'y a pas d'erreur, vous pouvez activer 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

Ajustez le pare-feu

Si votre pare-feu fonctionne sur votre système Debian et que vous souhaitez accéder à l'interface tomcat depuis l'extérieur de votre réseau local, vous devrez ouvrir le port 8080 :

sudo ufw allow 8080/tcp En règle générale, lorsque vous exécutez une application Tomcat dans un environnement de production, elle se trouve derrière un équilibreur de charge ou un proxy inverse. Il est recommandé de restreindre l'accès au port 8080 uniquement à votre réseau interne.

Configurer l'interface de gestion Web Tomcat

Maintenant que Tomcat est installé sur votre serveur Debian, 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 vim /opt/tomcat/latest/conf/tomcat-users.xml

Nous définirons un nouvel utilisateur ayant accès à l'interface Web tomcat (manager-gui et admin-gui) dans le fichier tomcat-users.xml , comme indiqué ci-dessous. 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 9. 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