Les étapes une à trois couvrent le déploiement du serveur d'application Tomcat. Ces instructions sont applicables aux systèmes d'exploitation Win32 et UNIX - Faites attention à suivre les instructions appropriées à votre système d'exploitation lors des étapes pour lesquelles des différences existent.

ETAPE UNE

Télécharger et installer Java

• Si vous avez déjà installé la version java 1.3.0 ou plus sur votre machine, vous pouvez alors sauter cette étape. Vous pouvez vérifier votre version java avec la commande suivante.

    > java -fullversion
  

  Le résultat de cette commande devrait ressembler à ce qui suit: (si vous voyez un numéro de version de 1.3.0 ou plus, alors tout va bien et vous pouvez passer au point suivant):

    java full version "1.3.1_01"
  

  Si vous avez une version antérieure à 1.3 ou si vous n'avez pas du tout installé java (c-à-d. que lorsque vous tapez la commande ci-dessus, "java" n'est pas reconnu comme commande), alors vous pouvez télécharger Java 1.3 gratuitement à partir du site de Sun Microsystems. Allez sur http://java.sun.com/j2se/1.3/, choisissez la section de téléchargement correspondant à votre système d'exploitation dans la partie intitulée "Download Java 2 SDK, v 1.3.x Software...", cliquez CONTINUE, lisez et ACCEPTez le contrat (si vous êtes d'accord avec la licence affichée). Choisissez ensuite le site approprié pour le téléchargement FTP. Sauvegardez le fichier sur votre machine. C'est un exécutable self-extractible. Lancez-le pour installer le package.

  Si vous avez une version antérieure à 1.3 et que pour une raison quelconque, vous ne voulez pas installer la 1.3 (bien qu'en général, deux versions de JavaSDK peuvent être installées en parallèle sans danger), vous êtes de libre de continuer de toute façon mais nous ne pouvons pas garantir que le tutorial fonctionnera avec votre environnement. Certaines versions antérieures vont en effet fonctionner mais il n'est pas dans notre intention de toutes les tester et de fournir une liste de compatibilité.

• Editez votre variable d'environnement "JAVA_HOME". Faites la pointer sur le répertoire racine de votre installation JDK (c-à-d. le répertoire parent du répertoire bin dans lequel se trouve votre java.exe). Gardez cette commande dans un fichier script (appelez-le comme vous voulez mais je m'y réfère comme étant mystartup.bat sur Win32 ou mystartup.sh sur UNIX). Nous y ajouterons d'autres choses plus tard pour éviter d'avoir toujours à retaper les mêmes commandes.

  Win32 Systèmes
  Si le nom complet du chemin de votre java.exe est C:\jdk1.3.1\bin\java.exe alors, le script ressemble pour le moment à:

  Win32 script : mystartup.bat

  set JAVA_HOME=C:\jdk1.3.1

  UNIX Systèmes
  Si le nom complet du chemin de votre binaire java est /usr/java alors, le script ressemble pour le moment à:

  UNIX script : mystartup.sh

  #!/bin/sh JAVA_HOME=/usr/java export JAVA_HOME

• Créez un répertoire SOAP sur votre machine. Nous allons utiliser C:\soap sur Win32 et /home/me/soap sur UNIX mais vous pouvez les appeler comme vous voulez et les mettre où vous voulez. Assurez vous seulement que vous remplacerez par vos noms de répertoire les C:\soap ou /home/me/soap partout là où vous les rencontrerez ci-dessous.

  Avertissement : Les espaces dans les noms de répertoires vous poseront problème plus tard, et vous devriez l'éviter dès le début.

• Allez sur http://jakarta.apache.org/tomcat/index.html et téléchargez Tomcat (choisissez Download/Binaries puis Release-Builds/Tomcat-3.2.x (où x est la dernière sous-version de 3.2) puis choisissez "jakarta-tomcat-3.2.x.zip" pour Win32 ou "jakarta-tomcat-3.2.x.tar.gz" pour UNIX et sauvegardez-le sur votre machine).

  Avertissement : Quand vous lisez 3.2.x dans le texte et les scripts qui suivent, ne le prenez pas littéralement - remplacez le x par le numéro de sous-version du package que vous avez téléchargé.

• Décompactez dans le répertoire soap. L'ensemble sera contenu dans un sous-répertoire nommé jakarta-tomcat-3.2.x. Assurez vous que dans jakarta-tomcat-3.2.x, il y a un répertoire lib et qu'il contient 6 fichiers jar - il s'agit des fichiers jar qui contiennent les classes propres à Tomcat plus toutes les bibliothèques nécessaires.

• Tout d'abord, notez que les instructions et la documentation complètes sur comment fonctionne Tomcat et ce qu'il fait sont disponibles sur http://jakarta.apache.org/tomcat/tomcat-3.2-doc/index.html.
• Nous allons utiliser le script de startup "startup.bat" (Win32) / "startup.sh" (UNIX) fourni par Apache pour démarrer le serveur Tomcat. Mais nous devons d'abord définir la variable d'environnement TOMCAT_HOME. Ajoutez les nouvelles lignes (en gras) à votre script de startup de telle façon qu'il ressemble à ce qui suit:

  Win32 script : mystartup.bat

  set JAVA_HOME=C:\jdk1.3.1 set TOMCAT_HOME=C:\soap\jakarta-tomcat-3.2.x %TOMCAT_HOME%\bin\startup.bat

  UNIX script : mystartup.sh

  #!/bin/sh JAVA_HOME=/usr/java export JAVA_HOME TOMCAT_HOME=/home/me/soap/jakarta-tomcat-3.2.x export TOMCAT_HOME $TOMCAT_HOME/bin/startup.bat

• Démarrez Tomcat en exécutant le script (Notez que, sur les systèmes UNIX, vous devez peut-être changer le mode "chmod 755" des scripts $TOMCAT_HOME/bin/startup.sh et $TOMCAT_HOME/bin/tomcat.sh avant de pouvoir de les exécuter). Vous devriez visualiser le résultat suivant (l'ordre des messages peut varier mais les lignes du PoolTcpConnector devraient toujours apparaître en dernier):

    2001-07-04 01:32:17 - ContextManager: Adding context Ctx( /examples )
    2001-07-04 01:32:17 - ContextManager: Adding context Ctx( /admin )
    Starting tomcat. Check logs/tomcat.log for error messages
    2001-07-04 01:32:22 - ContextManager: Adding context Ctx( /test )
    2001-07-04 01:32:25 - ContextManager: Adding context Ctx(  )
    2001-07-04 01:32:28 - PoolTcpConnector: Starting HttpConnectionHandler on 8080
    2001-07-04 01:32:28 - PoolTcpConnector: Starting Ajp12ConnectionHandler on 8007
  

• Maintenant, votre serveur Tomcat tourne et écoute les requêtes sur le port 8080. Vous pouvez le tester en faisant pointer un browser sur http://localhost:8080. Vous devriez voir la page d'accueil de Tomcat avec un chat marron et le numéro de version de Tomcat dans le coin supérieur gauche.
• Testez que les JSPs fonctionnent correctement en lançant un des exemples JSP (par exemple, vous choisissez JSP Examples, ensuite Numberguess/execute, et essayez de deviner le nombre qui a été sélectionné aléatoirement. Si ça ne fonctionne pas, ce sera évident - dans ce cas, vous avez raté une étape - retournez à l'étape une et recommencez).
• Testez que les servlets fonctionnent correctement en lançant un des exemples de servlet (par exemple, vous choisissez Servlet Examples, ensuite Hello World/execute - si vous voyez le message "Hello World!", tout fonctionne bien).