L'adaptateur de ressources WebSphere eXtreme Scale
est compatible avec Java Connector Architecture (JCA)
1.5 et peut être installé sur un serveur d'applications Java 2
Platform, Enterprise Edition (J2EE) 1.4 ou version ultérieure, tel que
WebSphere Application
Server.
Avant de commencer
L'adaptateur de ressources se trouve dans le fichier
wxsra.rar
qui est disponible dans toutes les installations
d'
eXtreme Scale. Le fichier RAR
se trouve dans les répertoires suivants :
- Pour les installations WebSphere Application
Server : racine_install_wxs/optionalLibraries/ObjectGrid
- Pour les installations autonomes : répertoire racine_install_wxs/ObjectGrid/lib
L'adaptateur de ressources est couplé avec l'environnement d'exécution eXtreme Scale.
Il nécessite que les fichiers JAR d'exécution eXtreme Scale se trouvent dans le chemin de classes correct. En général, vous pouvez mettre à niveau l'environnement d'exécution eXtreme Scale sans mettre à jour l'adaptateur de ressources. La mise à niveau de l'environnement d'exécution eXtreme Scale provoque également la mise à niveau de l'environnement d'exécution de l'adaptateur de ressources. L'adaptateur de ressources prend en charge la version 8.5 et jusqu'à deux versions ultérieures de l'environnement d'exécution eXtreme Scale.
Les versions ultérieures de l'adaptateur de ressources peuvent nécessiter des versions ultérieures de l'environnement d'exécution eXtreme Scale au fur et à mesure de leur disponibilité.
Le fichier wxsra.rar requiert l'un des fichiers
JAR d'exécution client eXtreme Scale pour fonctionner. Pour plus
de détails sur le fichier JAR d'exécution client approprié, voir les sections
Fichiers d'exécution de l'installation autonome WebSphere eXtreme Scale et
Fichiers d'exécution pour WebSphere eXtreme Scale intégré à WebSphere Application Server qui incluent des détails sur les fichiers
JAR d'exécution disponibles.
Pourquoi et quand exécuter cette tâche
Vous pouvez installer l'adaptateur de ressources eXtreme Scale
à l'aide de plusieurs options qui permettent d'appliquer des scénarios de déploiement souples.
L'adaptateur de ressources peut être imbriqué dans l'application
Java Platform,
Enterprise Edition (Java EE), ou installé
en tant que fichier RAR autonome partagé entre les applications.
L'incorporation
de l'adaptateur de ressources à l'application simplifie le déploiement car les fabriques de connexions
sont créées uniquement dans la portée de l'application et ne peuvent pas être partagées entre les
applications. Lorsque l'adaptateur de ressources est incorporé dans l'application, vous pouvez également incorporer les objets cache et les classes de plug-in client
ObjectGrid dans l'application. Cette incorporation protège également l'application contre tout partage d'objets cache qui pourrait se produire par inadvertance entre les applications, et qui entraînerait des exceptions
java.lang.ClassCastExceptions.
L'installation du fichier
wxsra.rar en tant qu'adaptateur de ressources autonome
permet de créer des fabriques de connexions de gestionnaire de ressources
dans la portée du noeud. Cette option est utile dans les situations suivantes :
- Lorsque ce n'est pas pratique d'incorporer le fichier wxsra.rar dans l'application.
- Lorsque la version d'eXtreme Scale n'est pas connue au moment de la génération.
- Lorsque vous souhaitez partager une connexion client eXtreme Scale
avec plusieurs applications.
Important : Dans plusieurs versions de
WebSphere
Application Server (jusqu'à la version 8.0.2),
vous ne pouvez pas installer l'adaptateur de ressources
eXtreme Scale simultanément dans un fichier EAR d'application et dans une serveur autonome.
Le résultat, lorsque vous utilisez le fichier EAR (Enterprise Archive) qui est également associé à un fichier RAR installé, est que l'application fait fasse à une exception, telle que
ClassCastException: com.ibm.websphere.xs.ra.XSConnectionFactory
incompatible with com.ibm.websphere.xs.ra.XSConnectionFactory.
L'exemple de message
WebSphere
Application Server suivant et la pile d'appels associée à cette erreur s'affichent lorsqu'un servlet rencontre cette exception :
SRVE0068E: An exception was thrown by one of the service methods of the servlet [ClientServlet]
in application [JTASampleClientEAR]. Exception created : [java.lang.ClassCastException:
com.ibm.websphere.xs.ra.XSConnectionFactory incompatible with com.ibm.websphere.xs.ra.XSConnectionFactory
at com.ibm.websphere.xs.sample.jtasample.WXSClientServlet.connectClient(WXSClientServlet.java:484)
at com.ibm.websphere.xs.sample.jtasample.WXSClientServlet.doGet(WXSClientServlet.java:200)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:575)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:668)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.service(ServletWrapper.java:1214)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:774)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:456)
Procédure
- Installez un adaptateur de ressources eXtreme Scale imbriqué.
Lorsque le fichier wxsra.rar est imbriqué dans le fichier EAR d'application,
l'adaptateur de ressources doit avoir accès aux bibliothèques d'exécution eXtreme Scale.
Pour les applications exécutées dans WebSphere Application Server,
vous disposez des choix et des actions suivantes :
Option |
Description |
Si eXtreme Scale est intégré au noeud
WebSphere Application Server |
Les fichiers de bibliothèque d'exécution sont déjà disponibles dans le chemin d'accès aux classes du système
et aucune autre action n'est requise. |
Si eXtreme Scale n'est pas intégré
au noeud WebSphere Application Server |
Vous devez inclure le fichier wsogclient.jar
dans le chemin d'accès aux classes wxsra.rar. |
Pour les applications qui ne s'exécutent pas dans WebSphere
Application Server, le fichier de bibliothèque d'exécution client ogclient.jar ou le
fichier de bibliothèque d'exécution serveur objectgrid.jar doit se trouver dans le
chemin d'accès aux classes du fichier RAR.
- Installez un adaptateur de ressources eXtreme Scale autonome.
Lorsque vous installez le fichier wxsra.rar en tant qu'adaptateur de ressources
autonome, il doit avoir accès aux bibliothèques d'exécution eXtreme Scale.
Pour les applications exécutées dans WebSphere Application Server,
vous disposez des choix et des actions suivantes :
Option |
Description |
Si eXtreme Scale est intégré au noeud
WebSphere Application Server |
Les fichiers de bibliothèque d'exécution sont déjà disponibles dans le chemin d'accès aux classes du système
et aucune autre action n'est requise. |
Si eXtreme Scale n'est pas intégré
au noeud WebSphere Application Server |
Vous devez inclure le fichier wsogclient.jar
dans le chemin d'accès aux classes wxsra.rar. |
Pour les applications qui ne s'exécutent pas dans WebSphere
Application Server, le fichier de bibliothèque d'exécution client ogclient.jar ou le
fichier de bibliothèque d'exécution serveur objectgrid.jar doit se trouver dans le
chemin d'accès aux classes du fichier RAR.
- Donnez à l'adaptateur de ressources accès à toutes les classes partagées. Toutes les classes de plug-in ObjectGrid et les applications qui les utilisent
doivent partager un chargeur de classe. L'adaptateur de ressources étant partagé par plusieurs
applications, toutes les classes doivent être accessibles au même chargeur de classe. Vous pouvez
créer cet accès en utilisant une bibliothèque partagée entre les applications qui interagissent
avec l'adaptateur de ressources.
Que faire ensuite
Maintenant que vous avez installé l'adaptateur de ressources
eXtreme Scale, vous pouvez configurer les fabriques de connexions afin que vos applications Java EE puissent se connecter à une grille de données
eXtreme Scale distante.