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.
- Installez la version autonome du produit WebSphere eXtreme Scale.
- Téléchargez et extrayez la version d'évaluation de WebSphere eXtreme Scale.
- Installez Apache Tomcat Version 6.0 ou une version suivante.
- Installez Rational Application
Developer et créez une application Web Java EE.
Procédure
- 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.
- Cliquez sur . Cliquez sur Nouveau.
- Entrez eXtremeScaleClient comme nom de bibliothèque utilisateur
et cliquez sur OK.
- Cliquez sur Ajouter des fichiers JAR... et allez au fichier
base_wxs/lib/ogclient.jar.
Cliquez sur Ouvrir.
- 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.
- Cliquez sur
OK.
- Cliquez sur OK et fermez la boîte de dialogue Bibliothèques utilisateur.
- Cliquez sur .
- Cliquez sur Chemin de compilation Java.
- Cliquez sur Ajouter une bibliothèque.
- Sélectionnez Bibliothèque utilisateur. Cliquez sur
Suivant.
- Cochez la bibliothèque eXtremeScaleClient
et cliquez sur Terminer.
- 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.
- Cliquez sur .
Cliquez sur Nouveau.
- Entrez eXtremeScale comme nom de bibliothèque utilisateur
et cliquez sur OK.
- Cliquez sur Ajouter des fichiers JAR... et sélectionnez rép_base_wxs/lib/objectgrid.jar.
Cliquez sur Ouvrir.
- (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/.
- Cliquez sur
OK.
- Cliquez sur OK et fermez la boîte de dialogue Bibliothèques utilisateur.
- Cliquez sur .
- Cliquez sur Chemin de compilation Java.
- Cliquez sur Ajouter une bibliothèque.
- Sélectionnez Bibliothèque utilisateur. Cliquez sur
Suivant.
- Cochez la bibliothèque eXtremeScaleClient
et cliquez sur Terminer.
- Cliquez sur OK pour refermer la boîte de dialogue des propriétés du projet.
- Définissez le serveur Tomcat pour notre projet.
- 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 .
- Cliquez avec le bouton droit de la souris dans le volet Serveurs et sélectionnez .
- Sélectionnez Apache, Tomcat v6.0 Server.
Cliquez sur
Suivant.
- Cliquez sur Parcourir....
Sélectionnez racine_tomcat. Cliquez sur
OK.
- Cliquez sur
Suivant.
- 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.
- Résolvez les éventuelles erreurs restantes pour le projet. Procédez comme suit pour éliminer les erreurs dans le volet Problèmes :
- Cliquez sur . Cliquez sur OK. Compilez le projet.
- Cliquez avec le bouton droit de la souris sur le projet Java EE et sélectionnez .
- 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.
- Créez une configuration d'exécution pour exécuter l'application.
- Dans le menu Run, sélectionnez Exécuter configurations.
- Cliquez avec le bouton droit de la souris sur la catégorie Application Java
et sélectionnez New.
- Sélectionnez la nouvelle configuration d'exécution, Nouvelle_configuration.
- 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
- 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.