Comment installer et configurer Apache Tomcat 9 sur Ubuntu 20.04 LTS

Apache Tomcat est une implémentation open-source de Java Servlet développée par la Fondation Apache Software. En plus d’être un conteneur de Java Servlet, Tomcat prend également en charge d’autres technologies de serveur Java, notamment JavaServer Pages (JSP), Java Expression Language et Java WebSocket.

Apache Tomcat fournit un serveur Web HTTP pour les applications Java qui prend en charge HTTP/2, OpenSSL pour JSSE et l’hébergement virtuel TLS.

Dans ce tutoriel, nous allons te montrer comment installer et configurer Apache Tomcat 9.0.34 avec le Java OpenJDK 11 sur la dernière version du serveur ubuntu 20.04.

Conditions préalables

Pour ce tutoriel, nous allons installer Apache Tomcat sur le serveur Ubuntu 20.04 avec 1 Go de RAM, 25 Go d’espace disque libre et 2 processeurs.

Ce que nous allons faire ?

  • Installe Java OpenJDK
  • Configure la variable d’environnement JAVA_HOME
  • Télécharge et installe Apache Tomcat 9.0.34
  • Configurer Apache Tomcat comme un service Systemd
  • Configurer l’authentification d’Apache Tomcat
  • Tester

Étape 1 – Installer Java OpenJDK

Tout d’abord, nous allons installer les paquets Java OpenJDK sur notre serveur Ubuntu 20.04.

Par défaut, le dernier dépôt d’Ubuntu 20.04 fournit plusieurs versions de Java, dont l’OpenJDK 11.

Mets à jour tous les référentiels sur ton système et installe Java OpenJDK 11 en utilisant la commande apt comme ci-dessous.

sudo apt update
sudo apt install default-jdk

Une fois l’installation terminée, vérifie ta version de Java comme ci-dessous.

java -version

Voici la réponse que tu obtiendras.

openjdk version "11.0.7" 2020-04-14
OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-3ubuntu1)
OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-3ubuntu1, mixed mode, sharing)

Comme tu peux le voir, Java OpenJDK 11 est maintenant installé sur le serveur Ubuntu 20.04.

Étape 2 – Configure la variable d’environnement JAVA_HOME

Après avoir installé Java OpenJDK 11, nous allons configurer la variable d’environnement JAVA_HOME sur notre système.

Vérifie toutes les versions de Java disponibles sur ton système à l’aide de la commande suivante.

sudo update-alternatives --config java

Si tu n’as que la version Java OpenJDK sur ton système, tu obtiendras la réponse ci-dessous.

There is only one alternative in link group java (providing /usr/bin/java): /usr/lib/jvm/java-11-openjdk-amd64/bin/java
Nothing to configure.

Si tu utilises plusieurs versions de Java, choisis la version par défaut de Java sur ton environnement.

Comme tu peux le voir, le répertoire d’installation de Java OpenJDK 11 se trouve dans ‘/usr/lib/jvm/java-11-openjdk-amd64’.

Ensuite, modifie la configuration ‘/etc/environnement’ à l’aide de l’éditeur vim.

vim /etc/environment

Colle la configuration suivante dans celle-ci.

JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"

Sauvegarde et ferme.

Ensuite, modifie ton fichier de configuration ‘~/.bashrc’.

vim ~/.bashrc

Ajoute la variable d’environnement suivante dans celui-ci.

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

Sauvegarde et ferme.

Recharge maintenant ta configuration ‘~/.bashrc’ et vérifie la variable d’environnement ‘JAVA_HOME’.

source ~/.bashrc
echo $JAVA_HOME

Voici le résultat que tu obtiendras.

La variable d’environnement ‘JAVA_HOME’ a été créée et se trouve dans le répertoire d’installation de Java OpenJDK 11 ‘/usr/lib/jvm/java-11-openjdk-amd64’.

Étape 3 – Installation et configuration d’Apache Tomcat

Dans cette étape, nous allons télécharger et installer Apache Tomcat 9.0.34. Apache Tomcat sera exécuté sous l’utilisateur ‘tomcat’ dans le répertoire ‘/opt/tomcat’.

Crée un nouvel utilisateur et un nouveau groupe nommés ‘tomcat’ à l’aide de la commande ci-dessous.

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

Ensuite, va dans le répertoire ‘/opt/’ et télécharge Apache Tomcat à l’aide de la commande wget ci-dessous.

cd /opt/
wget -q https://downloads.apache.org/tomcat/tomcat-9/v9.0.34/bin/apache-tomcat-9.0.34.tar.gz

Une fois qu’il est téléchargé, extrais le fichier binaire d’Apache Tomcat et renomme le répertoire en ‘tomcat’.

tar -xf apache-tomcat-9.0.34.tar.gz
mv apache-tomcat-9.*/ tomcat/

Ensuite, change la propriété du répertoire ‘/opt/tomcat’ pour l’utilisateur ‘tomcat’.

chown -R tomcat:tomcat /opt/tomcat
chmod +x /opt/tomcat/bin/*

Apache Tomcat est téléchargé dans le répertoire ‘/opt/tomcat’.

Ensuite, nous allons configurer la variable d’environnement ‘CATALINA_HOME’ d’Apache Tomcat, qui se trouve dans le répertoire ‘/opt/tomcat’.

Modifie la configuration ‘~/.bashrc’ à l’aide de l’éditeur vim.

vim ~/.bashrc

Colle la configuration suivante dans celle-ci.

export CATALINA_HOME=/opt/tomcat

Sauvegarde et ferme.

Recharge maintenant le fichier de configuration ‘~/.bashrc’ et vérifie la variable d’environnement ‘CATALINA_HOME’.

source ~/.bashrc
echo $CATALINA_HOME

Tu obtiendras ‘/opt/tomcat’ comme valeur de la variable d’environnement ‘CATALINA_HOME’.

Tu peux maintenant démarrer Apache Tomcat manuellement à l’aide de la commande suivante.

$CATALINA_HOME/bin/startup.sh

Tu obtiendras le message Apache Tomcat est démarré.

Apache Tomcat est opérationnel sur le système Ubuntu, et il fonctionne sur le port par défaut ‘8080’. Vérifie-le à l’aide de la commande suivante.

ss -plnt

Et tu obtiendras le port ‘8080’ qui est utilisé par l’application Java.

Arrête maintenant Apache Tomcat et change la propriété du répertoire ‘/opt/tomcat’ pour l’utilisateur ‘tomcat’ comme ci-dessous.

$CATALINA_HOME/bin/shutdown.sh
chown -hR tomcat:tomcat /opt/tomcat/

L’installation et la configuration d’Apache Tomcat sont donc terminées.

Étape 4 – Configurer Apache Tomcat comme un service Systemd

Pour ce tutoriel, nous allons exécuter Apache Tomcat en tant que service systemd. Pour cette étape, nous allons créer un nouveau fichier de service systemd nommé ‘tomcat.service’ pour notre installation Apache Tomcat.

Va dans le répertoire ‘/etc/systemd/system’ et crée un nouveau fichier de service ‘tomcat.service’.

cd /etc/systemd/system/
vim tomcat.service

Colle maintenant la configuration suivante dans ce fichier.

[Unit]
Description=Apache Tomcat 9 Servlet Container
After=syslog.target network.target

[Service]
User=tomcat
Group=tomcat
Type=forking
Environment=CATALINA_PID=/opt/tomcat/tomcat.pid
Environment=CATALINA_HOME=/opt/tomcat
Environment=CATALINA_BASE=/opt/tomcat
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
Restart=on-failure

[Install]
WantedBy=multi-user.target

Sauvegarde et ferme.

Ensuite, recharge le gestionnaire systemd.

systemctl daemon-reload

Maintenant, démarre le service Apache Tomcat et ajoute-le au démarrage du système.

systemctl start tomcat
systemctl enable tomcat

Le service Apache Tomcat est en place et fonctionne en tant que service systemd, vérifie-le à l’aide de la commande suivante.

ss -plnt
systemctl status tomcat

Voici le résultat que tu obtiendras.

En conséquence, la configuration d’Apache Tomcat en tant que service systemd est terminée.

Étape 5 – Activer l’authentification d’Apache Tomcat

Dans cette étape, nous allons activer l’authentification Apache Tomcat pour le manager et le host-manager.

Tout d’abord, va dans le répertoire ‘/opt/tomcat/conf’ et modifie la configuration ‘tomcat-users.xml’.

cd /opt/tomcat/conf
vim tomcat-users.xml

Change le nom d’utilisateur et le mot de passe par les tiens et colle la configuration suivante dedans.

<role rolename="manager-gui"/>
<user username="hakase" password="hakasepassword01" roles="manager-gui,admin-gui"/>

Sauvegarde et ferme.

Ensuite, va dans le répertoire ‘/opt/tomcat/webapps/manager/META-INF/’ et modifie la configuration du mnager Apche Tomcat ‘context.xml’.

cd /opt/tomcat/webapps/manager/META-INF/
vim context.xml

Commente la ligne suivante.

<!--  <Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" /> -->

Sauvegarde et ferme.

Ensuite, va dans le répertoire ‘/opt/tomcat/webapps/host-manager/META-INF/’ et modifie la configuration du gestionnaire d’hôte Apache Tomcat ‘context.xml’.

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

Commente la ligne suivante.

<!--  <Valve className="org.apache.catalina.valves.RemoteAddrValve"
         allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" /> -->

Sauvegarde et ferme.

Redémarre maintenant le service Apache Tomcat à l’aide de la commande ci-dessous.

systemctl restart tomcat

L’authentification Apache Tomcat pour le manager et le host-manager a été activée.

Étape 6 – Test

Ouvre ton navigateur Web et tape l’adresse IP du serveur avec le port 8080. Et tu verras la page d’index par défaut d’Apache Tomcat qui t’informe que l’installation a réussi.

http://10.5.5.34:8080/

Ensuite, ajoute le chemin ‘/manager/html’ à l’URL et tu seras invité à demander l’authentification du gestionnaire Tomcat.

http://10.5.5.34:8080/manager/html

Tape ton nom d’utilisateur et ton mot de passe, et tu obtiendras le tableau de bord du gestionnaire Apache Tomcat.

Ensuite, va dans le gestionnaire de l’hôte virtuel Apache Tomcat ‘/host-manager/html’.

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

Et tu obtiendras le gestionnaire d’hôtes virtuels Apache Tomcat comme ci-dessous.

Par conséquent, l’installation d’Apache Tomcat sur Ubuntu 20.04 a été effectuée avec succès.

Vous aimerez aussi...