Installation de Tomcat 7.0 sur MacOSX

Cette procédure explique comment installer Apache Tomcat 7.0.x sur Mac OS X.

Téléchargement et copie des fichiers

Comme Java vient installé avec MacOSX, installer Tomcat reste assez simple (quoique un peu plus compliqué que sous Windows). Il faut télécharger le paquetage de Tomcat sur le site officiel dans Binary Distributions → Core. Au moment d'écrire cet aide, il s'agissait de la version 7.0.25 et le fichier se nomme apache-tomcat-7.0.25.tar.gz. Bien sûr, cela peut changer.

Installation

Une fois téléchargé, il faut décompresser les fichier à un bon endroit, tout comme dans /usr/local. Pour copier les fichier à cet endroit, il faut avoir les privilèges administrateurs avec la commande sudo.

mbp:~ stephane$ sudo sh
Password:
sh-3.2# mv apache-tomcat-7.0.25.tar.gz /usr/local/
sh-3.2# cd /usr/local/
sh-3.2# gnutar -xzvf apache-tomcat-7.0.25.tar.gz

Optionnellement, en étant dans /usr/local, on peut créer un lien symbolique vers Tomcat, de cette façon, on pourra faire référence à tomcat au lieu de apache-tomcat-7.0.25.

sh-3.2# ln -s apache-tomcat-7.0.25 tomcat

Tomcat est maintenant installé dans le répertoire /usr/local/apache-tomcat-7.0.25/. Il reste tout de même quelques changements à faire. Il est préférable de changer le propriétaires des fichiers. Changer owner par l'information appropriée.

sh-3.2# chown -R owner /usr/local/apache-tomcat-7.0.25

Changer la partie owner par votre nom d'usager.

Démarrer et arrêter Tomcat

Dans un répertoire quelconque (ex : ~/bin), créer deux fichiers. Un pour démarrer, nommé start_tomcat et l'autre stop_tomcat. Les deux fichiers sont quasi identiques, c'est seulement la quatrième ligne qui change.

#!/bin/sh
export CATALINA_HOME=/usr/local/tomcat
export JAVA_HOME=/usr
$CATALINA_HOME/bin/startup.sh

#!/bin/sh
export CATALINA_HOME=/usr/local/tomcat
export JAVA_HOME=/usr
$CATALINA_HOME/bin/shutdown.sh

Changer le mode des fichiers pour les rendre exécutables :

chmod ug+x start_tomcat stop_tomcat

S'il faut prévoir un utilisateur qui agira en tant que gestionnaire, il faut l'ajouter dans le fichier /usr/local/tomcat/conf/tomcat-users.xml. Dans cet exemple, un utilisateur user avec le mot de passe password et le rôle manager-gui a été ajouté.

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="manager-gui"/>
  <user username="user" password="password" roles="manager-gui"/>
</tomcat-users>

Et finalement, démarrer le service de Tomcat. Il faudra exécuter stop_tomcat pour arrêter.

~/bin/start_tomcat

Vérification

Pour vérifier que tout est fonctionnel, il faut aller à la page http://localhost:8080/. Si la page par défaut de Tomcat apparaît, l'installation a réussi.