Ala Eddine BEN SALEM

Anne 2013-2014

EPITA App-Ing2
J2EE

T.P. 1
TOMCAT

Prsentation de Tomcat:
Pour excuter des servlets et/ou des JSPs, il nous faut un conteneur Web. Nous prsentons ici l'un
d'eux, Tomcat 6 disponible l'url http://jakarta.apache.org/tomcat/ (Ne pas tlcharger).
Nous indiquerons dans la suite la dmarche pour l'installer et pour dployer des applications Web
dans une instance d'un serveur Tomcat.
Tomcat est un conteneur Web J2EE diffus en open source sous une licence Apache. C'est aussi
l'implmentation de rfrence des spcifications servlets et JSP implmentes dans les diffrentes
versions de Tomcat.
En tant qu'implmentation de rfrence, facile mettre en oeuvre et riche en fonctionnalits,
Tomcat est quasi incontournable dans les environnements de dveloppements. Les qualits de ces
dernires versions lui permettent d'tre de plus en plus utilis dans des environnements de
production.
Il existe plusieurs versions de Tomcat qui mettent en oeuvre des versions diffrentes des
spcifications des servlets et des JSP :
Version de
Version Servlet
Version JSP
Version EL
Version Java
Tomcat
3.0, 3.1, 3.2,
3.3

2.2

1.1

4.0, 4.1

2.3

1.2

5.0

2.4

2.0

2.0

1.4

6.0

2.5

2.1

2.1

1.5

7.0

3.0

2.2

2.2

1.6

1.2

1. L'installation:
Tomcat est une application crite en Java, il est possible de l'installer et de l'excuter sous tous les
environnements disposant d'une machine virtuelle Java : un JRE et mme un JDK pour certaine
ancienne version est un pr requis pour permettre sont excution.
Pour faire marcher Tomcat 6, vous devez avoir sur votre machine, soit un JRE (5.0 or later), soit un
JDK (5.0 or later). Sinon, tlcharger puis installez le JRE (5.0 or later) l'adresse :
http://www.oracle.com/technetwork/java/javase/downloads/index.html

Ensuite, il faut que la variable d'environnement JAVA_HOME (ou JRE_HOME) soit dfinie avec
comme valeur le rpertoire d'installation du JDK (ou du JRE). Ceci permet notamment Tomcat de
trouver le compilateur Java pour compiler les JSP.
Sur une machine Windows XP une variable d'environnement peut tre cre de la faon
suivante : Menu Dmarrer -> Panneau de configuration -> Systme -> Onglet [Avanc] -> Bouton
[Variables d'environnement].
L'installation de Tomcat de faon universelle se fait simplement :Tomcat est fourni dans une archive
de type zip qu'il faut tlcharger puis dcompresser dans un rpertoire.Tlchargez la version 6.0 de
Tomcat l'adresse suivante:
http://apache.mirrors.multidist.eu/tomcat/tomcat-6/v6.0.37/bin/apache-tomcat-6.0.37.zip

Le rpertoire d'installation de Tomcat 6.x contient plusieurs rpertoires :

bin : scripts et excutables pour grer Tomcat

conf : fichiers de configuration du serveur Tomcat
logs : journaux de Tomcat et des applications web
webapps : rpertoire de dploiement des applications web
work : rpertoire de travail (rpertoires et fichiers notamment pour la compilation des JSP)

Le rpertoire conf contient les fichiers de configuration suivants :

Fichier

Rle

catalina.properties

Configuration du chargement des classes

par Tomcat

context.xml

Configuration par dfaut utilis par tous

les contextes

logging.properties

Configuration des logs de Tomcat

server.xml

Configuration du serveur Tomcat

tomcat-users.xml

Contient les donnes utiles pour

l'authentification et pour les habilitations
(user et rle)

web.xml

Descripteur de dploiement par dfaut

utilis pour toutes les applications web
avant de traiter le fichier des applications

2. L'excution de Tomcat:
Le lancement de Tomcat s'effectue en utilisant un script fourni dans le sous rpertoire bin
d'installation de Tomcat.
Sous Windows: Pour lancer Tomcat, il suffit d'excuter le script startup.bat du sous rpertoire bin.
Pour arrter Tomcat, il suffit d'excuter le script shutdown.bat du sous rpertoire bin.

Lancez Tomcat en utilisant le script Startup.bat dans une bote de console DOS pour avoir afficher
les logs. Vous devez obtenir dans la console DOS, le message suivant:
INFO: Server startup in ms
Si un message d'erreur s'affiche, il faut vrifier que la variable d'environnement JAVA_HOME (ou
JRE_HOME) est prsente. Celle-ci doit dsigner le dossier d'installation d'un JDK (ou d'un JRE).

3. La vrification de l'excution:
Pour vrifier la bonne excution du serveur, il suffit d'ouvrir un navigateur et de saisir dans une url
la machine hte et le port d'coute du connecteur http de Tomcat
Dans notre exemple, il faut saisir: http://localhost:8080/
Si la page d'accueil de Tomcat ne s'affiche pas dans le navigateur :

consulter les logs pour dterminer l'origine du problme.

il faut vrifier l'url saisie (nom de l'hte et surtout le numro du port qui doit correspondre
celui configur dans le fichier server.xml).
si un proxy est utilis, inhiber l'utilisation de se dernier pour l'url utilise notamment en local
vrifier que le port utilis n'est pas dj utiliser par un autre service ou serveur

On pourra suivre le lien Servlets Examples par exemple pour vrifier la correcte installation de
Tomcat. Tous les liens de la page [http://localhost:8080] prsentent un intrt et l'tudiant est invit
les explorer. Nous aurons l'occasion de revenir sur les liens permettant de grer les applications
web dployes au sein du serveur, notamment le lien: Tomcat Manager .

4. Le gestionnaire d'applications (Tomcat manager):

Tomcat fourni une application web Tomcat manager pour permettre la gestion des applications
web excute sur le serveur sans avoir procder un arrt/redmarrage de Tomcat.
Cette application permet :

Lister les applications dployes avec leur tat et le nombre de sessions ouvertes
Dployer une nouvelle application
Arrter, Dmarrer et Recharger une application
Supprimer une application ( Retirer )
Obtenir des informations sur la JVM et l'OS

Revenez la page d'accueil de Tomcat [http://localhost:8080] et suivez le lien [Tomcat Manager]

(ou en utilisant l'uri /manager/html): Vous obtenez alors une page d'authentification. Identifiez-vous
comme manager/manager.
Si a ne marche pas, c'est normal. En effet, l'utilisation du manager est soumise une
authentification pralable avec un utilisateur possdant le rle manager. Ceci est configur dans le
fichier /conf/tomcat-users.xml. Par dfaut, aucun utilisateur ne possde ce rle : il est donc
ncessaire de l'ajouter.
Le tag <role> permet de dfinir un rle. Il faut ajouter le rle manager si ce dernier n'est pas dfini.
Le tag <user> permet de dclarer un utilisateur en prcisant son nom avec l'attribut username, son
mot de passe avec l'attribut password et en lui associant un ou plusieurs rles avec l'attribut roles.
Une fois authentifi, vous obtenez la page principale de l'application Tomcat manager , cette
page est compose de plusieurs parties:

La partie applications affiche la liste des applications dployes et permet de les grer.

La partie Serveur affiche quelques informations sur les versions de Tomcat, de la JVM et de
l'OS d'excution.

La partie Deploy permet de dployer une nouvelle application web.

5. Le dploiement d'une application:

Tlchargez le war de l'application web Hello World : sample.war l'adresse
http://www.lrde.epita.fr/~ala/
La partie Fichier WAR dployer permet de slectionner un fichier de type war du poste local,
de le tlcharger sur le serveur, de le dployer dans Tomcat et de redmarrer l'application.
Cliquez sur Choisir le fichier, slectionner le fichier sample.war (tlcharg) et cliquez sur
Deployer.
Vrifiez que le fichier sample.war est copi dans le rpertoire webapp et dploy par Tomcat
(Tomcat est configur par dfaut pour dployer automatiquement les fichiers .war du rpertoire
webapp).
Vrifiez que l'application dploye /sample est ajoute la liste des applications affiche par le
Manager.
Testez l'application dploye en cliquant sur le lien /sample ou en utilisant l'URL:
http://localhost:8080/sample/ dans une autre fentre du navigateur.
Dans la page du Manager, il est possible :

d'arrter l'application en cliquant sur le lien Arrter ,

de dmarrer l'application en cliquant sur le lien Dmarrer ,

de recharger l'application (quivalent un arrt/dmarrage conscutif) en cliquant sur le lien

Recharger ,

de supprimer l'application en cliquant sur le lien Retirer .

6. Modification de l'application:

Modifier la JSP hello.jsp pour afficher (dynamiquement) la date du jour:

<%= new java.util.Date() %>

Modifier la JSP hello.jsp pour afficher (dynamiquement) le texte suivant :

Hello + [valeur paramtre nom] + [valeur paramtre prenom].
Indication: Dans une requte de type GET, pour envoyer les valeurs des paramtres il faut
ajouter un texte de la forme ?param1=valeur1&param2=valeur2... la fin de
l'URL saisir dans le client Web (i.e. le navigateur).
Dans notre exemple, pour appeler la JSP hello.jsp avec un paramtre nom gale
Gosling et un paramtre prenom gale James, on doit saisir l'URL:
http://localhost:8080/sample/hello.jsp ?nom=Gosling&prenom=James.
Du ct du serveur J2EE, pour rcuprer les valeurs des paramtres dans le code de la JSP, il
faut utiliser un code Java de la forme:
<%= request.getParameter("nom") %> (affiche Gosling).

Mme question mais sans ajouter des paramtres dans l'URL.

Pour envoyer une requte de type POST, il faut ajouter au code de la JSP hello.jsp le
formulaire HTML suivant:
<FORM METHOD=POST ACTION="... .jsp">
Entrer votre nom :
<INPUT TYPE=TEXT NAME="nom">
...
<INPUT TYPE=SUBMIT VALUE="afficher">
</FORM>

Une fois ce formulaire affich, l'utilisateur peut cliquer sur le bouton afficher. Cette action
gnre (ct client) une requte de type POST contenant les paramtres et leurs valeurs, puis
cette requte est envoye au serveur pour tre traiter par la JSP hello.jsp.
Attention: la JSP hello.jsp affiche la fois le formulaire permettant d'envoyer la requte et la
rponse cette requte.

7. Bienvenu dans le monde client/serveur:

Dmarrer un nouveau client sur votre machine, puis essayer d'envoyer une requte vers le
serveur Tomcat de votre voisin.
Indication: Pour envoyer une requte vers un serveur distant, il faut remplacer localhost
par l'adresse IP de la machine hbergeant le serveur.

8. Exploration de l'arborescence du serveur:

Modifier la configuration du serveur pour remplacer sample par helloWord comme contexte
dans l''URL. Le but est d'avoir des URLs de la forme: http://localhost:8080/helloWord/... .

9. Taches faire pour le prochain TP:

- Tlcharger "Eclipse IDE for Java EE Developers" l'adresse:

http://www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/indigosr1

- Tlcharger le serveur d'applications "JBoss" (avant le TP sur les EJBs) l'adresse:

http://sourceforge.net/projects/jboss/files/JBoss/JBoss-5.0.0.GA/jboss-5.0.0.GA.zip/download