✎ tomcat [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Apache Tomcat ======

**Apache Tomcat** est un  conteneur de servlet [[wpfr>Java EE|Java EE]]. Issu du projet [[wpfr>Apache Jakarta|Jakarta]], Tomcat est désormais un projet principal de la [[wpfr>Apache Software Foundation|fondation Apache]]. Tomcat implémente les spécifications des servlets et des [[wpfr>JavaServer Pages|JSP]] de [[wpfr>Sun Microsystems]]. Il inclut des outils pour la configuration et la gestion, mais peut également être configuré en éditant des fichiers de configuration XML. Comme Tomcat inclut un serveur HTTP interne, il est aussi considéré comme un [[wpfr>serveur HTTP]].

<note important>Cette page nécessite un ménage. Il faudrait nettoyer toute mention des versions d'Ubuntu désuètes, spécifier que pour 8.04 (Hardy) c'est tomcat5.5, et pour les versions suivantes c'est tomcat7 ; vérifier les pré-requis en fonction des versions. </note>

===== Installation tasksel =====

==== Installation ====

Installation d'un serveur tomcat7 pour Ubuntu 14.04 LTS  : **[[apt>tomcat7]]**
<note tip>Pour Ubuntu 22.04, c'est probablement tomcat9.</note>
//It works !// doit apparaître sur la page

[[http://localhost:8080/]]

==== Configuration ====

Changer éventuellement la version de java utilisée en [[:tutoriel:comment_modifier_un_fichier|modifiant le fichier]] **/etc/default/tomcat7**. Changer ou ajouter la variable **JAVA_HOME** en fonction de votre configuration :
<file>JAVA_HOME=/usr/lib/jvm/java-6-sun
JAVA_HOME=/usr/lib/jvm/java-1.6.0-openjdk-amd64
JAVA_HOME=/usr/lib/jvm/java-1.7.0-openjdk-amd64
JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64</file>

Pour ensuite pouvoir se connecter aux consoles d'administration, il faut ajouter un utilisateur. [[:tutoriel:comment_modifier_un_fichier|Ajouter fichier]] **/etc/tomcat7/tomcat-users.xml** entre les balises **<tomcat-users>** et **</tomcat-users>** (voir les exemples en commentaire dans le fichier):

<file>
<role rolename="manager-gui"/>
<role rolename="admin-gui"/>
<user username="<utilisateur>" password="<mot_de_passe>" roles="admin-gui,manager-gui"/>
</file>

<note>Remplacer <utilisateur> et <mot_de_passe> respectivement par le nom d'utilisateur et le mot de passe que vous souhaitez utiliser</note>

Enfin, changer les droits sur le dossier de tomcat7 :

<code>sudo chgrp -R tomcat7 /etc/tomcat7
sudo chmod -R g+w /etc/tomcat7</code>

Une fois la configuration terminée, relancer le service tomcat7 :

sudo service tomcat7 restart
==== Utilisation ====

Vous pouvez désormais accéder aux panneaux de configurations :

[[http://localhost:8080/manager/html]]

[[http://localhost:8080/host-manager/html]]

**Source :** [[https://help.ubuntu.com/12.04/serverguide/tomcat.html|Apache Tomcat sur la documentation officielle de Ubuntul]]

===== Installation par les paquets =====

==== Pré-requis ====

* Disposer des [[:sudo|droits d'administration]].
  * [[:java|Java SDK]]
==== Installation ====

Pour les nouvelles versions d'ubuntu utiliser **tomcat7** [[apt>tomcat7,tomcat7-admin,tomcat7-examples|tomcat7, tomcat7-admin et tomcat7-examples]].\\
À l'installation du paquet, Tomcat est automatiquement démarré et, normalement, fonctionnel. Vous pouvez vérifier en visitant http://localhost:8080/.

Il se peut que Tomcat soit accessible sur un autre port. Si l'adresse ci-dessus ne fonctionne pas, essayez http://localhost:8180/.

==== Utilisation et configuration ====

=== Arrêt et démarrage ===

Tomcat peut être démarré et arrêté comme un « dæmon » standard //via// le script « /etc/init.d/tomcat5 » avec les options « start », « stop » et « restart » pour la démarrer, l'arrêter ou le redémarrer. L'option « status » permet de savoir s'il est déjà lancé.

À l'installation, le système est configuré pour démarrer Tomcat au démarrage de l'ordinateur. Si vous souhaitez changer ce comportement, vous pouvez le faire //via// la commande « update-rc.d » :

sudo update-rc.d tomcat7 remove

Si Tomcat n'est pas démarré avec la machine et que vous souhaitez que ce soit le cas, utilisez :

sudo update-rc.d tomcat7 defaults

=== Interfaces d'administration ===

Le paquet « tomcat6-admin » installe deux interfaces Web d'administration. Elle sont disponibles aux adresses http://localhost:8080/admin/ et http://localhost:8080/manager/html mais nécessitent la configuration manuelle d'un utilisateur administrateur.

Cette configuration se fait en ajoutant un (ou plusieurs) utilisateur(s) et deux rôles dans le fichier « /var/lib/tomcat5.5/conf/tomcat-users.xml » ou « /var/lib/tomcat6/conf/tomcat-users.xml », sur les nouvelles versions il est dans « /etc/tomcat8/tomcat-users.xml » :
<code>
<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  
  <role rolename="manager"/>
  <role rolename="admin"/>
  <user username="NOM_D_UTILISATEUR" password="MOT_DE_PASSE" roles="admin,manager"/>
  
</tomcat-users>
</code>
Puis relancer Tomcat pour tester ces comptes :
<code> /etc/init.d/tomcat7 restart</code>

=== Notes concernant la configuration ===
  * Les fichiers « web.xml » et « server.xml » se trouvent dans « /etc/tomcat5/ ».
  * Le paramètre « ''-security'' » est activé par défaut. Les permissions liée à la sécurité Java sont dans des fichiers sous « /etc/tomcat5/policy.d ».
  * Le reste des fichiers se trouvent dans « /var/lib/tomcat5.5 ».
  * Les //webapps// déposées dans « /var/lib/tomcat5.5/webapps » (fichiers WAR ou répertoire en respectant la structure) sont automatiquement et dynamiquement déployées.

{{:icons:icone_danger.png  |Attention}}
> Le paramètre « ''TOMCAT_SECURITY=yes'' » empêche certaines applications de fonctionner (scripts d'installation de CMS, par exemple). Il faut se rendre dans « /etc/init.d/tomcat5.5 » et passer le paramètre à « no » (« ''TOMCAT_SECURITY=no'' »).

===== Notes =====
==== Tomcat et Eclipse ====

Pour utiliser Tomcat avec Eclipse (dans le cas de projet commun Windows et Linux), vous devez rajouter une variable dans les perspectives d'Eclipse.

- allez dans le menu //Windows → Preferences//.
  - élément //Java → Build path → Classpath Variables// de l'arbre de gauche.
  - cliquez sur //New//.
  - comme ''NAME'', introduisez ''TOMCAT_HOME''.
  - comme ''Path'', introduisez ''/usr/local/tomcat''. (ou ''/usr/share/tomcat6'' le cas échéant)
  - cliquez sur //OK//.

=== Impossible d'ajouter un serveur tomcat sous eclipse ===
Si vous n'arrivez pas à ajouter un serveur tomcat sous éclipse avec// Windows → preferences → server → runtime environments → add// ou que celui-ci n’apparaît pas dans la vue serveur suivez les instructions suivantes:

== Pour tomcat7 ==
1. Pour résoudre l'erreur ** 'Cannot create a server using the selected type'**
<file>
cd ~/workspace/.metadata/.plugins/org.eclipse.core.runtime/.settings/
rm org.eclipse.jst.server.tomcat.core.prefs
rm org.eclipse.wst.server.core.prefs
</file>

2. Pour résoudre l'erreur ** 'Could not load the Tomcat server configuration at /usr/share/tomcat7/conf. The configuration may be corrupt or incomplete /usr/share/tomcat7/conf/catalina.policy (No such file or directory)' **
<file>
cd /usr/share/tomcat7
sudo ln -s /var/lib/tomcat7/conf conf
sudo ln -s /etc/tomcat7/policy.d/03catalina.policy conf/catalina.policy
sudo ln -s /var/log/tomcat7 log
sudo chmod -R 777 /usr/share/tomcat7/conf
</file>
[[https://stackoverflow.com/questions/13423593/eclipse-4-2-juno-cannot-create-a-server-using-the-selected-type-in-tomcat-7|source]]

=== Accéder à Tomcat6 par le port 80 ===
Pour pouvoir se connecter à Tomcat à partir du port 80 :
<file>
/sbin/iptables -t nat -A PREROUTING -j REDIRECT -p tcp --destination-port 80 --to-ports 8080
</file>

==== Tomcat couplé avec Apache 2 et SSL ====

[[tutoriel:comment_coupler_apache_et_tomcat_avec_support_ssl|Comment coupler Apache2 avec un serveur d'application Tomcat (avec support SSL) ?]]
===== Liens & références =====

* [[https://tomcat.apache.org/|Site officiel d'Apache Tomcat]]
  * [[https://tomcat.apache.org/tomcat-5.5-doc/index.html|Documentation officielle de Tomcat 5.5.x]]
  * Introduction : article encyclopédique « [[wpfr>Tomcat (serveur)]] » sur Wikipedia
  * Un [[http://www.progenvrac.com/spip.php?article1|tutoriel]] pour l'installation de Tomcat 6.*.*
  * [[:jetty|Jetty]], un autre conteneur de servlets
  * [[http://www.it-connect.fr/tutoriels/serveur-web/tomcat/|Plusieurs tutoriels sur Tomcat]] sur IT-Connect

----

// Contributeurs : [[utilisateurs:ostaquet]], [[utilisateurs:strzel_a]] [[utilisateurs:jahbromo]], Brzhk, [[utilisateurs:clement.analogue]], [[utilisateurs:ph3nix_]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : R S F R O Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported