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:
- Para las instalaciones de WebSphere Application
Server: raíz_intal_wxs/optionalLibraries/ObjectGrid
- Para las instalaciones autónomas:raíz_intal_wxs/ObjectGrid/lib
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
- Instale un adaptador de recursos de eXtreme Scale incluido.
Cuando el archivo wxsra.rar está incluido en el archivo EAR de la aplicación, el adaptador de recursos debe tener acceso a las bibliotecas de ejecución de eXtreme Scale.Para las aplicaciones que se ejecutan en WebSphere Application Server, están disponibles las siguientes opciones y las siguientes acciones:
Opción |
Descripción |
Si eXtreme Scale está integrado con el nodo WebSphere Application
Server |
Los archivos de biblioteca de tiempo de ejecución ya estarán disponibles en el classpath del sistema y no se precisarán más acciones. |
Si eXtreme Scale no está integrado en el nodo WebSphere Application
Server |
Puede incluir el archivo wsogclient.jar en el
classpath wxsra.rar. |
Para las aplicaciones que no ejecutan WebSphere Application Server, el archivo de biblioteca de tiempo de ejecución,
ogclient.jar, o el archivo de la biblioteca de tiempo de ejecución del servidor, objectgrid.jar, debe estar en el
classpath del archivo RAR.
- Instale un adaptador de recursos de eXtreme Scale autónomo.
Al instalar el archivo wxsra.rar como un adaptador de recursos autónomo, debe tener acceso a las bibliotecas de tiempo de ejecución de eXtreme Scale. Para las aplicaciones que se ejecutan en WebSphere Application Server, están disponibles las siguientes opciones y las siguientes acciones:
Opción |
Descripción |
Si eXtreme Scale está integrado con el nodo WebSphere Application
Server |
Los archivos de biblioteca de tiempo de ejecución ya estarán disponibles en el classpath del sistema y no se precisarán más acciones. |
Si eXtreme Scale no está integrado en el nodo WebSphere Application
Server |
Puede incluir el archivo wsogclient.jar en el
classpath wxsra.rar. |
Para las aplicaciones que no ejecutan WebSphere Application Server, el archivo de biblioteca de tiempo de ejecución,
ogclient.jar, o el archivo de la biblioteca de tiempo de ejecución del servidor, objectgrid.jar, debe estar en el
classpath del archivo RAR.
- Permita que el adaptador de recursos tenga acceso a cualquier clase compartida. Todas las clases de plug-in de ObjectGrid y las aplicaciones que las utilizan deben compartir un cargador de clases. Dado que el adaptador de recursos lo comparten varias aplicaciones, todas las clases deben ser accesible desde el mismo cargador de clases. Puede crear este acceso utilizando una biblioteca compartida entre todas las aplicaciones que interactúe con el adaptador de recursos.
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.