Tomcat

Notice :

Si vous ne parvenez pas à trouver Tomcat, consulter la page Localiser Tomcat.

Allocation Mémoire (RAM) avec JAVA_OPTS

On utilise la variable d'environnement JAVA_OPTS<ref>The JAVA_OPTS environment variable @ ibm.com</ref> pour définir l'allocation mémoire du processus Tomcat. On placera généralement cette variable dans Apache Tomcat/bin/startup.sh. Elle peut cependant avoir été défini dans :

• Apache Tomcat/bin/catalina.sh
• $HOME/.bashrc

On définira la l'option comme suit :

JAVA_OPTS="-Dfile.encoding=UTF-8 -Xmx2500m -XX:MaxPermSize=128m -XX:NewSize=300m -Djava.awt.headless=true -server"

C'est la valeur -Xmx2500m qui défini l'allocation, ici on alloue 2.5Go. On adaptera l'allocation en fonction du serveur et en fonction des besoins de publication.

Forcer la locale

Pour forcer la locale du Tomcat, on va rajouter les options -Duser.language=fr et -Duser.region=FR" dans la variable JAVA_OPTS du fichier Apache Tomcat/bin/catalina.sh.

JAVA_OPTS="-Dfile.encoding=UTF-8 -Xmx4000m -XX:MaxPermSize=256m -XX:NewSize=300m -Djava.awt.headless=true -server -Duser.language=fr -Duser.region=FR"

Arrêt et redémarrage automatique

Nous utiliserons un script init dans le cas d'une installation à partir des sources de Apache Tomcat.<ref>Writing Startup Script for tomcat 6 </ref>

Remarques : Il est inutile de suivre cette procédure lors d'une installation via le gestionnaire de paquet de votre OS.

Création du script

Important :

Si vous avez plusieurs instance tomcat il faudra un script d'initialisation pour chaque instance.

Notice :

Penser à adapter le chemin vers le dossier de votre Tomcat (cf. $CATALINA_HOME) et le chemin vers la JVM ($JAVA_HOME).

Il faut placer le contenu du script ci-dessous dans /etc/init.d/tomcat-front|back.sh

#!/bin/sh
###BEGIN INIT INFO
# Provides:          tomcat
# Required-Start:    $local_fs $remote_fs $network
# Required-Stop:     $local_fs $remote_fs $network
# Should-Start:      $named
# Should-Stop:       $named
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Start Tomcat.
# Description:       Start the Tomcat servlet engine.
### END INIT INFO
# Tomcat 6 init-script

# ATTENTION ! Si vous avez plusieurs instance tomcat il faudra plusieurs script d'initialisation
CATALINA_HOME=/opt/tomcat6-front
JAVA_HOME=/usr/lib/jvm/java-6-sun
#JAVA_HOME=/usr/lib/jvm/java-6-sun-1.6.0.13

export CATALINA_HOME
export JAVA_HOME
PATH=$JAVA_HOME/bin:$PATH
export PATH
case $1 in
     start)
          sh "$CATALINA_HOME"/bin/startup.sh
          echo "tomcat6 started successfully"
          ;;
     stop)
          sh "$CATALINA_HOME"/bin/shutdown.sh
          echo "tomcat6 stoped successfully"
          ;;
     restart)
          sh "$CATALINA_HOME"/bin/shutdown.sh
          sh "$CATALINA_HOME"/bin/startup.sh
          echo "tomcat6 restarted successfully"
          ;;
       *)
          sh "$CATALINA_HOME"/bin/startup.sh
          echo "tomcat6 started successfully"
   ;;

     esac
exit 0

Ajout du script init au système

Il faut d'abord rendre le script /etct/init.d/tomcat-front|back.sh executable par le système puis on l'ajoute aux scripts démarrer par défaut :

chmod u=rwx,g=rx,o=x tomcat6*
update-rc.d tomcat6-front.sh defaults

On fait un petit test pour vérfier qu'il n'y a pas d'erreur :

/etc/init.d/tomcat6-front.sh restart

Tâche cron journalière de redémarrage

Important :

La description ci-dessous considère que vous utiliser l'Arborescence de production et les scripts shell préconisé pour les installations..

On s'appuie sur la function flushAndRestart défini dans ~/.bashrc ou ~/.ajlsmrc

@daily  flushAndRestart front
#@daily flushAndRestart back

Encodage des paramètres envoyés avec la méthode GET

La configuration de Apache Tomcat<ref>Configuration de Apache Tomcat</ref> peut également jouer un rôle dans ce genre de problème. Voici la configuration recommandée (dans ./conf/server.xml) pour les connecteur HTTP et AJP :

<Connector port="8080" protocol="HTTP/1.1"
  URIEncoding="UTF-8"
  ⋮
/>
⋮
<Connector port="8009" protocol="AJP/1.3"
  URIEncoding="UTF-8"
  ⋮
/>

Tomcat7

Gestion des sessions

Important :

La gestion des sessions à changer dans Tomcat7<ref>Tomcat 7 session cookie path @ StackOverflow</ref>.

L'attribut que emptySessionPath="true" que l'on placer dans les connecteurs du fichier <tomcat6>/conf/server.xml ne sert plus. Il faut maintenant éditer le fichier <tomcat7>/conf/context.xml et ajouter l'attribut sessionCookiePath="/", puis redémarrer le serveur Tomcat.<ref>Session cookie configuration @ Tomcat doc</ref>

Arrêter Tomcat 6.0 à partir du PID

Arrêter Tomcat :

$TOMCAT_HOME/bin/catalina.sh stop

Définir la variable d'environnement CATALINA_BASE dans ~/.profile :

CATALINA_BASE=/usr/local/apache-tomcat-6.0.36

Créer le fichier $TOMCAT_HOME/bin/setenv.sh :

CATALINA_PID="$CATALINA_BASE/bin/catalina.pid"

Redémarrer Tomcat :

$TOMCAT_HOME/bin/catalina.sh start

Pour arrêter Tomcat :

cat $TOMCAT_HOME/bin/catalina.pid | xargs kill -9

Erreurs communes

$ catalina.sh stop
Using CATALINA_BASE:   /usr/local/apache-tomcat-6.0.36
Using CATALINA_HOME:   /usr/local/apache-tomcat-6.0.36
Using CATALINA_TMPDIR: /usr/local/apache-tomcat-6.0.36/temp
Using JRE_HOME:        /usr/local/jdk1.6.0_39
Using CLASSPATH:       /usr/local/apache-tomcat-6.0.36/bin/bootstrap.jar
Using CATALINA_PID:    /usr/local/apache-tomcat-6.0.36/bin/catalina.pid
15 mars 2013 11:22:47 org.apache.catalina.startup.Catalina stopServer
GRAVE: Catalina.stop: 
java.net.ConnectException: Connection refused
	at java.net.PlainSocketImpl.socketConnect(Native Method)

Arrêter Tomcat :

cat $TOMCAT_HOME/bin/catalina.pid | xargs kill -9

Supprimer le fichier catalina.pid :

rm -f $TOMCAT_HOME/bin/catalina.pid

Démarrer Tomcat :

$TOMCAT_HOME/bin/catalina.sh start

References

1. FAQ / Memory @ Tomcat wiki

<references/>