✎ applications: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.

====== Tomcat ======

===== Installation via paquets =====

La version 5.0.x de Tomcat est disponible dans le dépôt //universe// sous Ubuntu 6.06 LTS (Dapper) et Ubuntu 6.10 (Edgy). La version 5.5.x est également disponible dans ce même dépôt sous Ubuntu 6.10. Ce section présente l'installation de la version 5, la procédure est sensiblement la même pour la version 5.5, seul les noms des paquets changent.

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

* Disposer des [[:sudo|droits d'administration]].
  * [[:java|Java JRE/SDK]] 1.4 ou supérieur (paquet //sun-java5-jdk// ou //sun-java5-jre// recommandé).
  * Accès aux [[:depots#universe_et_multiverse|dépôts APT]] //universe//.

==== Installation ====

Installez les paquets paquets //tomcat5//, //tomcat5-admin// et //tomcat5-webapps// du //[[:depots#universe_et_multiverse|dépôt universe]]//. À l'installation du paquet, Tomcat est automatiquement démarré et, normalement, fonctionnel. Vous pouvez vérifier présence en visitant http://localhost:8180/.

Il est possible qu'à l'installation du paquet, Tomcat ne soit pas correctement configuré pour utiliser un JRE installé ou que vous souhaitiez le voir utiliser un autre que celui par défaut. Dans ce cas, éditez le fichier « /etc/default/tomcat5 » et trouvez la ligne avec l'option « JAVA_HOME ». Décommentez-la et indiquer le chemin de la JRE ou du JDK que vous souhaitez utiliser. Dans le cas du JDK installé via la paquet « sun-java5-jdk »,  utilisez « /usr/lib/jvm/java-1.5.0-sun », et la ligne suivante :
<code sh>
JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun
</code>
Redémarrez ensuite Tomcat avec la commande :

sudo /etc/init.d/tomcat5 restart

Vous devriez normalement avoir les messages suivants :
  Stopping Tomcat 5 servlet engine: ..tomcat5.
  Starting Tomcat 5 servlet engine using Java from /usr/lib/jvm/java-1.5.0-sun: tomcat5.
Le premier indique l'arrêt de l'instance déjà démarrée. Si à l'installation du paquet, une JRE n'avait pas été trouvé par la procédure automatique, un message d'erreur apparaîtrait à la place. Le second message indique le démarrage d'une nouvelle instance et indique le JRE utilisé (ici « /usr/lib/jvm/java-1.5.0-sun »), ce qui permet de vérifier la prise en compte du fichier de configuration « /etc/default/tomcat5 ».

==== Utilisation/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 si 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 comportent, vous pouvez le faire via la commande ''update-rc.d'':
  sudo update-rc.d tomcat5 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 tomcat5 defaults

=== Interfaces d'administration ===
Le paquet « tomcat5-admin » installe deux interfaces Web d'administration. Elle sont disponibles aux adresses http://localhost:8180/admin/ et http://localhost:8180/manager/html mais nécessite 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/conf/tomcat-users.xml » :
<code xml>
<?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>

=== 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 ».
  * Le //webapps// déposées dans « /var/lib/tomcat5/webapps » (fichiers WAR ou répertoire en respectant la structure) sont automatiquement et dynamiquement déployées.

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 »).

Par ailleurs la version 5.5 disponible actuellement sur les dépôts a un bug qui  empêche les « jsp-exemples » de fonctionner. Ce bug ne touche QUE ces exemples et n'est pas le signe d'un problème global de configuration. Pour le corriger il faut éditer :

/var/lib/tomcat5.5/webapps/jsp-examples/WEB-INF/tagPlugins.xml

et remplacer les « jstl. » par « jstl.core. ».

==== Références ====
  * [[http://tomcat.apache.org/|Site officiel d'Apache Tomcat]]
  * [[http://tomcat.apache.org/tomcat-5.0-doc/index.html|Documentation officielle de Tomcat 5.0.x]]

===== Installation manuelle =====

Traduction par [[http://forum.ubuntu-fr.org/profile.php?id=7021|Angelo]] d'un [[http://www.ubuntuforums.org/showthread.php?p=226828#post226828|post]] de Noodle, sur le forum Ubuntu anglais.

Note : Cette installation n'est pas prévue pour un usage développement. Pour une installation développement, merci de vous reporter au post de [[http://www.ubuntuforums.org/showthread.php?p=226828|Noodle]].

Versions des logiciels utilisés :
  * SDK: 1.5
  * JRE: 1.5
  * Tomcat: 5.5

==== Etape 1 : Installation de JRE et SDK ====

Java est disponible via Synaptic. Installez donc les paquets suivants (attention les dépots multiverses doivent être sélectionnés) ou dans un terminal, tapez :

sudo apt-get install sun-java5-bin sun-java5-fonts sun-java5-jdk sun-java5-jre

Note : SDK demande 146 Mo et JRE 84.7 Mo sur votre disque dur.

Il faut ensuite s'assurer que le Java de votre système est bien celui installé, et pas GCJ (alternative open source). Pour cela utilisez la commande

sudo update-java-alternatives -l

Cela devrait renvoyer un résultat du type :

java-1.5.0-sun 53 /usr/lib/jvm/java-1.5.0-sun

Pour activer la bonne version, il suffit d'appeler la même commande, avec des paramètres différents :

sudo update-java-alternatives -s java-1.5.0-sun

Pour vérifier que les deux paquetages sont correctement installés, vérifier que vous obtenez une réponse lorsque vous tapez ceci dans un terminal :

java -version

==== Etape 2 : Téléchargement de Tomcat ====

Télécharger Tomcat 5.5 depuis [[http://jakarta.apache.org/site/downloads/]]. Dans cet exemple, nous utilisons jakarta-tomcat-5.5.9.tar.gz. Puis décompresser l'archive :

tar xvfz jakarta-tomcat-5.5.9.tar.gz

Note : pour simplifier les choses, j'ai également renommé le package en "tomcat". Si vous ne le faites pas, assurez-vous de rectifier ce tutoriel  avec le nom de votre package lorsque vous voyez "tomcat".

==== Etape 3 : Installation de Tomcat ====

Placer l'archive décompréssée dans /usr/local/

==== Etape 4 : JAVA_HOME and CLASSPATH ====

Vous devez créer un lien avec l'emplacement où vous avez installé Java SDK. Pour cela vous devrez éditer le fichier ".bashrc', aussi sauvegardez-le avant !

gedit ~/.bashrc

Ajouter les lignes suivantes :

export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun
       export CLASSPATH=/usr/local/tomcat/common/lib/jsp-api.jar:/usr/local/tomcat/common/lib/servlet-api.jar

Note : pensez à changer le mot tomcat vers le nom du package placé dans /usr/local/

Enregistrer et fermer. Vous devez maintenant clôturer votre session et la réouvrir avant que les changements ne prennent effet.

==== Etape 5 - Démarrage de Tomcat ====

Tomcat doit maintenant être opérationnel. Pour le lancer, taper dans un terminal :

sh /usr/local/tomcat/bin/startup.sh

Si tout fonctionne correctement, vous devez voir les messages suivants :

Using CATALINA_BASE:   /usr/local/tomcat
       Using CATALINA_HOME:   /usr/local/tomcat
       Using CATALINA_TMPDIR: /usr/local/tomcat/temp
       Using JRE_HOME:       /usr/lib/j2sdk1.5-sun/

Dans votre naviguateur, taper [[http://localhost/]] et vérifier que votre serveur fonctionne. Si vous n'avez pas changé le numéro de port de Tomcat, pointer vers [[http://localhost:8080/]]. Vous devez normalement vous trouvez sur la page d'accueil de Tomcat !

Pour arrêter Tomcat, taper dans un terminal :

sh /usr/local/tomcat/bin/shutdown.sh

Voilà, c'est fini !

==== Etape 6 - Installation de l'interface admin et manager de Tomcat ====

L'interface de management est déjà présente dans le paquet core de tomcat mais aucun utilisateur n'est défini pour y accéder. Nous allons voir comment définir cet utilisateur et comment installer l'interface d'administration par la même occasion.

Il faut récupérer l'archive correspondant à l'interface d'administration sur [[http://tomcat.apache.org/]]
Puis le décompresser avec la commande :

tar xvfz apache-tomcat-5.x.x-admin.tar.gz

Une fois décompressé on obtient le dossier : apache-tomcat-5.x qui contient les dossiers conf et server.

Il faut copier leur contenu dans l'arborescence de tomcat :

cd apache-tomcat-5.x/
		mv ./conf/Catalina/localhost/admin.xml /usr/local/tomcat/conf/Catalina/localhost/
		mv ./server/webapps/admin /usr/local/tomcat/server/webapps/

Ensuite il faut configurer les utilisateurs ayant droit d'accéder à cette interface. Ca se trouve dans le fichier : **/usr/local/tomcat/conf/tomcat-users.xml**

Rajouter une ligne entre les deux balises <tomcat-users> du style :

<tomcat-users>
			...
			...
			<user username="admin" password="mon_mot_de_passe" roles="admin,manager"/>
		</tomcat-users>

Redémarrer tomcat :

sh /usr/local/tomcat/bin/shutdown.sh
		sh /usr/local/tomcat/bin/startup.sh

Ceci permet d'accéder à l'interface d'administration et de management de tomcat via ces urls :
[[http://localhost:8080/admin]]  et  [[http://localhost:8080/manager]]

Les mots de passes sont ceux définis dans le fichier tomcat-users.xml.

===== 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/share/tomcat5.5''.
  - cliquez sur //OK//.

Merci de recopier le code ci-contre pour prouver que vous êtes humain : C E Q S A 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