Copyright © 2001-2007 Nicholas Quaine.
Home   Bases   Côté-Serveur   Côté-Client   Démos   FAQ   Ressources
Côté-Serveur
1. Vue générale
2. Déployer Tomcat
3. Déployer SOAP
4. Déployer des Services
Packages
Les versions à utiliser
Sun Java
Tomcat
Apache SOAP
JavaMail
JAF
Xerces

Précédent   1    2    3    4    Suivant
SOAP Côté-Serveur
2. Déployer Tomcat

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
    


ETAPE DEUX Télécharger et installer Tomcat



  • 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.

ETAPE TROIS Démarrer Tomcat et vérifier qu'il fonctionne correctement



  • 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).

Maintenant, vous avez le serveur d'application Tomcat installé et en marche. La section suivante vous apprend comment déployer une application web Apache SOAP sur votre serveur Tomcat.

[ Nicholas Quaine ]

Suivant

Copyright © 2001-2007 Nicholas Quaine. Tout droit reservé.