La version 5.0.x de Tomcat est disponible dans le dépot 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épot 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.

• Disposer des droits d'administration
• Java JRE/SDK 1.4 ou supérieur (paquet sun-java5-jdk ou sun-java5-jre recommandé)
• Accès aux dépôts APT universe

Installez les paquets paquets tomcat5, tomcat5-admin et tomcat5-webapps du dépôt universe. A 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 là 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:

JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun

Redémarrerez ensuite Tomcat avec la commande

sudo /etc/init.d/tomcat5 restart

Vous devriez normalement avoir les message suivant:

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.

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é.

A 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

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:

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <!-- Utilisateurs administrateur de tomcat -->
  <role rolename="manager"/>
  <role rolename="admin"/>
  <user username="NOM_D_UTILISATEUR" password="MOT_DE_PASSE" roles="admin,manager"/>
  <!-- On peut ajouter d'autre rôles/utilisateurs/groupes pour les applications web déployées sur le serveur -->
</tomcat-users>

• 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."

• Site officiel d'Apache Tomcat
• Documentation officielle de Tomcat 5.0.x

Traduction par Angelo d'un 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 Noodle.

Versions des logiciels utilisés :

• SDK: 1.5
• JRE: 1.5
• Tomcat: 5.5

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

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".

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

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.

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 !

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.