Manual de Configuracion Cola de Mensajes Docx

MMANUALANUAL C COLAOLA DEDE M MENSAJESENSAJES

MMANUALANUAL DEDE CONFIGURACIÓNCONFIGURACIÓN PARAPARA REALIZARREALIZAR UNAUNA COLACOLA

DEDE MENSAJESMENSAJES..

Ciudad de Panamá, Abril 2012

ELABORADO APROBADO

Por: Verónica Jardim Por:

Documento confidencial. Prohibida su reproducción y la transmisión de su información, sin el permiso escrito de la Compañía.


TTABLAABLA DEDE C CONTENIDOSONTENIDOSPág.Pág.

1. INTROCUCCION....................................................................6

1.1 PROPÓSITO..............................................................................6

2. CONFIGURANDO LA COLA DE MENSAJES................................7

2.1 GENERANDO UNA COLA DE MENSAJES EN EL WEBLOGIC........................9

2.2 GENERANDO UN PROYECTO SERVICE BUS DESDE ECLIPSE....................20

2.3 IMPORTANDO EL PROYECTO AL ORACLE SERVICE BUS.........................30

2.4 GENERANDO UN PROYECTO DE AUDITORÍA DESDE JDEVELOPER..............36

2.5 DESPLEGANDO EL PROYECTO DE AUDITORIA AL WEBLOGIC SERVER........37



ÍÍNDICENDICE DEDE I ILUSTRACIONESLUSTRACIONES::

Ilustración 1 - Ingresando al Weblogic Server.....................................................................7Ilustración 2 - Página de inicio del Weblogic Server............................................................8Ilustración 3 - Servidores JMS.............................................................................................9Ilustración 4 - Configurando servidor JMS.........................................................................10Ilustración 5 - Seleccionando destino de servidor JMS......................................................10Ilustración 6 - Pantalla de Módulos JMS............................................................................11Ilustración 7 – Configurando un módulo JMS.....................................................................11Ilustración 8 – Seleccionando destinos para el módulo del sistema JMS...........................12Ilustración 9 - Consulta para la creación del módulo de sistema JMS................................13Ilustración 10 - Generando nuevos recursos de módulos de sistema JMS.........................13Ilustración 11 - Configuración de Fábrica de mensajes en el módulo de sistema JMS.......14Ilustración 12 - Ingreso de datos de configuración en la fábrica de mensajes, módulo JMS.......................................................................................................................................... 15Ilustración 13 - Seleccionando destino para la fábrica de mensajes, módulo JMS.............15Ilustración 14 - Pantalla de recursos generados en los módulos JMS................................16Ilustración 15 - Generando una Cola en el módulo del sistema JMS..................................16Ilustración 16 - Ingreso de datos para la cola en el módulo del sistema JMS....................17Ilustración 17 - Creación de despliegues secundarios en el módulo del sistema JMS........18Ilustración 18 – Ingresando nombre del despliegue secundario........................................18Ilustración 19 - Seleccionando el servidor destino en el despliegue secundario del módulo JMS....................................................................................................................................19Ilustración 20 - Pantalla de Eclipse, generando un Oracle Service Bus Project.................20Ilustración 21 - Generando el nombre del proyecto service bus.......................................21Ilustración 22 - Pantalla con el proyecto generado en el eclipse.......................................21Ilustración 23 - Generando un bussines service en el Eclipse...........................................22Ilustración 24 - Pantalla del Wizard para darle el nombre al Bussines Service que se generara...........................................................................................................................22Ilustración 25 - Pantalla del bussines service en la pestaña General para la configuración de la cola de mensajes.....................................................................................................23Ilustración 26 - Pantalla del bussines service en la pestaña Messaging para la configuración de la cola de mensajes...............................................................................24Ilustración 27 - Pantalla del bussines service en la pestaña Transport para la configuración de la cola de mensajes...............................................................................25Ilustración 28 - Pantalla del bussines service en la pestaña Transport para la configuración de la cola de mensajes...............................................................................26Ilustración 29 - Pantalla del bussines service en la pestaña JMS Transport para la configuración de la cola de mensajes...............................................................................27Ilustración 30 - Pantalla del bussines service en la pestaña Message Handling para la configuración de la cola de mensajes...............................................................................28Ilustración 31 - Exportando un proyecto a un .Jar.............................................................28Ilustración 32 - Pantalla del Wizard para finalizar la exportación del proyecto.................29Ilustración 33 - Pantalla de inicio de sesión en el Oracle Service Bus...............................30Ilustración 34 - Creando una sesión para el despliegue....................................................31Ilustración 35 - Activando una sesión para control de cambios en los despliegues..........31Ilustración 36 - Ingresando a la Administración del sistema.............................................32Ilustración 37 - Importando el proyecto service bus generado.........................................32Ilustración 38 - Pantalla donde se muestra el nombre del proyecto que se va a importar al Weblogic...........................................................................................................................33Ilustración 39 - Pantalla donde se muestra el bussines service una vez desplegado........33Ilustración 40 – Ejecutando pruebas de un Bussines service............................................34Ilustración 41 - Ingresando un mensaje para la ejecución del bussines service................34



Ilustración 42 - Pantalla donde se muestra los valores recibidos en la cola de mensajes. 35Ilustración 43 - Pantalla con el resumen de mensajes de JMS...........................................35Ilustración 44 - Pantalla donde se muestran los paquetes generados para la auditoria del mensaje en el JDeveloper.................................................................................................36Ilustración 45 - Ingresando los parámetros de conexión con la cola de mensajes en el MDB..................................................................................................................................37Ilustración 46 - Pantalla con el despliegue el del proyecto del MDB en el administrador del Weblogic...........................................................................................................................38Ilustración 47 - Mostrando el mensaje generado desde el bussines service en la consola donde se está ejecutando el servicio................................................................................38

11DDATOSATOS I IDENTIFICATIVOSDENTIFICATIVOS DELDEL D DOCUMENTOOCUMENTO

Proyecto : ESB TOCUMEN PANAMÁ

Cliente : AEROPUERTO INTERNACIONAL DE TOCUMEN

Documento : MANUAL DE CONFIGURACIÓN DE COLA DE MENSAJES.

Destinatario: TOCUMEN

Autores: Verónica Jardim

Fecha : Abril 2012

Observaciones



1. INTROCUCCION

1.1 PROPÓSITO

Este manual tiene como propósito orientar al lector en la configuración de una cola de mensajes cuyo fin consiste en gestionar y llevar un control sobre el flujo y estatus en la petición de mensajes que son consumidos por servicios.

A continuación se mostrara paso a paso como realizar dicha configuración desde el Weblogic.



2. CONFIGURANDO LA COLA DE MENSAJES

Diríjase a la consola administrativa de Weblogic Server (http://url:puerto/console) e ingrese usando el usuario Weblogic o un usuario con privilegios administrativos:

Ilustración 1 - Ingresando a la consola administrativa de Weblogic Server



Al entrar a la consola administrativa observara una pantalla como la que se muestra a continuación.

Ilustración 2 - Página de inicio del Weblogic Server



2.1 GENERANDO UNA COLA DE MENSAJES EN EL WEBLOGIC

Diríjase a la sección Estructura de Dominio/Servicios/ Mensajes/Servidores JMS. Pulse el botón nuevo para generar un nuevo servidor JMS.

Ilustración 3 - Servidores JMS



Ingrese el nombre del servidor JMS:JMSServer_tracelogy luego pulse siguiente.

Ilustración 4 - Configurando servidor JMS

Seleccione como destino el servidor osb_server1 y pulse terminar.

Ilustración 5 - Seleccionando destino de servidor JMS



Diríjase a la sección de Estructura de Dominio/Servicios/Mensajes/Módulos JMS.

Haga click en el botón nuevo para crear el modulo JMS.

Ilustración 6 - Pantalla de Módulos JMS

Ingrese el nombre del Módulo JMS: TRACE_LOG_MODULE y pulse siguiente.

Ilustración 7– Configurando un módulo JMS.



Observará una pantalla donde le solicitara el servidor o cluster que utilizara el modulo del sistema JMS. Seleccione la opción osb_server1 y pulse siguiente

Ilustración 8–Seleccionando destinos para el módulo del sistema JMS.



Seleccione la opción que dice: ¿Desea agregar recursos a este módulo de sistema JMS? Y haga Click en terminar.

Ilustración 9 - Consulta para la creación del módulo de sistema JMS.

Encontrará una pantalla como la se muestra a continuación, pulse el botón Nuevo para generar un nuevo recurso.

Ilustración 10 - Generando nuevos recursos de módulos de sistema JMS.



Se encontrara con una lista de opciones, seleccione la opción fábrica de conexiones y pulse siguiente.

Ilustración 11 - Configuración de Fábrica de mensajes en el módulo de sistema JMS.

Se le solicitaran los datos requeridos para generar el recurso. Para ello ingrese el nombre de la fábrica de conexiones y el del JDNI con los siguientes nombres:

Nombre: CONNECTION_FACTORY_TRACE_LOG

Nombre de JNDI: CF1

Pulse siguiente para continuar.



Ilustración 12 - Ingreso de datos de configuración en la fábrica de mensajes, módulo JMS.

Seleccione como servidor destino OSB_server1.

Ilustración 13 - Seleccionando destino para la fábrica de mensajes, módulo JMS.

Una vez realizado dichos pasos le aparecerá un mensaje notificando la activación de todos los cambios, mostrando así la fábrica de conexiones que se ha creado.



Pulse el botón Nuevo.

Ilustración 14 - Pantalla de recursos generados en los módulos JMS.

Se volverá a mostrar la lista de opciones, esta vez seleccione la opción Cola como se muestra a continuación y pulse siguiente para continuar.

Ilustración 15 - Generando una Cola en el módulo del sistema JMS.



En las propiedades de destino de JMS ingrese los siguientes datos

Nombre: QUEUE_TRACE_LOG

Nombre de JNDI: QUEUE1.

Pulse siguiente para continuar.

Ilustración 16 - Ingreso de datos para la cola en el módulo del sistema JMS.



Se le solicitara un despliegue secundario, pulse el botón Crear Nuevo despliegue secundario.

Ilustración 17 - Creación de despliegues secundarios en el módulo del sistema JMS.

Ingrese el nombre de despliegue secundario: TRACE_LOG_SUBDEPLOYMENT y pulse el botón aceptar.

Ilustración 18 – Ingresando nombre del despliegue secundario.



En la siguiente pantalla se le solicitara un destino de despliegue secundario, seleccione JMSServer_tracelog y pulse el botón terminar.

Ilustración 19 - Seleccionando el servidor destino en el despliegue secundario del módulo JMS.



2.2 GENERANDO UN PROYECTO SERVICE BUS DESDE ECLIPSE

Una vez culminado dichos pasos diríjase al eclipse y genere un nuevo proyecto de tipo OSB Configuration, dentro de él genere uno de tipo Oracle Service bus Project y pulse siguiente.

Ilustración 20 - Pantalla de Eclipse, generando un Oracle Service Bus Project.



Se le solicitara el nombre del proyecto, ingrese el nombre que desee agregar y pulse finalizar.

Ilustración 21 - Generando el nombre del proyecto service bus.

Se mostrara unas carpetas del lado lateral izquierdo como se muestra en la imagen.

Ilustración 22 - Pantalla con el proyecto generado en el eclipse.



Haga click derecho sobre el nuevo proyecto OSB y genere un nuevo business service.

Ilustración 23 - Generando un business service en el Eclipse.

Ingrese el nombre que desee darle y pulse finalizar como se muestra a continuación.

Ilustración 24 - Pantalla del Wizard para darle el nombre al Business Service que se generara.



Se encontrara el business service generado compuesto por varias pestañas ubicadas en la parte inferior. De la pestaña General seleccione la opción Messaging Service como se muestra a continuación.

Ilustración 25 - Pantalla del business service en la pestaña General para la configuración de la cola de mensajes.



Diríjase a la pestaña Messaging, se encontrara con dos secciones denominadas Request Message Type y Response Message Type, seleccione para la sección Request Message Type la opción XML y para Response Message Type la Opcion None

Ilustración 26 - Pantalla del business service en la pestaña Messaging para la configuración de la cola de mensajes.



Diríjase a la pestaña Transport. Ingrese los siguientes datos por cada una de las secciones como se detalla.

Protocol: jms

Load Balancing Algorithm: round-robin

Endpoint URI: jms://localhost:8011/CF1/QUEUE1.

Ilustración 27 - Pantalla del business service en la pestaña Transport para la configuración de la cola de mensajes.

Nota: mientras no pulse el botón Add la pantalla arrojará un error solicitando la dirección, se quitara en cuanto lo agregue a la lista de Endpoint URI pulsando el botón Add que se muestra en el lado derecho de la pantalla.



Ilustración 28 - Pantalla del business service en la pestaña Transport para la configuración de la cola de mensajes.

Diríjase a la pantalla JMS Transport y seleccione las siguientes opciones por cada sección:

Destination Type: Queue

Message Type: Text

Response Queues: None



Ilustración 29 - Pantalla del businessservice en la pestaña JMS Transport para la configuración de la cola de mensajes.



En la pantalla MessageHandling no se le solicitará ingresar datos.

Ilustración 30 - Pantalla del businessservice en la pestaña MessageHandling para la configuración de la cola de mensajes.

Proceda a exportar el business service, para ello diríjase a la carpeta OSB y haga click derecho sobre ella, seleccione la opción Export seguido de Oracle Service Bus – Configuration Jar.

Ilustración 31 - Exportando un proyecto a un .Jar



Ubique la ruta donde desee guardar el .jar haga click en finalizar.

Ilustración 32 - Pantalla del Wizard para finalizar la exportación del proyecto.



2.3 IMPORTANDO EL PROYECTO AL ORACLE SERVICE BUS

Al culminar la exportación del proyecto diríjase al Oracle Service Bus Weblogic e inicie sesión.

Ilustración 33 - Pantalla de inicio de sesión en el Oracle Service Bus.

Diríjase al botón Crear, observara una pantalla con una tabla donde se detalla un historial de cambios realizados en los despliegues previamente generados.

Ilustración 34 - Creando una sesión para el despliegue.



Proceda a activar una sesión de cambios para desplegar el servicio creado pulsando el botón Activar.

Ilustración 35 - Activando una sesión para control de cambios en los despliegues.



Una vez activa la sesión diríjase a la opción Administración del Sistema.

Ilustración 36 - Ingresando a la Administración del sistema.

Se encontrara una pantalla para importar recursos, pulse el botón de seleccionar archivo y ubique el .jardel proyecto previamente generado y luego pulse el botón siguiente.

Ilustración 37 - Importando el proyecto service bus generado.



Se mostrara una pantalla con el nombre del proyecto generado previamente, pulse el botón Importar.

Ilustración 38 - Pantalla donde se muestra el nombre del proyecto que se va a importar al Weblogic.

Observara el servicio desplegado y un mensaje que indica que se ha realizado la importación de forma correcta.

Ilustración 39 - Pantalla donde se muestra el businessservice una vez desplegado.



Al haber terminado la importación del proyecto, diríjase a la sección de Explorador de Proyectos que se encuentra en la parte inferior izquierda de la pantalla y seleccione el proyecto generado anteriormente. Se mostrara el Business Service, para probarlo pulse el botón del insecto denominado consola de prueba que se encuentra al lado del servicio en la sección de Acciones en la tabla.

Ilustración 40– Ejecutando pruebas de un Business service.

Ingrese un mensaje de control de despliegue y pulse el botón Ejecutar.



Ilustración 41 - Ingresando un mensaje para la ejecución del businessservice.

Una vez ejecutado el servicio, diríjase al administrador del Weblogic y ubíquese en la Estructura de Dominio y seleccione la opción de Servicios seguido de Modulos JMS. Haga click sobre el módulo TRACE_LOG_MODULE, se encontrara con una tabla de los recursos creados, haga click sobre el Recurso de cola denominado QUEUE_TRACE_LOG y diríjase a la pestaña supervisión.

Ilustración 42 - Pantalla donde se muestra los valores recibidos en la cola de mensajes.



Aquí usted podrá observar los mensajes que se han mandado a través del servicio. Para visualizarlos haga click en el botón Mostrar Mensajes observara el detalle de lo que ha recibido la cola de mensajes.

Ilustración 43 - Pantalla con el resumen de mensajes de JMS.



2.4 GENERANDO UN PROYECTO DE AUDITORÍA DESDE JDEVELOPER

Una vez que se haya chequeado que la cola haya recibido el mensaje generado por el servicio, diríjase al JDeveloper y genere un proyecto de tipo EJB denominado QUEUEWRITER, importe el proyecto ESB_QUEUEWRITER, en el caso de no tenerlo genere una estructura con diferentes paquetes como se detalla a continuación.

Genere uno principal denominado queue, y dentro de él genere otros paquetes con los siguientes nombres: dao, dto y mdb. Para el paquete dao y dto genere unas clases denominadas Auditoria seguidos del nombre del paquete salvo mdb que se mostrara más adelante.

Ilustración 44 - Pantalla donde se muestran los paquetes generados para la auditoria del mensaje en el JDeveloper.

Para la clase AuditoriaDAO.java establezca la conexión del EJB con la base de datos que será utilizada y para la clase AuditoriaDTO.java declare el detalle del objeto que intervendrá en la interacción del mensaje que será almacenado en la base de datos. Para el paquete mdb, genere una clase de tipo Message – DrivenBean y dentro de ella ingrese estas líneas como parámetros de conexión con la cola de mensajes.

@MessageDriven(activationConfig =

{ @ActivationConfigProperty(propertyName = "destinationType",

propertyValue = "javax.jms.Queue"),

@ActivationConfigProperty(propertyName = "CONNECTION_FACTORY_TRACE_LOG",

propertyValue = "CF1") },

mappedName = "QUEUE1");



Ilustración 45 - Ingresando los parámetros de conexión con la cola de mensajes en el MDB.

2.5 DESPLEGANDO EL PROYECTO DE AUDITORIA AL WEBLOGIC SERVER

Una vez que haya realizado la comunicación del EJB con los diferentes componentes que estructuran el encapsulamiento del mensaje a través del mdb hacia el dao para su posterior almacenamiento en la base de datos proceda a exportar dicho proyecto para ser desplegado en el administrador del Weblogic.



Ilustración 46 - Pantalla con el despliegue el del proyecto del MDB en el administrador del Weblogic.

Vuelva a probar el servicio pasándole un mensaje como se muestra en la ilustración 40 y chequee en su consola donde está corriendo el servicio que se haya recibido el mensaje.

Ilustración 47 - Mostrando el mensaje generado desde el businessservice en la consola donde se está ejecutando el servicio.

De esta manera se puede comprobar que se estableció una correcta comunicación de la cola de mensajes y con esto finalizamos dicha configuración.


Manual de Configuracion Cola de Mensajes Docx

Documents

Transcript of Manual de Configuracion Cola de Mensajes Docx