note technique ---------- j2ee
publicité
19/04/07 - 14:38:13
Date de modification :
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 :
Version : 1.0
19/04/07 - 14:38:13
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 :
Version : 1.0
19/04/07 - 14:38:13
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 :
Version : 1.0
19/04/07 - 14:38:13
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
Figure 1: Page d'accueil de Tomcat 6
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
Adrien Cheype
Date
Objet de la modification
Version
2006-04-19
Création du document
V1.0
