Comment installer Tomcat 9 sur Ubuntu 18.04

Apache Tomcat est une implémentation open source des 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 adoptés au monde. Tomcat est simple à utiliser et dispose d'un écosystème robuste de modules complémentaires.

Ce tutoriel explique comment installer et configurer Tomcat 9 sur Ubuntu 18.04. Les mêmes instructions s'appliquent à Ubuntu 16.04 et à toute distribution basée sur Ubuntu, y compris Linux Mint et Elementary OS.

Conditions préalables

Pour pouvoir installer des packages sur votre système Ubuntu, vous devez être connecté en tant qu'utilisateur avec les privilèges sudo.

Étape 1: installez OpenJDK

Tomcat nécessite l'installation de Java. Nous installerons OpenJDK, qui est le développement et l'exécution Java par défaut dans Ubuntu 18.04.

L'installation de Java est assez simple. Commencez par mettre à jour l'index du package:

sudo apt update

Installez le package OpenJDK en exécutant:

sudo apt install default-jdk

Étape 2: créer un utilisateur Tomcat

Pour des raisons de sécurité, Tomcat ne doit pas être exécuté sous l'utilisateur root. Nous allons créer un nouvel utilisateur et groupe système avec le répertoire personnel /opt/tomcat qui exécutera le service Tomcat:

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

Étape 3: installer Tomcat

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

Au moment de la rédaction, la dernière version est la 9.0.27 . Avant de passer à l'étape suivante, vous devez consulter la page de téléchargement pour une nouvelle version. S'il existe une nouvelle version, copiez le lien vers le fichier Core tar.gz , qui se trouve dans la section Distributions binaires.

Commencez par télécharger l'archive Tomcat dans le /tmp à l'aide de la commande wget suivante:

wget http://www-eu.apache.org/dist/tomcat/tomcat-9/v9.0.27/bin/apache-tomcat-9.0.27.tar.gz -P /tmp

Une fois le téléchargement terminé, extrayez l'archive Tomcat et déplacez-la dans le répertoire /opt/tomcat :

sudo tar xf /tmp/apache-tomcat-9*.tar.gz -C /opt/tomcat

Pour avoir plus de contrôle sur les versions et les mises à jour de Tomcat, créez un lien symbolique appelé le 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, si vous souhaitez mettre à niveau votre instance Tomcat, décompressez simplement la version la plus récente et modifiez le lien symbolique pour pointer vers la dernière version.

Comme nous l'avons mentionné dans la section précédente, Tomcat s'exécutera sous l'utilisateur tomcat . Cet utilisateur doit avoir accès au répertoire d'installation de tomcat.

La commande suivante change la propriété du répertoire en utilisateur et groupe tomcat:

sudo chown -RH tomcat: /opt/tomcat/latest

Les scripts dans le répertoire bin doivent avoir un drapeau exécutable:

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

Étape 4: créer un fichier d'unité systemd

Pour exécuter Tomcat en tant que service, vous devez créer un nouveau fichier d'unité.

Ouvrez votre éditeur de texte et créez un fichier nommé tomcat.service dans /etc/systemd/system/ :

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

Collez la configuration suivante:

/etc/systemd/system/tomcat.service

Description=Tomcat 9 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 -Djava.awt.headless=true" 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 Modifiez la valeur de JAVA_HOME si le chemin d'accès à votre installation Java est différent.

Enregistrez et fermez le fichier et informez systemd que nous avons créé un nouveau fichier d'unité:

sudo systemctl daemon-reload

Démarrez le service Tomcat en exécutant:

sudo systemctl start tomcat

Vérifiez l'état du service avec la commande suivante:

sudo systemctl status tomcat

* tomcat.service - Tomcat 9 servlet container Loaded: loaded (/etc/systemd/system/tomcat.service; disabled; vendor preset: enabled) Active: active (running) since Wed 2018-09-05 15:45:28 PDT; 20s ago Process: 1582 ExecStart=/opt/tomcat/latest/bin/startup.sh (code=exited, status=0/SUCCESS) Main PID: 1604 (java) Tasks: 47 (limit: 2319) CGroup: /system.slice/tomcat.service

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

sudo systemctl enable tomcat

Étape 5: ajuster le pare-feu

Si votre serveur est protégé par un pare-feu et que vous souhaitez accéder à Tomcat depuis l'extérieur de votre réseau local, vous devez ouvrir le port 8080 .

Pour autoriser le trafic sur le port 8080 tapez la commande suivante:

sudo ufw allow 8080/tcp Généralement, lorsque vous exécutez une application Tomcat dans un environnement de production, vous disposez d'un équilibreur de charge ou d'un proxy inverse. Il est recommandé de restreindre l'accès au port 8080 uniquement à votre réseau interne.

Étape 6: configurer l'interface de gestion Web Tomcat

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

Les utilisateurs et rôles Tomcat sont définis dans le fichier tomcat-users.xml . Ce fichier est un modèle avec des commentaires et des exemples décrivant comment configurer la création d'un utilisateur ou d'un rôle.

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

Pour ajouter un nouvel utilisateur avec accès à l'interface Web de Tomcat (manager-gui et admin-gui), nous devons définir l'utilisateur 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 est configurée pour restreindre l'accès aux applications Manager et Host Manager uniquement à partir de l'hôte local.

Pour permettre l'accès à l'interface Web de n'importe où, ouvrez les deux fichiers suivants et commentez ou supprimez les lignes surlignées en jaune.

Pour l'application Manager, ouvrez le fichier suivant:

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

Pour l'application Host Manager, ouvrez le fichier suivant:

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

Une autre option consiste à autoriser l'accès aux applications Manager et Host Manager uniquement à partir d'une adresse IP spécifique. Au lieu de commenter les blocs, vous pouvez simplement ajouter votre adresse IP à la liste.

Par exemple, si votre adresse IP publique est 45.45.45.45 vous apporterez la modification suivante:

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.

N'oubliez pas de redémarrer le service Tomcat chaque fois que vous modifiez les fichiers de configuration Tomcat pour que les modifications prennent effet:

sudo systemctl restart tomcat

Étape 6: tester l'installation de Tomcat

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

En supposant que l'installation est réussie, un écran similaire au suivant devrait apparaître:

Conclusion

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

java tomcat ubuntu