Si una aplicación se desarrolla con un adaptador WebSphere Adapter
incorporado, el adaptador se despliega con la aplicación. No es necesario
instalar el adaptador por separado. Se describen los pasos para instalar una
aplicación con un adaptador incorporado.
Antes de empezar
Esta tarea sólo debe realizarse si la aplicación se desarrolla con
un adaptador WebSphere Adapter incorporado y se monta con módulos de archivo
de adaptador de recursos (RAR) en la aplicación. Para obtener información
sobre el ensamblaje de aplicaciones, consulte el apartado
Ensamblaje
de aplicaciones.
Por qué y cuándo se efectúa esta tarea
Si una aplicación debe acceder a datos en un sistema EIS (Enterprise
Information System), puede hacerlo utilizando conectores de J2EE Connector
Architecture. Como se indica en la especificación de J2EE Connector Architecture
(JCA), cada sistema EIS (Enterprise Information System) necesita un adaptador
de recursos y una fábrica de conexiones. Para desplegar una aplicación que
incluya un adaptador WebSphere Adapter incorporado, puede instalar los archivos
de la aplicación y crear una fábrica de conexiones J2C o seleccionar una fábrica
de conexiones existente para que la utilice la instalación.
Para instalar
una aplicación con un adaptador WebSphere Adapter incorporado, utilice la
consola administrativa para llevar a cabo los pasos siguientes:
Pasos para realizar esta tarea
- Instale la aplicación. Por ejemplo, siga los pasos de Instalación del archivo EAR
de un módulo de mediación con la consola.
En el paso Correlacionar
módulos con servidores, especifique los servidores o los clústeres de destino
para cada archivo RAR. Asegúrese de correlacionar los demás módulos que utilicen
los adaptadores de recursos definidos en los módulos RAR con los mismos destinos.
Además, especifique los servidores web como destinos que sirvan de direccionadores
para solicitudes en esta aplicación. Se genera el archivo de configuración
de conector (plugin-cfg.xml) para cada servidor web en función de las aplicaciones
que se direccionan a través de él.
Nota: Al instalar un archivo RAR en
un servidor, WebSphere ESB busca
el manifiesto (MANIFEST.MF) del módulo de conector. Primero busca el archivo
RAR en el archivo connectorModule.jar y carga el manifiesto del archivo _connectorModule.jar.
Si la entrada de vía de acceso de clases se encuentra en el manifiesto del
archivo connectorModule.jar, el archivo RAR utiliza la vía de acceso de clases.
Para garantizar que el módulo de conector instalado busca las clases y los
recursos necesarios, compruebe el valor Vía de acceso de clases para
el archivo RAR utilizando la consola. Para obtener más información sobre el
valor de Vía de acceso de clases, consulte los valores
de Adaptador de recursos de la consola administrativa.
- Guarde los cambios en la configuración maestra. Pulse .
- Cree fábricas de conexiones para la aplicación recién instalada. Utilice la consola administrativa para completar los siguientes subpasos:
- Seleccione la aplicación recién instalada
- En el panel de navegación, pulse .
- En el panel de contenido, pulse el nombre de la aplicación.
- Pulse Módulos de conector en la sección
Elementos relacionados de la página.
- Pulse el nombre del archivo RAR.
- Pulse Adaptador de recursos en la sección
Propiedades adicionales de la página.
- Pulse Fábricas de conexiones de J2C en
la sección Propiedades adicionales de la página.
- Pulse el nombre de una fábrica de conexiones existente para
actualizarla o pulse Nuevo para crear una fábrica nueva.
Nota: Si el adaptador WebSphere Adapter se ha configurado utilizando
la importación de EIS o la exportación de EIS, hay una fábrica de conexiones
existente o una especificación de activación que puede actualizarse.
- Opcional: Especifique un alias de autenticación
para recuperación de XA o utilice un alias de autenticación gestionado por
componentes. Este campo sólo se visualiza para recursos que admitan
transacciones XA.
- Opcional: Seleccione un Alias de autenticación
gestionada por componentes.
Si no hay disponible ningún
alias deseado o desea definir uno diferente,
- Pulse Aplicar.
- Pulse Entradas de datos de autenticación J2C en
Elementos relacionados.
- Pulse Nuevo.
- Especifique las propiedades generales.
- Pulse Aceptar para regresar al panel de valores
de fábricas de conexiones J2C.
Seleccione o defina un alias, si algún componente de su aplicación
obtiene conexiones de esta fábrica de conexiones con el método getConnection()
con argumentos vacíos y con la autenticación de aplicación o por
fábrica de conexiones especificada en la referencia del recurso.
Si instala un adaptador que incluya elementos de vía de acceso nativa,
tenga en cuenta la información siguiente: si tiene más de un elemento de vía
de acceso nativa y una de las bibliotecas nativas (biblioteca nativa A) depende
de otra biblioteca (biblioteca nativa B), debe copiar la biblioteca nativa
B en un directorio del sistema. Debido a limitaciones en la mayoría de sistemas
UNIX, un intento de cargar una biblioteca nativa no buscará en el directorio
actual.
Después de crear y guardar las fábricas de conexiones, puede
modificar las referencias de recursos definidas en diferentes módulos de la
aplicación y especificar los nombres JNDI (Java Naming and Directory Interface)
de las fábricas de conexiones según convenga.
Nota: Una determinada
biblioteca nativa sólo puede cargarse una vez por cada instancia de Java Virtual
Machine (JVM). Puesto que cada aplicación tiene su propio cargador de clases,
las aplicaciones separadas con archivos RAR incorporados no pueden utilizar
la misma biblioteca nativa. La segunda aplicación recibe una excepción cuando
intenta cargar la biblioteca.
Si una aplicación desplegada en el servidor
de aplicaciones utiliza un archivo RAR incorporado que incluye elementos de
vía de acceso nativa, debe asegurarse siempre de concluir el servidor de aplicaciones
de forma normal sin transacciones pendientes. Si el servidor de aplicaciones
no concluye normalmente, se realizará la recuperación tras el reinicio del
servidor y se cargarán los archivos RAR necesarios y las bibliotecas nativas.
Tras la finalización de la recuperación, no intente ningún trabajo relacionado
con la aplicación. Concluya el servidor y reinícielo. El servidor de aplicaciones
no intenta ninguna recuperación adicional en este reinicio, y puede continuar
el proceso normal de las aplicaciones.