note technique ---------- j2ee

Date de modification : 19/04/07 - 14:38:13
Version : 1.0 Page : 1/5
Description : Installation d'un serveur Tomcat pour
héberger des applications J2EE
NOTE TECHNIQUE
----------
«IINSTALLATION D'UN SERVEUR TOMCAT
POUR HÉBERGER DES APPLICATIONS J2EE»
Établi par : Adrien Cheype Le : 19/04/07
Vérifié par : Philippe de Saint Léger Le : 19/04/07
Validé par : Michel Ménézo Le : 19/04/07

Date de modification : 19/04/07 - 14:38:13
Version : 1.0 Page : 2/5
Description : Installation d'un serveur Tomcat pour
héberger des applications J2EE
Ce document présente la démarche à effectuer pour installer les outils nécessaires permettant d'héberger des
applications J2EE sur un serveur sous CentOs.
Pour cela deux étapes sont nécessaires :
●l'installation de l'environnement d'exécution Java 6 (JRE)
●l'installation du serveur Tomcat 6
La procédure a été testée avec la version 4.4 de CentOS, dont les images sont téléchargeables à l'adresse
http://www.centos.org.
Pour l'installation de cette distribution, voir le document NT-install_CentOS-CentOS.pdf qui se trouve dans
l'espace des préconisations du pôle technique : http://intranet.ird.fr/dsi/technique/politiques/
Note 1 : Les opérations présentées sont effectuées par l'utilisateur root.
I. Installation de l'environnement d'exécution Java 6
Aller à http://java.sun.com/javase/downloads/index.jsp et récupérer la dernière version du JRE de Java 6.
Une fois le fichier 'jdk-6u1-linux-i586.bin' téléchargé, lancer les commandes :
chmod 755 jre-6u1-linux-i586-rpm.bin
./jre-6u1-linux-i586-rpm.bin
Puis supprimer /var/lib/alternatives/java et tapant :
rm /var/lib/alternatives/java
Recréer alors le nouveau fichier 'alternatives' en tapant :
/usr/sbin/alternatives --install /usr/bin/java java /usr/lib/jvm/jre-1.4.2-gcj/bin/java 1
/usr/sbin/alternatives --install /usr/bin/java java /usr/java/latest/bin/java 2
Lancer maintenant :
/usr/sbin/alternatives --config java
Les lignes suivantes devraient alors s'afficher :
Selection Command
-----------------------------------------------
1 /usr/lib/jvm/jre-1.4.2-gcj/bin/java
*+ 2 /usr/java/jre1.6.0/bin/java
Enter to keep the current selection[+], or type selection number:
Type: <choose 1 or 2>
Entrer alors '2' pour fixer le deuxième chemin comme environnement java par défaut.
Créer ensuite un script qui permettra d'initialiser les variables d'environnement java à chaque démarrage. Pour
cela, lancer la commande :
vi /etc/profile.d/java.sh
et insérer dans ce nouveau fichier les lignes suivantes (à adapter en fonction de la version):
export JAVA_HOME="/usr/java/latest"
export JAVA_PATH="$JAVA_HOME"
export PATH="$PATH:$JAVA_HOME"

Date de modification : 19/04/07 - 14:38:13
Version : 1.0 Page : 3/5
Description : Installation d'un serveur Tomcat pour
héberger des applications J2EE
puis lancer la commande suivante :
source /etc/profile.d/java.sh
Afin de vérifier la bonne installation de la JRE de Java 6, taper :
which java
qui devrait afficher :
/usr/bin/java
et ensuite :
java -version
dont le résultat devrait ressembler à :
java version "1.6.0_01"
Java(TM) SE Runtime Environment (build 1.6.0_01-b06)
Java HotSpot(TM) Client VM (build 1.6.0_01-b06, mixed mode, sharing)
II. Installation de Tomcat 6
Aller à l'adresse http://tomcat.apache.org/ et récupérer la dernière version de Tomcat 6 (la 6.0.10 dans notre cas),
puis effectuer :
mv apache-tomcat-6.0.10.tar.gz /opt
cd /opt
tar xvzf apache-tomcat-6.0.10.tar.gz
rm apache-tomcat-6.0.10.tar.gz
ln -s apache-tomcat-6.0.10/ tomcat
Modifier le fichier /etc/profile.d/java.sh en tapant :
vi /etc/profile.d/java.sh
et y ajouter :
export CATALINA_HOME=/opt/tomcat
Créer le fichier /etc/init.d/tomcat en faisant un :
vi /etc/init.d/tomcat
et y ajouter :
#!/bin/sh
#
# tomcat Starts tomcat
# chkconfig: 2345 98 02
# description: tomcat is a J2EE web application container.
#
. /etc/init.d/functions
. /etc/profile.d/java.sh
export TOMCAT_HOME=/opt/tomcat
[ -f ${TOMCAT_HOME}/bin/startup.sh ] || exit 0

Date de modification : 19/04/07 - 14:38:13
Version : 1.0 Page : 4/5
Description : Installation d'un serveur Tomcat pour
héberger des applications J2EE
[ -f ${TOMCAT_HOME}/bin/shutdown.sh ] || exit 0
set -e
case "$1" in
start)
echo -n "Starting tomcat... "
$TOMCAT_HOME/bin/startup.sh >> /var/log/tomcat 2>&1
echo "started."
;;
stop)
echo -n "Stopping tomcat... "
$TOMCAT_HOME/bin/shutdown.sh >>/var/log/tomcat 2>&1
sleep 1
rm -f $TOMCAT_HOME/logs/*
echo "stopped."
;;
restart|force-reload)
echo -n "Restarting tomcat... "
$TOMCAT_HOME/bin/shutdown.sh >>/var/log/tomcat 2>&1
sleep 1
$TOMCAT_HOME/bin/startup.sh >>/var/log/tomcat 2>&1
echo "restarted."
;;
*)
N=/etc/init.d/tomcat
echo "Usage: $N {start|stop|restart}" >&2
exit 1
;;
esac
exit 0
Puis lancer les commandes suivantes, pour que le service s'exécute au démarrage du serveur:
chmod 755 /etc/init.d/tomcat
chkconfig --level 345 tomcat on
Pour finir, pour que le service soit exécuté sans avoir à redémarrer le serveur, taper les commandes suivantes :
source /etc/profile.d/java.sh
service tomcat start
puis utiliser elinks pour tester en local le bon fonctionnement du serveur Tomcat. Pour l'installer, taper :
yum install elinks
et enfin pour tester le serveur web en local, lancer :
elinks http://localhost:8080
Note : Si la page ne se charge pas, vérifier les logs de tomcat (/opt/tomcat/logs/catalina.out) pour déterminer la
cause du problème.
Le serveur est aussi accessible par défaut de l'extérieur. Il est possible de tester le serveur avec un navigateur
web à partir d'une autre machine. On obtient alors la page de démarrage de Tomcat :

Date de modification : 19/04/07 - 14:38:13
Version : 1.0 Page : 5/5
Description : Installation d'un serveur Tomcat pour
héberger des applications J2EE
Pour pouvoir avoir accès à la partie « Tomcat Manager », il reste encore à configurer les utilisateurs qui ont la
permission d'accéder à cette interface en modifiant le fichier /opt/tomcat/conf/tomcat-users.xml et en rajoutant
entre les deux balises <tomcat-users> une ligne de cette forme :
<tomcat-users>
...
...
<user username="admin" password="mon_mot_de_passe" roles="manager"/>
</tomcat-users>
et redémarrer le serveur Tomcat :
service tomcat restart
III. Suivi des modifications du document
Auteur de la modification Date Objet de la modification Version
Adrien Cheype 2006-04-19 Création du document V1.0
Figure 1: Page d'accueil de Tomcat 6