Exécution d'une application client ou serveur WebSphere eXtreme Scale avec Apache Tomcat dans Rational Application Developer

Que vous ayez une application client ou serveur, utilisez les mêmes étapes de base pour exécuter l'application dans Apache Tomcat dans Rational Application Developer. Dans le cas d'une application client, vous voulez configurer et exécuter une application Web pour qu'elle utilise un client WebSphere eXtreme Scale dans Rational Application Developer. Procédez comme indiqué ci-après pour créer un projet Web pour l'exécution d'un service de catalogue ou d'un conteneur WebSphere eXtreme Scale. Dans le cas d'une application serveur, vous voulez activer une application Java EE dans l'interface Rational Application Developer avec une installation autonome de WebSphere eXtreme Scale. Suivez ces instructions pour configurer une application Java EE du projet pour l'utilisation de la bibliothèque client WebSphere eXtreme Scale.

Avant de commencer

Installez la version d'évaluation de WebSphere eXtreme Scale ou le produit complet.

Procédure

  1. Ajoutez la bibliothèque d'exécution WebSphere eXtreme Scale au chemin de génération Java EE.

    Application client Dans ce scénario, vous voulez configurer et exécuter une application Web pour utiliser un client WebSphere eXtreme Scale dans Rational Application Developer.

    1. Cliquez sur Fenêtre > Préférences > Java > Chemin de compilation > Bibliothèques utilisateur. Cliquez sur Nouveau.
    2. Entrez eXtremeScaleClient comme nom de bibliothèque utilisateur et cliquez sur OK.
    3. Cliquez sur Ajouter des fichiers JAR... et allez au fichier base_wxs/lib/ogclient.jar. Cliquez sur Ouvrir.
    4. Facultatif : (Facultatif) Pour ajouter un Javadoc, sélectionnez l'emplacement de ce Javadoc et cliquez sur Editer.... Dans le chemin d'accès au Javadoc, vous pouvez entrer l'URL de la documentation des API ou télécharger cette documentation.
      • Pour utiliser la documentation en ligne, entrez http://www.ibm.com/developerworks/wikis/extremescale/docs/api/ dans le chemin d'accès au Javadoc.
      • Pour télécharger la documentation, allez à la WebSphere eXtreme Scalepage de téléchargement de la documentation des API. Comme chemin d'accès au Javadoc, entrez l'emplacement de votre disque dur où vous avez téléchargé la documentation.
    5. Cliquez sur OK.
    6. Cliquez sur OK et fermez la boîte de dialogue Bibliothèques utilisateur.
    7. Cliquez sur Projet > Propriétés.
    8. Cliquez sur Chemin de compilation Java.
    9. Cliquez sur Ajouter une bibliothèque.
    10. Sélectionnez Bibliothèque utilisateur. Cliquez sur Suivant.
    11. Cochez la bibliothèque eXtremeScaleClient et cliquez sur Terminer.
    12. Cliquez sur OK pour refermer la boîte de dialogue des propriétés du projet.

    Application serveur Dans ce scénario, vous voulez configurer et exécuter une application Web pour exécuter un serveur WebSphere eXtreme Scale intégré dans Rational Application Developer.

    1. Cliquez sur Fenêtre > Préférences > Java > Chemin de compilation > Bibliothèques utilisateur. Cliquez sur Nouveau.
    2. Entrez eXtremeScale comme nom de bibliothèque utilisateur et cliquez sur OK.
    3. Cliquez sur Ajouter des fichiers JAR... et sélectionnez rép_base_wxs/lib/objectgrid.jar. Cliquez sur Ouvrir.
    4. (Facultatif) Pour ajouter un Javadoc, sélectionnez l'emplacement de ce Javadoc et cliquez sur Editer.... Comme chemin d'accès au Javadoc, entrez http://www.ibm.com/developerworks/wikis/extremescale/docs/api/.
    5. Cliquez sur OK.
    6. Cliquez sur OK et fermez la boîte de dialogue Bibliothèques utilisateur.
    7. Cliquez sur Projet > Propriétés.
    8. Cliquez sur Chemin de compilation Java.
    9. Cliquez sur Ajouter une bibliothèque.
    10. Sélectionnez Bibliothèque utilisateur. Cliquez sur Suivant.
    11. Cochez la bibliothèque eXtremeScaleClient et cliquez sur Terminer.
    12. Cliquez sur OK pour refermer la boîte de dialogue des propriétés du projet.
  2. Définissez le serveur Tomcat pour notre projet.
    1. Vérifiez que vous vous trouvez dans la perspective J2EE et cliquez sur l'onglet Serveurs dans la sous-fenêtre inférieure. Vous pouvez également cliquer sur Fenêtre > Afficher la vue > Serveurs.
    2. Cliquez avec le bouton droit de la souris dans le volet Serveurs et sélectionnez Nouveau > Serveur.
    3. Sélectionnez Apache, Tomcat v6.0 Server. Cliquez sur Suivant.
    4. Cliquez sur Parcourir.... Sélectionnez racine_tomcat. Cliquez sur OK.
    5. Cliquez sur Suivant.
    6. Sélectionnez votre application Java EE dans le volet Disponibles à gauche et cliquez sur Ajouter > pour la faire passer vers le volet Configurées à droite sur le serveur, et cliquez sur Terminer.
  3. Résolvez les éventuelles erreurs restantes pour le projet. Procédez comme suit pour éliminer les erreurs dans le volet Problèmes :
    1. Cliquez sur Projet > Nettoyer > nom_projet. Cliquez sur OK. Compilez le projet.
    2. Cliquez avec le bouton droit de la souris sur le projet Java EE et sélectionnez Build Path > Configure Build Path.
    3. Cliquez sur l'onglet Bibliothèques. Vérifiez que le chemin est correctement configuré :
      • Pour les applications client : vérifiez que Apache Tomcat, eXtremeScaleClient et Java 1,5 JRE se trouvent dans le chemin.
      • Pour les applications server : vérifiez que Apache Tomcat, eXtremeScale et Java 1,5 JRE se trouvent dans le chemin.
  4. Créez une configuration d'exécution pour exécuter l'application.
    1. Dans le menu Run, sélectionnez Exécuter configurations.
    2. Cliquez avec le bouton droit de la souris sur la catégorie Application Java et sélectionnez New.
    3. Sélectionnez la nouvelle configuration d'exécution, Nouvelle_configuration.
    4. Configurez le profil.
      •  Projet (dans l'onglet principal) : nom_votre_projet
      • Classe principale (dans l'onglet principal) : votre_classe_principale
      • Arguments VM (dans l'onglet Arguments) : -Djava.endorsed.dirs=racine_wxs/lib/endorsed

      Des problèmes surgissent fréquemment avec les arguments VM car le chemin de java.endorsed.dirs doit être un chemin absolu sans variables ni raccourcis.

      D'autres problèmes usuels impliquent ORB (Object Request Broker). Il pourra vous arriver d'avoir l'erreur suivante. Voir Configuration d'un ORB personnalisé pour plus d'informations :
      Caused by: java.lang.RuntimeException: The ORB that comes with the 
      Java implementation does not work with ObjectGrid at this time.
      Si les fichiers objectGrid.xml ou deployment.xml ne sont pas accessibles à l'application, vous risquez de rencontrer l'erreur suivante :
      Exception in thread "P=211046:O=0:CT" com.ibm.websphere.objectgrid.ObjectGridRuntimeException: 
      Cannot start OG container
      	at Client.startTestServer(Client.java:161)
      	at Client.main(Client.java:82)
      Caused by: java.lang.IllegalArgumentException: The objectGridXML must not be null
      	at com.ibm.websphere.objectgrid.deployment.DeploymentPolicyFactory.createDeploymentPolicy
        (DeploymentPolicyFactory.java:55)
      	at Client.startTestServer(Client.java:154)
      	... 1 more
  5. Cliquez sur Appliquer et refermez la fenêtre ou cliquez sur Exécuter.

Que faire ensuite

Après avoir configuré et exécuté une application Web avec le client WebSphere eXtreme Scale dans Rational Application Developer, vous pouvez développer un servlet. Ce servlet utilise les API WebSphere eXtreme Scale pour stocker et extraire des données d'une grille de données distante.

Une fois que vous avez activé une application Java EE dans l'interface Rational Application Developer avec une installation autonome de WebSphere eXtreme Scale, vous pouvez développer un servlet qui utilise les API système WebSphere eXtreme Scale pour démarrer et arrêter les services de catalogue.