Project:Omega.org

Tomcat est un serveur de haute qualité qui repose sur Java. La dernière version, Tomcat 4.1, comprend les spécifications de Servlet 2.3 de Sun Microsystems et de Java ServerPages 1.2. Le code du Tomcat originel a été donné par Sun au projet Apache et a été depuis complètement reécrit.

Si vous développez des applications Web, ou des services Web, il y a de fortes chances que vous considériez bientôt l’utilisation d’un serveur Tomcat 4.x. Heureusement, ce processus est assez aisé si Mac OS X est votre plate-forme de choix.

Cet article vous guide au travers de l’installation de la version que j’emploie pour développer et démontrer des applications Web et des services Web sur mon PowerBook G4. J’ai installé Tomcat de manière à ce qu’il soit lancé dès le démarrage et sans avoir à se connecter. Cette installation, avec quelques transferts de port, signifie que je peux supporter des démonstrations client en temps réel à partir de mon ordinateur portable, en étant chez moi, pour des clients situés dans d’autres pays.

Il y a quelques fonctions de Tomcat qui proviennent d’un certain nombre de sources, donc vous pouvez vous retrouver avec une installation différente. Je développe des services Web aussi bien que des applications Web traditionnelles, j’ai donc installé le Tomcat qui accompagne le package Java WebServices.

Le Tomcat fourni avec le package Java WebServices est une simple installation qui m’apporte toutes les fonctionnalités dont j’ai besoin, y compris un ensemble de tâches Ant spéciales qui se servent de l’application Tomcat Manager pour effectuer des installations provisoires et enlèver le fichier .war sans avoir à redémarrer. Bien que ce soit une première, cette version est assez stable pour le développement et inclut les choses suivantes :

• Le package Java XML, qui inclut :
  • API Java pour Messagerie XML (JAXM) 1.1
  • API Java pour XML Processing (JAXP) 1.2 (avec support de Schéma XML)
  • API Java pour XML Registries (JAXR) 1.0_01
  • API Java pour RPC basé sur XML (JAX-RPC) 1.0
  • SOAP with Attachments API for Java (SAAJ) v1.1
• JavaServer PagesTM Standard Tag Library (JSTL) 1.0
• Ant Build Tool 1.4.1
• Java WSDP Registry Server 1.0_01
• Web Application Deployment Tool
• Apache Tomcat 4.1.2 Container

Allez sur http://java.sun.com/webservices/downloads/webservicespack.html. Choisissez alors installation UNIX et accepter les termes.

Il y a quelque chose de bizarre dans le format de fichiers que Sun propose aux utilisateurs de Macintosh, le fichier que vous téléchargerez s’appellera probablement Document5. Ainsi, après avoir renommé le fichier téléchargé en jwsdp-1_0-unix.sh, ou ce que vous voulez finissant par .sh. (NDT : Il se peut aussi que le mode FTP provoque l’affichage du fichier dans le navigateur au lieu de le télécharger sur le disque, choisissez alors le mode HTTP en bas de la page du site de SUN).

Maintenant il est temps de régler votre Mac

D’abord, créer quelques nouveaux dossiers dans votre dossier /Library. Certaines personnes préfèrent installer des choses dans leur dossier local ~/Library, mais comme nous voulons que notre Tomcat démarre avant que nous nous connections, le dossier /library est mieux approprié.

S’il n’y en a pas déjà un, faites un dossier appelé /StartupItems et, à ses côtés, créez en un autre appelé /Tomcat. Enfin, copiez alors jwsdp-1_0-unix.sh dans /Library/Tomcat.

Vous pouvez faire cela dans le Finder. Les dossiers que vous créez resteront votre propriété et c’est mieux ainsi. Vous pourrez changer les permissions des ces dossiers plus tard, mais pour le moment laisser les comme elles sont. Certaines personnes aiment créer un utilisateur spécial pour Tomcat, mais c’est superflu.

Utiliser le Terminal et tapez cd /Library/Tomcat puis :

chmod 777 jwsdp-1_0-unix.sh

Pour que vous puissiez lancer l’installateur :

./jwsdp-1_0-unix.sh

Quelques clics sur “approve” et “next”. Il vous demandera ensuite si java1.3.1 installé par défaut est OK. Il devrait l’être. Si vous rencontrez des problèmes ici alors cela veut dire que Java 1.3.1 est probablement bancale. Tout les systèmes Mac OS X embarquent Java 1.3 ou mieux.

Tapez java - version pour voir quelle version de Java est en place.

Ensuite l’installateur vous demandera un nom d’utilisateur et un mot de passe. Ce sera le nom d’utilisateur et le mot de passe que Tomcat vous demandera quand vous l’administrerez en utilisant les outils de gestion inclus. Ne l’oubliez pas !

L’installateur vous demandera où vous voullez installer Tomcat. Choisissez /Library/Tomcat/jwsdp-1_0 et cliquez sur le bouton “next”. L’installation va alors commencer. Cela prend un moment, donc allez prendre une tasse de thè et, pendant que vous attendez la fin de l’installation, faites ceci :
Dans /Library/StartupItems, créer un dossier appelé Tomcat.

Vous allez créer deux fichiers dans ce dossier, le premier est un script shell exécutable appelé Tomcat et, le second, est une liste de propriété appelée StartupParameters.plist. Les deux sont de simples fichiers texte.

• Script shell Tomcat :

  	#!/bin/sh
  
  	##
  	# Start Tomcat
  	##
  
  	. /etc/rc.common
  
  	ConsoleMessage "Starting the Java WebServices framework"
  
  	export JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Home
  	export CATALINA_HOME="/Library/Tomcat/Home"
  	export TOMCAT_HOME="/Library/Tomcat/Home"
  	export JWSDP_HOME="/Library/Tomcat/Home"
  
  	sh ${TOMCAT_HOME}/bin/startup.sh

• StartupParameters.plist:

  	<?xml version="1.0" encoding="UTF-8"?> 	<!DOCTYPE plist SYSTEM        "file://localhost/System/Library/DTDs/PropertyList.dtd"> 	<plist version="0.9"> 	<dict> 		<key>Description</key> 		<string>Tomcat Servlet and JSP Server</string> 		<key>Messages</key> 		<dict> 			<key>start</key> 			<string>Starting Tomcat Server</string> 			<key>stop</key> 			<string>Stopping Tomcat Server</string> 		</dict> 		<key>OrderPreference</key> 		<string>None</string> 		<key>Provides</key> 		<array> 			<string>Tomcat</string> 		</array> 		<key>Requires</key> 		<array> 			<string>Resolver</string> 		</array> 	</dict> 	</plist>

Vous pouvez soit utiliser un éditeur de texte pour créer le fichier .plist, soit vous servir de l’éditeur Apple de PropertyList.

Assurez vous que le script que vous venez de créer est exécutable : chmod 777 Tomcat

Quand l’installateur Tomcat a terminé ses tâches vous devriez voir le dossier jwsdp-1_0 dans votre dossier /Library/Tomcat.

Faites un lien vers ce dossier à partir d’un alias appelé “Home” :

ln -s jwsdp-1_0 Home

Votre TOMCAT_HOME va maintenant toujours être /Library/Tomcat/Home.

Si vous désirez installer d’autres versions de Tomcat, mettez les dans /Library/Tomcat et recréez le lien vers Home. De cette manière vous n’aurez aucun autre paramètre à changer.

Bien, lancez le maintenant.

cd /Library/StartupItems/Tomcat et tapez : ./Tomcat pour lancer le script Tomcat.

Vous devriez voir les choses suivantes au moment où le script de démarrage de Tomcat se lance.

Using CATALINA_BASE: /Library/Tomcat/Home
Using CATALINA_HOME: /Library/Tomcat/Home
Using CATALINA_TMPDIR: /Library/Tomcat/Home
Using JAVA_HOME: /System/Library/Frameworks/JavaVM/Versions/1.3.1/Home

Maintenant, essayez d’atteindre http://localhost:8080 en vous servant de votre browser.

Vous devriez voir l’écran Web Services Developer Pack 1.0. Ça y est. Vous avez installé le Pack Web Services Developer. En guise de test final, redémarrez votre Mac. Si tout fonctionne correctement, vous devriez voir apparaître “Starting Tomcat Server” dans votre fenêtre de démarrage. Laissez le Mac tel quel sans vous connecter.

Maintenant, en vous servant d’un browser sur un autre Mac (Vous avez bien un autre Mac, n’est ce pas ?) vous devriez pouvoir atteindre http://10.0.1.xx:8080 et ouvrir la page des Web services.

Bravo, vous avez maintenant un serveur Tomcat installé qui se lance à chaque démarrage et sans nécessiter d’identification utilisateur.

Amusez-vous avec les exemples, puis, quand vous sentirez que vous le maîtrisez, vous pourrez alors commencer à écrire vos propres Web services, servlets, et pages JSP.

Textes originaux en anglais sur O’Reilly : Installing Tomcat on Mac OS X par Dave Sag

Thierry Serveurs Web apache, Java, Mac OS X, réseau, serveur web, tomcat