Configuración de transacciones IMS en WebSphere Liberty Profile

30/01/2015

WebSphere Liberty Profile
A continuación se describen los pasos a seguir para configurar el acceso a transacciones IMS (Information Management System) desde WebSphere Liberty Profile.

WebShpere Liberty Profile, a partir de la versión 8.5.5.2, soporta la configuración de adaptadores de recursos que cumplan con la especificación Java EE Connector Architecture (JCA) 1.6, 1.5 o 1.0.

Lo primero que necesitamos es el adaptador de recursos adecuado para la versión del servidor. En nuestro caso, ya que utilizamos el WebSphere Liberty Prole 8.5.x utilizaremos la versión 13. El adaptador de recursos lo podemos descargar directamente desde la página web de IBM (archivo ico1321.zip). El archivo zip, contiene varios archivos entres los que se encuentra el del conector ims1321.rar (situado en la ruta /IBM/IMS/ICO13/V1321/JCA15/ dentro del zip). Este conector, internamente, utiliza la librería ICU4J (International Components for Unicode) para la internacionalización de sus mensajes. Lamentablemente esta librería no existe en el Liberty Profile, por lo que, para conseguir que el conector funcione correctamente, debemos añadirla “manualmente” al archivo ims1321.rar. La librería la podemos descargar de los repositorios maven (archivo icu4j-3.4.4.jar) e incluirla en el ims1321.rar (por ejemplo, con el programa WinRAR o el rar en linux) renombrando este a ims1321-mod.rar (simplemente para diferenciarlo del original).

Importante:

El soporte para JCA en WebSphere Libety Profile debe añadirse a la hora de crear el entorno de ejecución del servidor Liberty Profile en el Eclipse.

Dentro del Eclipse, una vez que tenemos configurado nuestro servidor Websphere Liberty Profile vamos al “Project Explorer“, desplegamos la carpeta “WebSphere Application Server Liberty Profile” –> shared –> resources –> Boton derecho –> Import –> General –> File System. Pulsamos Next y navegamos a la carpeta donde tenemos el fichero ims1321-mod.rar.
Import File system
Pulsamos Finish
Liberty Profile resources
Nos situamos sobre la vista de Servers, pulsamos sobre la nueva configuración de servidor creada “WebSphere Application Server Liberty Profile at localhost” y la desplegamos. Hacemos doble click en “Server Configuration [server.xml] new server“.
Server Configuration
Pulsamos en la pestaña “Source” y tenemos que añadir el siguiente contenido:

server.xml

<?xml version="1.0" encoding="UTF-8"?>
<server description="new server">
<!-- Enable features -->
<featureManager>
...
<feature>jndi-1.0</feature>
<feature>jca-1.6</feature>
...
</featureManager>
...
<resourceAdapter id="ims1320"
location="${shared.resource.dir}/ims1321-mod.rar">

Donde la connectionFactory se repetiría tantas veces como aplicaciones con transacciones IMS necesitemos usar (con sus correspondientes valores de id, jndiName, dataStoreName, hostName, password, portNumber y userName).

IMPORTANTE!!

Para que nuestra aplicación pueda hacer uso y tener acceso a las clases de los adaptadores de recursos, es necesario definir un cargador de clases que tenga como proveedor de clases el del propio adaptador. La forma de hacerlo es mediante el atributo classProviderRef, junto con el correspondiente apiTypeVisibility del classloader. Por ejemplo:

server.xml

...
<enterpriseApplication id="app-ear"
location="app-ear.ear" name="app-ear">
<classloader
classProviderRef="cicsECI, ims1320" apiTypeVisibility="spec, ibm-api, api, third-party" />
</enterpriseApplication>
...

Donde cicsECI e ims1320 serían los identificadores de los resouceAdapter cuyas connectionFactory va a utilizar nuestra aplicación.

Responder

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión / Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión / Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión / Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión / Cambiar )

Conectando a %s

A %d blogueros les gusta esto: