Instalar un adaptador de recursos eXtreme Scale

[Version 8.5 and later] El adaptador de recursos de WebSphere eXtreme Scale es compatible con Java Connector Architecture (JCA) 1.5 y se puede instalar en un servidor de aplicaciones Java 2 Platform, Enterprise Edition (J2EE) 1.4 o posterior de WebSphere Application Server.

Antes de empezar

El adaptador de recursos es un archivo de adaptador de recursos RAR (Resource Adapter Archive) wxsra.rar, que está disponible en todas las instalaciones de eXtreme Scale. El archivo RAR se encuentra en los siguientes directorios:

El adaptador de recursos está relacionado con el entorno de ejecución de eXtreme Scale. Requiere los archivos JAR de ejecución de eXtreme Scale en el classpath correcto. En general, puede actualizar el entorno de ejecución de eXtreme Scale sin actualizar el adaptador de recursos. Si actualiza el entorno de ejecución de eXtreme Scale también se actualiza el entorno de ejecución del adaptador de recursos. El adaptador de recursos soporta la versión 8.5 y hasta dos versiones posteriores del entorno de ejecución de eXtreme Scale. Las versiones posteriores del adaptador de recursos pueden requerir versiones posteriores del entorno de ejecución de eXtreme Scale en cuanto estén disponibles.

El archivo wxsra.rar precisa uno de los archivos JAR de ejecución de cliente de eXtreme Scale para funcionar. Para obtener más detalles sobre qué archivo JAR de cliente de ejecución es adecuado, consulte Archivos de ejecución para una instalación autónoma de WebSphere eXtreme Scale y Archivos de ejecución de WebSphere eXtreme Scale integrado con WebSphere Application Server, que incluyen detalles acerca de los archivos JAR de ejecución disponibles.

Acerca de esta tarea

Puede instalar el adaptador de recursos de eXtreme Scale utilizando las diversas opciones que admiten escenarios de despliegue flexibles. El adaptador de recursos puede incluirse en la aplicación Java Platform, Enterprise Edition (Java EE) o puede instalarse como archivo RAR autónomo compartido entre aplicaciones.

Al incluir el adaptador de recursos con la aplicación se simplifica el despliegue porque las fábricas de conexiones sólo se crean dentro del alcance de la aplicación y no pueden compartirse entre aplicaciones. Con el adaptador de recursos incluido en la aplicación, puede incluir también los objetos de memoria caché y las clases de plug-in de cliente ObjectGrid dentro de la aplicación. Al incluir el adaptador de recursos también se protege la aplicación contra el intercambio imprevisto de objetos de memoria caché entre las aplicaciones, lo que puede causar excepciones java.lang.ClassCastExceptions.

Al instalar el archivo wxsra.rar como un adaptador de recursos autónomo, puede crear fábricas de conexión del gestor de recursos en el ámbito del nodo. Esta opción es útil en las siguientes situaciones:
  • Cuando no resulta práctico incluir el archivo wxsra.rar en la aplicación
  • Cuando se desconoce la versión de eXtreme Scale en el momento de la compilación
  • Cuando quiere compartir una conexión de cliente de eXtreme Scale con múltiples aplicaciones
Importante: En múltiples versiones de WebSphere Application Server, hasta la versión 8.0.2, no puede instalar el adaptador de recursos de eXtreme Scale en un archivo EAR de aplicación de forma simultánea en el servidor autónomo. El resultado, al utilizar el archivo EAR (archivador empresarial) que también tiene el archivo RAR instalado, es que la aplicación sufre una excepción del tipo ClassCastException: com.ibm.websphere.xs.ra.XSConnectionFactory incompatible with com.ibm.websphere.xs.ra.XSConnectionFactory. El siguiente mensaje de ejemplo de WebSphere Application Server y la pila de llamadas de este error se visualizan cuando un servlet encuentra esta excepción:
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)

Procedimiento

Qué hacer a continuación

Ahora que ha instalado el adaptador de recursos de eXtreme Scale puede configurar fábricas de conexiones de forma que las aplicaciones Java EE puedan conectarse a una cuadrícula de datos de eXtreme Scale remota.