Génération de l'exemple Plants by WebSphere à l'aide de l'outil de génération Ant



Portabilité J2EE
Régénération des exemples livrés dans cette galerie
Mise en route
Identification de l'arborescence
Régénération et installation de l'exemple

Portabilité J2EE

La portabilité est l'un des principaux avantages du développement d'applications sur une plateforme J2EE.  Tous les programmes exemples de la galerie d'exemples sont développés sur un poste de travail et peuvent être exécutés sur des systèmes z/OS et iSeries sans qu'il soit nécessaire de modifier une seule ligne du code Java.  En créant des applications J2EE sur des systèmes Intel ou UNIX, un développeur évite l'écueil des conversions de fichiers EBCDIC en ASCII ou ASCII en EBCDIC.  La disponibilité des outils facilite le travail d'écriture et de test du développeur sur un poste de travail de développement et l'installation des fichiers EAR (Enterprise Archive) sur les systèmes z/OS et iSeries.

Régénération des exemples livrés dans cette galerie

Chaque instance WebSphere Application Server (Application Server) pour le client z/OS et iSeries est autorisée à accéder aux supports Application Server multi-plateformes. Si vous installez le produit WebSphere Application Server de base et les exemples sur l'une des plateformes prises en charge par ce package, vous obtenez la même galerie d'exemples. Il y a une exception : quand vous cliquez sur nom_exemple > Génération avec Ant > plateforme > Régénération et installation du fichier sample.ear, vous recevez des instructions pour régénérer le fichier EAR sur cette plateforme.  Etant donné que les fichiers texte dans un fichier EAR (fichiers XML, xmi, JSP (JavaServer Pages), etc.) doivent être au format ASCII, il est plus facile de modifier ces fichiers sur une machine ASCII.  Si vous effectuez des modifications sur une machine ASCII, vous pouvez ensuite déployer et installer le fichier EAR résultant sur la plateforme z/OS ou iSeries sans conversion EBCDIC en ASCII. 

Mise en route

Installez WebSphere Application Server sur la plateforme distribuée de votre choix et indiquez qu'il convient d'installer également les modèles d'applications.

Générez une copie de sauvegarde du répertoire <racine_profil>/samples  avant de modifier ou de régénérer les exemples. Créez un fichier zip du répertoire samples. Vous pourrez ensuite extraire le fichier zip pour restaurer le répertoire samples.

Identification de l'arborescence

Les exemples sont installés dans les répertoires suivants :


<racine_profil>/samples/src/PlantsByWebSphere Contient le code source de l'exemple Plants by WebSphere.
<racine_profil>/samples/lib/PlantsByWebSphere Contient les fichiers WAR (Web Archive), les fichiers JAR (Java Archive) et le fichier PlantsByWebSphere.ear final de l'exemple Plants by WebSphere. Ce répertoire est créé une fois que l'exemple Plants by WebSphere a été régénéré.
<racine_profil>/samples/javadoc/PlantsByWebSphere Contient la documentation Javadoc. Ce répertoire est créé une fois que l'exemple Plants by WebSphere a été régénéré.
<racine_profil>/samples/bld/PlantsByWebSphere Contient les fichiers de classe générés. Utilisez ces fichiers de classe pour générer le fichier PlantsByWebSphere.ear final. Ce répertoire est créé une fois que l'exemple Plants by WebSphere a été régénéré.

Régénération et installation de l'exemple

L'exemple Plants by WebSphere est installé automatiquement lors de l'installation de WebSphere Application Server. Il n'est pas nécessaire de générer l'exemple Plants by WebSphere pour pouvoir l'utiliser. Les instructions ci-dessous décrivent la procédure à suivre pour régénérer l'exemple et fournissent des informations complémentaires sur la manière de les modifier.


Exécution du script de génération des exemples
Transfert du fichier PlantsByWebSphere.ear régénéré
Suppression et réinstallation du fichier PlantsByWebSphere.ear

Exécution du script de génération des exemples

Pour régénérer cet exemple, vérifiez que racine_profil/bin figure dans votre variable d'environnement PATH. Suivez les étapes ci-après pour exécuter le script de génération de l'exemple, qui régénére l'exemple :

  1. Ouvrez une invite de commande.
  2. Sur la ligne de commande, accédez au répertoire <racine_profil>/samples/src/PlantsByWebSphere.
  3. Exécutez le script de génération de l'exemple :

  4. Entrez la commande suivante :


    <racine_profil>\samples\bin\PlantsByWebSphere\buildplantsby.bat


    • Sur les plateformes de développement Windows, entrez la commande suivante :

      <racine_profil>\samples\bin\PlantsByWebSphere\buildplantsby.bat


    • Sur les plateformes de développement UNIX et Linux, entrez la commande suivante :

      . <racine_profil>/samples/bin/PlantsByWebSphere/buildplantsby.sh

L'exemple est à présent généré.

Les scripts buildplantsby.bat et buildplantsby.sh du répertoire racine_profil/samples/bin/PlantsByWebSphere ont défini les informations du chemin d'accès aux classes appropriées et exécuté l'utilitaire de génération Ant. Ant lit les fichiers build.xml qui décrivent le mode de génération de l'exemple. Pour plus d'informations sur Ant, voir le site Web Jakarta.

Important  Lors du processus de génération, seuls les fichiers de classe ayant été modifiés sont régénérés. Les autres fichiers de classe sont intégrés dans le nouveau fichier EAR.

Transfert du fichier PlantsByWebSphere.ear régénéré

Utilisez le protocole FTP (File Transfer Protocol) pour transférer le fichier EAR binaire vers le serveur z/OS ou iSeries en procédant comme indiqué ci-dessous.

  1. Recherchez le fichier EAR régénéré dans le répertoire <racine_profil>/samples/lib/PlantsByWebSphere.
  2. Ouvrez une session FTP vers WebSphere Application Server pour z/OS ou iSeries à partir de la plateforme de développement.
  3. Accédez au répertoire <racine_profil>/samples/lib/PlantsByWebSphere.
    Il sera peut-être nécessaire de créer le répertoire s'il n'existe pas.
  4. Si le fichier PlantsByWebSphere.ear existe, supprimez-le pour permettre l'écriture du fichier actualisé.
    del PlantsByWebSphere.ear
  5. bin
  6. put PlantsByWebSphere.ear
  7. quit

Suppression et réinstallation du fichier PlantsByWebSphere.ear

Par défaut, l'exemple Plants by WebSphere est installé dans le répertoire racine_profil/installedApps/<nom de cellule>, où <nom de cellule > est le nom de la cellule dans laquelle l'application est installée. Réinstallez l'exemple en suivant la procédure ci-dessous :

  1. Arrêtez le serveur d'applications.
  2. Supprimez le fichier EAR de l'exemple Plants by WebSphere :
    1. Entrez les commandes suivantes :

      cd <racine_profil>\bin
      setupCmdLine

      cd <racine_profil>/bin
      . ./setupCmdLine.sh

      Sur les plateformes z/OS :
      cd <racine_profil>/bin
      . ./setupCmdLine.sh

      Sur les plateformes iSeries :
      cd <racine_profil>/bin
      . ./setupCmdLine

      <racine_profil> représente le répertoire d'installation du profil.
    2. Tapez la commande suivante pour désinstaller l'application (racine_profil/bin doit se trouver dans la variable d'environnement PATH.) :

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      Sur les plateformes z/OS :
      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      Sur les plateformes iSeries :
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. Réinstallez l'exemple Plants by WebSphere :
    • Accédez au répertoire racine_profil/samples/lib/PlantsByWebSphere.
    • Recherchez le fichier PlantsByWebSphere.ear.
    • Entrez la commande suivante :

      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<noeud>', '-server', '<serveur>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<noeud>', '-server', '<serveur>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.

      Sur les plateformes z/OS :
      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<noeud>', '-server', '<serveur>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    

      Sur On iSeries :
      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<noeud>', '-server', '<serveur>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      <noeud> est le nom du noeud, et <serveur> est le nom du serveur sur lequel l'exemple est installé.
  4. Démarrez le serveur d'applications.

 

Le fichier PlantsByWebsphere.ear régénéré est à présent déployé sur votre serveur d'applications.