Installation d'un adaptateur de ressources eXtreme Scale

[Version 8.5 and later] 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 :

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

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.