Auteur    :    Stéphane TRAUMAT ( Ashita-studio )
Je veux �tre tenu au
courant des mises à jour
de ce tutorial
Date de dernière mise à jour    :    29/11/2002
Index du tutorial    :    http://www.ashita-studio.com/tutoriaux/ejb/index.php
Adresse du document    :    http://www.ashita-studio.com/tutoriaux/ejb/chapitre_02.php


Chapitre 02 : Installation & paramétrage


  1. Introduction

    Nous allons maintenant voir comment installer et paramétrer votre environnement de travail sous Windows. Ce chapitre va présenter un "modèle" d'installation, vous n'êtes pas obligé de le suivre mais cela est conseillé, ainsi, vous pourrez vous concentrer sur la programmation et ne pas perdre trop de temps sur le paramétrage.


  2. Téléchargez

    Les logiciels suivants sont obligatoires pour le fonctionnement des exemples de ce tutorial :



  3. Installez

    1. Création de l'arborescence

      Nous allons créer une arborescence de répertoire pour y mettre tous les logiciels et les sources dont nous avons besoin.

      • A la racine de votre disque dur C, créez le répertoire "java"
      • Dans le répertoire "java", créez un répertoire "dev" ( Ici, nous mettrons nos sources )
      • Dans le répertoire "dev", créez un répertoire "build" ( Ici, nous trouverons les résultats de nos compilations )
      • Dans le répertoire "build", créez un répertoire "META-INF" ( Ici, nous mettrons nos descripteurs de déploiement )
      • Dans le répertoire "java", créez un répertoire "plateforme" ( Ici, nous mettrons tous les logiciels )
      • Dans le répertoire "plateforme", créez un répertoire "j2sdk"
      • Dans le répertoire "plateforme", créez un répertoire "j2eesdk"
      • Dans le répertoire "plateforme", créez un répertoire "ant"
      • Dans le répertoire "plateforme", créez un répertoire "tomcat"
      • Dans le répertoire "plateforme", créez un répertoire "jonas"

    2. Installation du SDK J2SE - Kit de développement Java 2

      Lancez l'installation du SDK Java 2 avec comme répertoire d'installation "C:\java\plateforme\j2sdk".

    3. Installation du SDK J2EE - Kit de développement J2EE

      Lancez l'installation du SDK J2EE avec comme répertoire d'installation "C:\java\plateforme\j2eesdk".

    4. Installation de ANT - Ant est un système de gestion de build comparable à Make

      Décompressez l'archive de ant et placer les 4 répertoires résultants (bin, doc, etc et lib) dans le répertoire "C:\java\plateforme\ant".

    5. Installation de Tomcat - Conteneur de servlet

      Lancez l'installation de Tomcat avec comme répertoire d'installation "C:\java\plateforme\tomcat".

    6. Installation de JOnAS - Serveur d'application

      Décompressez l'archive de JOnAS. Vous allez y trouver un répertoire "JONAS" avec dedans des répertoires tel que "apps", "bin", "config"... Copiez tous ces répertoires dans "C:\java\plateforme\jonas".

    7. Installation de MySQL - SGBD Open Source

      Vous pouvez installer MySQL où vous le voulez car, de toute façon, nous y accéderons par TCP/IP.

    8. MySQL Connector/J - driver JDBC de MySQL

      MySQL Connector/J est le driver JDBC de MySQL ( c'est lui qui sera chargé de convertir les appels JDBC en ordre compréhensible par MySQL ). Pour l'installer, décompressez l'archive, récupérer le fichier mysql-connector-java-3.0.1-beta-bin.jar ( Attention, le nom du fichier dépendra de la version que vous avez téléchargé ) et placez le dans le répertoire "C:\java\plateforme\j2sdk\jre\lib\ext".



  4. Configurez

    1. Modification de la variable PATH de Windows

      La variable PATH contient la liste des répertoires dont les fichiers peuvent être accessibles à partir d'un autre répertoire. Nous allons la modifier pour ajouter :
      - C:\java\plateforme\j2sdk\bin : Les exécutables du SDK Java2 ( java, javac... ).
      - C:\java\plateforme\j2eesdk\bin : Les exécutables du SDK J2EE ( deploytool... ).
      - C:\java\plateforme\jonas\bin\nt : Les exécutables du serveur d'applications ( jonas... ).
      - C:\java\plateforme\ant\bin : Les exécutables de ant ( ant... ) .

      Pour cela, faites "propriété" sur le poste de travail, cliquez sur l'onglet "Avancé", puis sur "Variables d'environnement". Dans la liste des variables système, modifier la variable "path" pour y ajouter : ";C:\java\plateforme\j2sdk\bin;C:\java\plateforme\j2eesdk\bin;C:\java\plateforme\jonas\bin\nt;C:\java\plateforme\ant\bin"

    2. Modification des variables d'environnement

      Nous allons devoir faire un fichier .bat qui va mettre en place un certain nombre de variables :
      - JAVA_HOME : Répertoire d'installation du SDK Java 2.
      - J2EE_HOME : Répertoire d'installation du SDK J2EE.
      - JONAS_ROOT : Répertoire d'installation du serveur JOnAS.
      - ANT_HOME : Répertoire d'installation de Ant.
      - CATALINA_HOME : Répertoire d'installation de Tomcat.
      - CATALINA_BASE : Répertoire d'installation de Tomcat.

      Nous allons créer un fichier "configuration.bat" que nous placerons dans le répertoire "c:\java" et dont voici le code :

      configuration.bat

      @echo off
      set JAVA_HOME=C:\java\plateforme\j2sdk
      set J2EE_HOME=C:\java\plateforme\j2eesdk
      set JONAS_ROOT=C:\java\plateforme\jonas
      set ANT_HOME=C:\java\plateforme\ant
      set CATALINA_HOME=C:\java\plateforme\tomcat
      set CATALINA_BASE=C:\java\plateforme\tomcat

      Attention : Il faudra lancer ce fichier à chaque démarrage de session MS-DOS où vous voulez utiliser les programmes que nous venons d'installer.

    3. Configuration de JOnAS

      Nous allons maintenant configurer le serveur d'application JOnAS.

      Dans le fichier "C:\Java\plateforme\jonas\config\jonas.properties" :

      • Vérifiez que la variable jonas.service.tomcat.class est bien égale à org.objectweb.jonas.tomcat.EmbeddedTomcatImpl40.

      • La variable jonas.services doit avoir la valeur registry,jmx,security,jtm,mail,dbm,ejb,web,ear pour que l'on ai un serveur compatible J2EE.

      Dans le fichier "C:\java\plateforme\jonas\bin\nt\config_env.bat" :

      • Remplacer la ligne Set MYSQL_CLASSES=c:\mysql\mm.mysql-2.0.14\mm.mysql-2.0.14-bin.jar par Set MYSQL_CLASSES=C:\java\plateforme\j2sdk\jre\lib\ext\mysql-connector-java-3.0.1-beta-bin.jar ( Attention, le nom du fichier dépendra de la version que vous avez téléchargé ).




  5. Testez

    • Lancez L'invite de commandes MSDOS

    • Allez dans le répertoire "c:\java"

    • Tapez "configuration" ( ce qui lancera notre fichier "configuration.bat" )

    • Tapez "java -version"

    • Tapez "javac -help"

    • Tapez "ant -version"

    • Tapez "j2ee -version"

    • Tapez "jonas start", vous devriez obtenir un résultat ressemblant à ceci :

      Résultat de "jonas start"

      main : RegistryManager.start : Registry started on port '1099'
      main : ServiceManager.startRegistry : registry service started
      main : ServiceManager.startServices : jmx service started
      main : ServiceManager.startServices : security service started
      main : ServiceManager.startServices : jtm service started
      main : ServiceManager.startServices : mail service started
      main : ServiceManager.startServices : dbm service started
      main : ServiceManager.startServices : ejb service started
      Apache Tomcat/4.0.6
      Apache Tomcat/4.0.6
      War /C:/Java/plateforme/jonas/webapps/jadmin.war available at jadmin
      main : ServiceManager.startServices : web service started
      main : ServiceManager.startServices : ear service started
      The JOnAS Server 'jonas' version 2.6 is ready and running on rmi

    • Appuyez sur "entrée" puis tapez "jonas stop" pour arrêter JOnAS.



  6. Conclusion

    Désormais, nous avons un serveur d'application compatible J2EE qui fonctionne sur notre machine. Vous pouvez d'ores et déjà explorez les exemples fournis avec jonas que vous trouverez dans le répertoire "C:\java\plateforme\jonas\examples".



Auteur : Stéphane TRAUMAT
Société SCUB et Ashita-studio
Valid HTML 4.01! Valid CSS!