Apache Tomcat est une implémentation open source des technologies Java Servlet, JavaServer Pages, Java Expression Language et Java WebSocket. C'est l'un des serveurs d'applications et Web les plus largement adoptés dans le monde aujourd'hui. Tomcat est simple à utiliser et dispose d'un solide écosystème 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.
Prérequis #
Pour pouvoir installer des packages sur votre système Ubuntu, vous devez être connecté en tant qu'utilisateur avec des privilèges sudo.
Étape 1 :Installer OpenJDK #
Tomcat nécessite l'installation de Java. Nous allons installer 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 updateInstallez le package OpenJDK en exécutant :
sudo apt install default-jdkÉtape 2 :Créer un numéro d'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 système et un groupe 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 allons télécharger 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 9.0.27 . Avant de passer à l'étape suivante, vous devez vérifier la page de téléchargement pour une nouvelle version. S'il y a une nouvelle version, copiez le lien vers le Core tar.gz fichier, qui se trouve dans la section Distributions binaires.
Commencez par télécharger l'archive Tomcat dans le /tmp répertoire en utilisant le wget suivant commande :
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 vers /opt/tomcat répertoire :
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é latest qui pointe vers le répertoire d'installation de Tomcat :
sudo ln -s /opt/tomcat/apache-tomcat-9.0.27 /opt/tomcat/latestPlus tard, si vous souhaitez mettre à niveau votre instance Tomcat, décompressez simplement la version la plus récente et modifiez le lien symbolique pour qu'il pointe vers la dernière version.
Comme nous l'avons mentionné dans la section précédente, Tomcat fonctionnera sous le tomcat utilisateur. Cet utilisateur doit avoir accès au répertoire d'installation de tomcat.
La commande suivante modifie la propriété du répertoire en utilisateur et groupe tomcat :
sudo chown -RH tomcat: /opt/tomcat/latest
Les scripts à l'intérieur de bin le répertoire doit avoir un drapeau exécutable :
sudo sh -c 'chmod +x /opt/tomcat/latest/bin/*.sh'Étape 4 :Créer un numéro de 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 le /etc/systemd/system/ :
sudo nano /etc/systemd/system/tomcat.serviceCollez la configuration suivante :
/etc/systemd/system/tomcat.service[Unit]
Description=Tomcat 9 servlet container
After=network.target
[Service]
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
[Install]
WantedBy=multi-user.target
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-reloadDémarrez le service Tomcat en exécutant :
sudo systemctl start tomcatVé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'erreurs, activez le démarrage automatique du service Tomcat au démarrage :
sudo systemctl enable tomcatÉtape 5 :Ajustez le numéro de 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/tcp8080 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 les rôles Tomcat sont définis dans le tomcat-users.xml dossier. Ce fichier est un modèle avec des commentaires et des exemples décrivant comment configurer un utilisateur ou un rôle.
sudo nano /opt/tomcat/latest/conf/tomcat-users.xml
Pour ajouter un nouvel utilisateur ayant accès à l'interface Web de Tomcat (manager-gui et admin-gui), nous devons définir l'utilisateur dans le tomcat-users.xml fichier, comme indiqué ci-dessous. Assurez-vous de changer le nom d'utilisateur et le mot de passe pour quelque chose de plus sûr :
<tomcat-users>
<!--
Comments
-->
<role rolename="admin-gui"/>
<role rolename="manager-gui"/>
<user username="admin" password="admin_password" roles="admin-gui,manager-gui"/>
</tomcat-users>Par défaut, l'interface de gestion Web de Tomcat est configurée pour limiter l'accès aux applications Manager et Host Manager uniquement à partir de l'hôte local.
Si vous souhaitez pouvoir accéder à l'interface Web depuis une adresse IP distante, vous devrez supprimer ces restrictions. Cela peut avoir diverses implications en matière de sécurité et n'est pas recommandé pour les systèmes de production.
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.xmlPour l'application Host Manager, ouvrez le fichier suivant :
sudo nano /opt/tomcat/latest/webapps/host-manager/META-INF/context.xml<Context antiResourceLocking="false" privileged="true" >
<!--
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" />
-->
</Context>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 IP publique est 45.45.45.45 vous feriez la modification suivante :
<Context antiResourceLocking="false" privileged="true" >
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1|45.45.45.45" />
</Context>
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://<your_domain_or_IP_address>:8080
En supposant que l'installation est réussie, un écran semblable au suivant devrait apparaître :
Le tableau de bord du gestionnaire d'applications Web Tomcat est disponible sur http://<your_domain_or_IP_address>:8080/manager/html . À partir de là, vous pouvez déployer, annuler le déploiement, démarrer, arrêter et recharger vos applications.
Vous pouvez vous connecter avec l'utilisateur que vous avez créé à l'Step 6 .
Le tableau de bord du gestionnaire d'hôte virtuel Tomcat est disponible sur http://<your_domain_or_IP_address>:8080/host-manager/html . À partir de là, vous pouvez créer, supprimer et gérer des hôtes virtuels Tomcat.
