TOMCAT
De TwisterWiki
PRESENTATION
- Tomcat est un serveur d'application écrite en java comme Websphere ou Jboss
- Tomcat écoute par défaut sur les port 8080 et 8009
- Le port 8080 permet d’accéder au manager si il est installé et aux webapps
- Le port 8009 est utilisé pour communiqué avec apache et vi le mod_jk
INSTALLATION
- Il existe deux méthodes d'installation pour mettre en place tomcat
- En utilisant le paquets disponible sous Debian
- En téléchargeant sur apache.org le tgz
Installation en mode "tgz"
- C'est le mode d'installation que je préfère car tous les fichiers sont au même endroit et permet d'installer une version précise et faire cohabiter plusieurs tomcat
- Télécharger un jdk chez oracle (anciennement sun)
- Installer le jdk dans /usr/local
- Faire un lien symbolique de /usr/local/jdk1.7.0_02_x64 vers /usr/local/jdk
- Télécharger la version souhaitée de Tomcat (4, 5, 5.5, 6, 7) sur le site apache.org
- Décompresser l'archive dans /usr/local
- Faire un lien symbolique de /usr/local/apache-tomcat-7.0.30 vers /usr/local/tomcat
- Créer un un user tomcat
- Créer un script de démarrage basique
#! /bin/bash
#
### BEGIN INIT INFO
# Provides: tomcat
# Required-Start: $local_fs $remote_fs $network
# Required-Stop: $local_fs $remote_fs $network
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start/stop tomcat server
### END INIT INFO
NAME="Tomcat 7.0.30"
TOMCAT_HOME=/usr/local/tomcat
CATALINA_HOME=/usr/local/tomcat
JAVA_HOME=/usr/local/jdk
CATALINA_OPTS="-Xms2048m -Xmx2048m -XX:MaxPermSize=128m -Djava.awt.headless=true"
TOMCAT_USER=tomcat
export TOMCAT_HOME CATALINA_HOME JAVA_HOME CATALINA_OPTS TOMCAT_USER
cd $TOMCAT_HOME/logs
case "$1" in
start)
echo -ne "Starting $NAME.\n"
/bin/su $TOMCAT_USER $TOMCAT_HOME/bin/startup.sh
;;
stop)
echo -ne "Stopping $NAME.\n"
/bin/su $TOMCAT_USER $TOMCAT_HOME/bin/shutdown.sh
;;
restart)
echo -ne "Stopping $NAME.\n"
/bin/su $TOMCAT_USER $TOMCAT_HOME/bin/shutdown.sh
sleep 10
echo -ne "\n"
echo -ne "\n"
echo -ne "Starting $NAME.\n"
/bin/su $TOMCAT_USER $TOMCAT_HOME/bin/startup.sh
;;
*)
echo "Usage: /etc/init.d/tomcat {start|stop|restart}"
exit 1
;;
esac
exit 0
Les dossiers principaux
------------------------------------------------------------------------ | Nom du dossier | Description | |----------------|-------------------------------------------------------| | bin | Contient les scripts de démarrage | |----------------|-------------------------------------------------------| | conf | Contient les fichiers de configuration | |----------------|-------------------------------------------------------| | lib | Contient les librairies chargées par tomcat | |----------------|-------------------------------------------------------| | logs | Contient les fichiers de log de tomcat | |----------------|-------------------------------------------------------| | webapps | Contient les webapps (sites web) | |----------------|-------------------------------------------------------| | work | Contient les fichiers de travail de tomcat. | | | ce dossier peut être vider avant de redémarrer Tomcat | | | en cas de soucis apres une mise à jour de webapps | ------------------------------------------------------------------------
les fichiers de configuration
- Les fichiers de configuration sont dans /usr/local/tomcat/conf/
------------------------------------------------------------------------- | Nom du fichier | Description | |---------------------|---------------------------------------------------| | catalina.properties | Contient les paths pour des librairies jar | |---------------------|---------------------------------------------------| | context.xml | | |---------------------|---------------------------------------------------| | logging.properties | définit le format des logs de Tomcat | |---------------------|---------------------------------------------------| | server.xml | fichier de configuration principal de Tomcat | |---------------------|---------------------------------------------------| | tomcat-users.xml | permettant de définir les accès au manager | |---------------------|---------------------------------------------------| | web.xml | fichier de configuration (contient les types mime)| -------------------------------------------------------------------------
Le manager
- Le manager permet de réaliser quelque taches de maintenance
- Arrêter une webapps ou context
- Recharger un context
- Supprimer un context
- Mettre à jour un context
- Voir le nombre de sessions par context
- Déployer un nouveau context
Automatisation des taches
- Grace à l’outil Ant, il est possible de réaliser des scripts pour réaliser des taches d'administration
- Ant est un outils qui exécute des commandes lues dans un fichier au format xml (build.xml)
- Il est possible de lister les context d'un serveur, arrêter, démarrer, recharger, déployer un context avec cet outil
- Ant à besoin de se connecter au manager de tomcat afin de réaliser toutes ces taches.
démarrer un context
<target name="start" description="Start Tomcat context" depends="showInfos,input-context-name">
<start url="${tomcat.manager.url}"
username="${tomcat.manager.username}"
password="${tomcat.manager.password}"
path="/${context.name}"/>
</target>
stopper un context
<target name="stop" description="Stop Tomcat context" depends="showInfos,input-context-name">
<stop url="${tomcat.manager.url}"
username="${tomcat.manager.username}"
password="${tomcat.manager.password}"
path="/${context.name}"/>
</target>
lister les context
<target name="list" description="List Tomcat context" depends="showInfos">
<list url="${tomcat.manager.url}"
username="${tomcat.manager.username}"
password="${tomcat.manager.password}"/>
</target>
ERREUR AU LANCEMENT DE TOMCAT
- La Jvm n'est pas en mesure d'allouer la mémoire définie par les variable Xms et Xmx
Error occurred during initialization of VM Could not reserve enough space for object heap
