Comment installer Tomcat ?

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.