Instalar el ejemplo del Manejador de errores
Cuando haya importado el ejemplo de Manejador de errores deberá
configurar el ejemplo para utilizar la transaccionalidad, antes de poder
desplegar el ejemplo para el intermediario.
Para configurar el ejemplo de Manejador de errores para que utilice la
transaccionalidad:
- Configure ODBC (sólo Linux)
- Habilite la transaccionalidad con DB2
(Windows y Linux)
- Habilite la transaccionalidad en WebSphere MQ (Windows y Linux):
- Despliegue el ejemplo en el intermediario
(Windows y Linux)
Configuración de los controladores
ODBC en Linux
Este paso debe realizarse en Linux pero no en Windows. Por tanto,
sáltese este paso si está trabajando solamente en Windows.
Para configurar los controladores ODBC en Linux:
- Abra el archivo
/var/mqsi/odbc/.odbc.ini en un editor de
texto.
- En el archivo .odbc.ini, localice la línea que dice: [ODBC Data Source] e inserte las líneas siguientes debajo de ella:
ERRORDB= IBM DB2 ODBC Driver
STAFFDB= IBM DB2 ODBC Driver
- Añada la sección siguiente en el archivo .odbc.ini:
[ERRORDB]
Driver=/opt/IBM/db2/V8.1/lib/libdb2.so
Description=ERRORDB DB2 ODBC Database
Database=ERRORDB
[STAFFDB]
Driver=/opt/IBM/db2/V8.1/lib/libdb2.so
Description=STAFFDB DB2 ODBC Database
Database=STAFFDB
Ahora los controladores ODBC ya están configurados correctamente.
Habilitar la transaccionalidad con DB2
Para configurar DB2 para que utilice la transaccionalidad:
- Inicie el Centro de control de DB2:
- En Windows, pulse en Inicio > Programas > IBM DB2 > Herramientas
de administración general > Centro de control
- En Linux, en la línea de mandatos, escriba db2cc
- En el árbol de navegación, donde nombre del sistema principal es el nombre de su sistema y
DB2 es el nombre de la instancia de la base de datos, amplíe
Todos los sistema > nombresistema > Instancias >
DB2. En Windows, DB2 es habitualmente DB2; en Linux,
DB2
es habitualmente db2inst1.
- Pulse el botón derecho del ratón en DB2 y después pulse en
Configurar parámetros... Se abrirá el diálogo Configuración de DBM.
- En el diálogo Configuración de DBM, desplácese hacia abajo en el diálogo hasta llegar a la sección
Entorno. En la columna Palabra clave, pulse en TP_MON_NAME.
- En TP_MON_NAME, pulse en la celda de la columna Valor y después en los puntos suspensivos
(...) de la misma celda. Se abrirá el diálogo Cambiar parámetro de configuración de DBM.
- En el diálogo Cambiar parámetro de configuración de DBM, en la
Lista de nombres de supervisor del procesador de transacciones, pulse
en IBM WebSphere MQ y después en
Aceptar.
- Pulse en Aceptar para cerrar el diálogo de configuración de
DBM. Se visualizará un mensaje pidiéndole que reinicie DB2: pulse en Cerrar para cerrar el
mensaje.
- En el árbol de navegación, pulse el botón derecho del ratón en
DB2 y después pulse en
Detener.
Un diálogo le pedirá que confirme que desea detener DB2 y desconectar todas las
aplicaciones que estén accediendo en ese momento a la base de datos DB2. Pulse en Aceptar para continuar y espere a que DB2 se detenga.
- En el árbol de navegación, pulse el botón derecho del ratón
en DB2 y después pulse en
Iniciar y espere a que DB2 se inicie de nuevo.
Habilitar la
transaccionalidad en WebSphere MQ Versión 6.0
Defina la base de datos STAFFDB como gestor de recursos XA para el
gestor de colas del intermediario. El gestor de colas del intermediario
actúa como gestor de transacciones. Los pasos para configurar el gestor de
colas son distintos si utiliza WebSphere MQ Versión 5.3.
Para definir la base de datos STAFFDB como un gestor de recursos XA:
- Copie el archivo de conmutación de DB2, de la instalación de WebSphere
Message Broker a la instalación de WebSphere MQ V6.0:
- En Windows, copie el archivo
db2swit.dll de
dir_instalación\sample\xatm a
dir_instalación_mq\exits donde
dir_instalación es la vía de acceso de la
instalación de WebSphere Message Broker y dir_instalación_mq es
la vía de acceso de la instalación de WebSphere MQ V6.0.
- En Linux, copie el archivo
db2swit de
dir_instalación/sample/xatm a
/var/mqm/exits donde
dir_instalación es la vía de acceso de la
instalación de WebSphere Message Broker.
DB2 ha de estar instalado en la ubicación por omisión para que el archivo de conmutación de
DB2 funcione correctamente.
- Configure el gestor de colas de intermediario,
WBRK6_DEFAULT_QUEUE_MANAGER, para añadir un nuevo gestor de recursos,
STAFFDB:
- Inicie WebSphere MQ Explorer:
- En Windows, pulse en
Inicio > Programas > IBM WebSphere MQ >
WebSphere MQ Explorer.
- En Linux, en la línea de mandatos, escriba:
strmqcfg
- En la vista de Navegador de WebSphere MQ Explorer,
expanda el árbol para visualizar el gestor de colas de intermediario,
WBRK6_DEFAULT_QUEUE_MANAGER.
- Pulse el botón derecho del ratón en WBRK6_DEFAULT_QUEUE_MANAGER y
después pulse en
Propiedades... Se abrirá el diálogo Propiedades del gestor de colas.
- En la página gestores de recursos XA, pulse en
Añadir... y, luego, escriba los detalles en
la siguiente tabla.
Nombre del campo |
Valor |
Nombre |
Gestor de errores de DB2 |
Archivo de conmutación |
db2swit |
XAOpenString |
STAFFDB,idusuario,contraseña,toc=t
donde idusuario es el nombre de usuario de WebSphere Message
Broker y contraseña es la contraseña asociada al mismo.
|
XACloseString
|
DB2 no requiere una cadena de caracteres de
cierre XA. |
Hebra de control |
En la lista, pulse en
Hebra. |
- Detenga e inicie el gestor de colas del intermediario. En
WebSphere MQ Explorer, pulse el botón derecho del ratón en
WBRK6_DEFAULT_QUEUE_MANAGER y después pulse
en Detener; pulse el botón derecho del
ratón en WBRK6_DEFAULT_QUEUE_MANAGER y
después pulse en Iniciar. Asegúrese de que el gestor de
colas se ha iniciado sin errores.
La base de datos STAFFDB está definida como el gestor de recursos XA en
el gestor de colas del intermediario, WBRK6_DEFAULT_QUEUE_MANAGER.
Habilitar la
transaccionalidad en WebSphere MQ Versión 5.3
Defina la base de datos STAFFDB como gestor de recursos XA para el
gestor de colas del intermediario. El gestor de colas del intermediario
actúa como gestor de transacciones. Los pasos para configurar el gestor de
colas son distintos si utiliza WebSphere MQ Versión 6.0. Además, en
WebSphere MQ Versión 5.3, no hay un equivalente gráfico de WebSphere
MQ Explorer, por lo que debe editar directamente el archivo ini de los
gestores de colas, tal como se describe en las siguientes instrucciones.
Para definir la base de datos STAFFDB como un gestor de recursos XA:
- Copie el archivo de conmutación de DB2, de la instalación de
WebSphere Message Broker a la instalación de WebSphere MQ V5.3:
- En Windows, copie el archivo
db2swit.dll de
dir_instalación\sample\xatm a
dir_instalación_mq\exits donde
dir_instalación es la vía de acceso de la
instalación de WebSphere Message Broker y dir_instalación_mq es
la vía de acceso de la instalación de WebSphere MQ V6.0.
- En Linux, copie el archivo
db2swit de
dir_instalación/sample/xatm a
/var/mqm/exits donde
dir_instalación es la vía de acceso de la
instalación de WebSphere Message Broker.
DB2 ha de estar instalado en la ubicación por omisión para que el archivo de conmutación de
DB2 funcione correctamente.
- Configure el gestor de colas de intermediario,
WBRK6_DEFAULT_QUEUE_MANAGER, para añadir un nuevo gestor de recursos,
STAFFDB:
- En Windows:
- Inicie el componente WebSphere MQ Services:
Inicio > Programas > IBM WebSphere MQ >
WebSphere MQ Services
- En la vista de Navegador de WebSphere MQ Explorer,
expanda el árbol para visualizar el gestor de colas de intermediario,
WBRK6_DEFAULT_QUEUE_MANAGER.
- Pulse el botón derecho del ratón en WBRK6_DEFAULT_QUEUE_MANAGER y
después pulse en
Propiedades... Se abrirá el diálogo Propiedades del gestor de colas.
- En la página Recursos, pulse en
Nuevo y, luego, escriba los detalles en
la siguiente tabla.
Nombre del campo |
Valor |
Nombre |
Gestor de errores de DB2 |
Archivo de conmutación |
dir_instalación\sample\xatm\db2swit.dll
donde dir_instalación es el directorio en el que se ha
instalado WebSphere MQ V5.3.
|
XAOpenString
|
STAFFDB,idusuario,contraseña
donde idusuario es el nombre de usuario de WebSphere Message
Broker y contraseña es la contraseña asociada al mismo.
|
XACloseString
|
DB2 no requiere una cadena de caracteres de
cierre XA. |
Hebra de control |
Para las versiones de DB2 anteriores a la
V8 seleccione Process; de lo contrario, seleccione
Thread. |
- Detenga e inicie el gestor de colas del intermediario. En
WebSphere MQ Services, pulse el botón derecho del ratón en
WBRK6_DEFAULT_QUEUE_MANAGER y después pulse
en Detener; pulse el botón derecho del
ratón en WBRK6_DEFAULT_QUEUE_MANAGER y
después pulse en Iniciar. Asegúrese de que el gestor de
colas se ha iniciado sin errores.
- En Linux:
- Abra el archivo /var/mqm/mqs.ini para editarlo y añada la
sección siguiente:
XAResourceManager:
Name=DB2 Error Handler
SwitchFile=dir_instalación/sample/xatm/db2swit
XAOpenString=STAFFDB,idusuario,contraseña
ThreadOfControl=PROCESS | THREAD
donde dir_instalación es la vía de acceso de la
instalación de WebSphere Message Broker y, si la versión de DB2 es
anterior a V8, escriba PROCESS; de lo contrario,
escriba THREAD.
- Detenga e inicie el gestor de colas del intermediario.
La base de datos STAFFDB está definida como el gestor de recursos XA en
el gestor de colas del intermediario, WBRK6_DEFAULT_QUEUE_MANAGER.
Desplegar el ejemplo de Manejador de
errores en el intermediario
- En el Kit de herramientas de Message Brokers, pase a la perspectiva
Administración de intermediarios.
- Cree un nuevo archivo archivador de intermediario (bar) y añada
Main_Flow.msgflow al archivo bar:
- En la perspectiva de Administración de intermediarios, pulse en Archivo > Nuevo > Archivador de
intermediario de mensajes. Se abrirá el asistente Nuevo archivador
de intermediario de mensajes.
- En el asistente de Nuevo archivador de intermediario de mensajes, seleccione el proyecto de servidor
y entre un nombre para el archivo bar. A continuación, pulse en Finalizar.
Se crea el nuevo archivo bar y se abre en el Editor de archivador de
intermediario.
- En el Editor de archivador de intermediario, pulse el botón
Añadir.
Se abre el diálogo Añadir al archivador del intermediario.
- En el diálogo Añadir al archivador del intermediario, pulse en el proyecto
Flujos de mensajes del manejador de errores y seleccione
Main_Flow.msgflow. Pulse Aceptar. El archivo
Main_Flow.msgflow se añade al archivo bar.
- Configure el flujo de mensajes para que se ejecute como una
transacción coordinada:
- Pulse la pestaña Configurar en la
parte inferior del Editor de archivador de intermediario para ir a la
página Configurar.
- Pulse Main_Flow.cmf para resaltarlo.
- Seleccione el recuadro Transacción
coordinada.
- Pulse la pestaña Contenido para
volver a la página principal del editor.
- Pulse Ctrl+S para guardar el archivo
bar.
- Asegúrese de que el Kit de herramientas de Message Brokers esté conectado al Gestor de
configuración.
- En la vista Dominios, cree un nuevo grupo de ejecución llamado ErrorHandler.
- En el Navegador de administración de intermediarios, pulse el botón derecho del ratón en el archivo bar
que ha creado y pulse en
Desplegar archivo.... Se abrirá el archivo Desplegar archivo BAR.
- En el diálogo Desplegar archivo BAR, pulse en
el grupo de ejecución ErrorHandler y después pulse en
Aceptar. El archivo Main_Flow.msgflow se despliega para el intermediario.
Ahora puede ejecutar el ejemplo del Manejador de errores. Consulte el apartado, Ejecutar
el ejemplo.
Volver a la Página de presentación de ejemplos