Génération de l'exemple BeenThere à l'aide de l'outil 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 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.

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

Chaque instance WebSphere Application Server (Application Server) pour le client z/OS 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 obtenu sur la plateforme z/OS 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'application.

Faites une copie de sauvegarde du répertoire <racine_profil> avant de modifier ou de régénérer des 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

La structure des répertoire de génération de l'exemple est la suivante :


racine_profil/samples/src/BeenThere Contient le code source de l'exemple BeenThere.
racine_profil/samples/lib/BeenThere Contient le fichier BeenThere.ear de l'exemple BeenThere.
racine_profil/samples/javadoc/BeenThere Contient la documentation Javadoc créée lors de la génération de l'exemple BeenThere.
racine_profil/samples/bld/BeenThere Contient les fichiers de classe générés. Utilisez ces fichiers de classe pour générer le fichier BeenThere.ear final. Le répertoire bld est créé une fois l'exemple BeenThere régénéré.



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

Les instructions ci-dessous décrivent la procédure à suivre pour régénérer l'exemple.


Exécution du script de génération de l'exemple

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/BeenThere.
  3. Exécutez le script de génération de l'exemple :

  4. Entrez la commande suivante :

    racine_profil\samples\bin\BeenThere\buildBeenThere.bat

    Entrez la commande suivante :

    . racine_profil/samples/bin/BeenThere/buildBeenThere.sh

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

      racine_profil\samples\bin\BeenThere\buildBeenThere.bat

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

      . racine_profil/samples/bin/BeenThere/buildBeenThere.sh
    Entrez la commande suivante :

    . racine_profil/samples/bin/BeenThere/buildBeenThere.sh

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

Recherchez le script buildBeenThere.bat ou buildBeenThere.sh dans le répertoire racine_profil/samples/bin/BeenThere. Les scripts définissent les informations de chemin d'accès aux classes appropriées et exécutent l'utilitaire Ant. Cet utilitaire lit les fichiers build.xml, qui décrivent comment générer les exemples. Pour plus d'informations sur Ant, voir le site Web Jakarta.

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

Utilisez le protocole FTP (File Transfer Protocol) pour transférer le fichier EAR binaire sur le serveur z/OS en suivant les instructions ci-dessous.

  1. Recherchez le fichier EAR régénéré dans le répertoire <racine_profil>/samples/lib/BeenThere.
  2. Ouvrez une session FTP vers WebSphere Application Server pour z/OS à partir de la plateforme de développement.
  3. Accédez au répertoire <racine_profil>/samples/lib/BeenThere.
  4. del BeenThere.ear
  5. bin
  6. put BeenThere.ear
  7. quit

Suppression et réinstallation du fichier BeenThere.ear

Réinstallez l'exemple en suivant la procédure ci-dessous :


  1. Lancez la console d'administration en ouvrant un navigateur Web et en accédant à l'adresse http://<nom_hôte>:9060/ibm/console<nom_hôte> est le nom d'hôte ou l'adresse IP où le gestionnaire de déploiement est exécuté.
  2. Lancez la console d'administration en ouvrant un navigateur Web et en accédant à l'adresse http://<nom_hôte>:9060/ibm/console<nom_hôte> est le nom d'hôte ou l'adresse IP où le gestionnaire de déploiement est exécuté.
  3. Lancez la console d'administration en ouvrant un navigateur Web et en accédant à l'adresse http://<nom_hôte>:9080/admin<nom_hôte> est le nom d'hôte ou l'adresse IP où le gestionnaire de déploiement est exécuté.
  4. Lancez la console d'administration en ouvrant un navigateur Web et en accédant à l'adresse http://<nom_hôte>:9060/ibm/console<nom_hôte> est le nom d'hôte ou l'adresse IP où le gestionnaire de déploiement est exécuté.
  5. Cliquez sur Serveurs > Clusters.
  6. Sélectionnez tous les clusters.
  7. Cliquez sur Arrêter.
  8. Cliquez sur Applications > Applications d'entreprise.
  9. Sélectionnez l'application BeenThere.
  10. Cliquez sur Désinstaller.
  11. Cliquez sur Sauvegarder, en haut du panneau principal de la console d'administration.
  12. Cliquez sur Sauvegarder.
  13. Suivez la procédure d'Installation du fichier BeenThere.ear.

Le fichier BeenThere.ear régénéré est maintenant déployé sur les serveurs d'applications.