Installation manuelle de Tomcat sur Ubuntu

Introduction

Apache Tomcat est une implémentation des servlets et JavaServer Pages (JSP) qui suit les spécifications du Java Community Process (JCP).

Tomcat est un projet libre soutenu par la fondation Apache et diffusé sous licence Apache Software Licence (ASL). Il apporte au développeur un conteneur de servlets et un serveur HTTP permettant de déployer ses applications JEE.

Logo Apache Tomcat

Il existe bon nombre de tutoriels quant à son installation (manuelle ou via le gestionnaire de paquets) et sa configuration, la procédure qui suit est un mémo personnel pour une installation sous Ubuntu (ici Intrepid Ibex).

Installer la JVM de Sun (jdk 6)

Installer la machine virtuelle java de Sun (version 6) à partir des dépôts et la sélectionner.

$ sudo apt-get install sun-java6-jdk
$ sudo update-alternatives --config java

Installer / configurer Tomcat 6

Installer Tomcat
Récupérer la dernière version stable de Tomcat, extraire l’archive et placer son contenu dans /usr/local/tomcat :

$ cd ~/Bureau
~/Bureau$ wget http://mirror.mkhelif.fr/apache/tomcat/tomcat-6/v6.0.18/bin/apache-tomcat-6.0.18.tar.gz
~/Bureau$ tar xvzf apache-tomcat-6.0.18.tar.gz
~/Bureau$ sudo mv apache-tomcat-6.0.18 /usr/local/tomcat

Ajouter la variable JAVA_HOME au .bashrc
Vérifier l’emplacement de la JVM et éditer le fichier .bashrc :

~/Bureau$ ls /usr/lib/jvm/
java-1.5.0-sun  java-1.5.0-sun-1.5.0.16  java-6-sun  java-6-sun-1.6.0.10
~/Bureau$ gedit ~/.bashrc

Ajouter la ligne suivante en fin de fichier :

export JAVA_HOME=/usr/lib/jvm/java-6-sun

Ajouter un utilisateur admin
Editer le fichier tomcat-user.xml :

~/Bureau$ gedit /usr/local/tomcat/conf/tomcat-users.xml

Ajouter le contenu suivant :

<tomcat-users>
    <role rolename="manager"/>
    <role rolename="admin"/>
    <user username="admin" password="mon mdp" roles="manager,admin"/>
</tomcat-users>

Changer le port par défaut (optionnel)
Editer le fichier server.xml :

~/Bureau$ gedit usr/local/tomcat/conf/server.xml

Changer la ligne suivante pour modifier le port utilisé :

<Connector port="8080" ...> => <Connector port="8181" ...>

Allouer plus de mémoire vive (optionnel)
Editer le fichier catalina.sh :

~/Bureau$ gedit /usr/local/tomcat/catalina.sh

Ajouter la ligne suivante ( -Xms taille initial du tas, -Xmx taille maximale du tas) :

JAVA_OPTS="$JAVA_OPTS "-Xmx1024m" "-Xms512m
# ----- Execute The Requested Command -----------------------------------------

Tester Tomcat

Démarrer Tomcat :

~/Bureau$ cd /usr/local/tomcat/bin
/usr/local/tomcat/bin$ ./startup.sh 
Using CATALINA_BASE:   /usr/local/tomcat
Using CATALINA_HOME:   /usr/local/tomcat
Using CATALINA_TMPDIR: /usr/local/tomcat/temp
Using JRE_HOME:       /usr/lib/jvm/java-6-sun

Tomcat est désormais accessible à l’adresse http://localhost:8181/, l’installation propose des examples de servlets et jsp, vous pouvez également déployer vos applications via le manager.

Arrêter Tomcat :

/usr/local/tomcat/bin$ ./shutdown.sh

Pour aller plus loin, vous trouverez plus d’informations sur la documentation officielle.