Manual de Configuracion Cola de Mensajes

MANUAL COLA DE MENSAJES
MANUAL
DE
CONFIGURACIN PARA
REALIZAR UNA COLA DE
MENSAJES.
Ciudad de Panam, Abril 2012
ELABORADO
Por: Vernica Jardim
APROBADO
Por:
Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

permiso escrito de la Compaa.
TABLA DE CONTENIDOS
1.
INTROCUCCION.......................................................................6
1.1
2.
Pg.
PROPSITO..................................................................................6
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 AUDITORA DESDE JDEVELOPER.............36
2.5
DESPLEGANDO EL PROYECTO DE AUDITORIA AL WEBLOGIC SERVER.......37

NDICE DE ILUSTRACIONES:
Ilustracin 1 - Ingresando al Weblogic Server....................................................................7
Ilustracin 2 - Pgina de inicio del Weblogic Server...........................................................8
Ilustracin 3 - Servidores JMS............................................................................................ 9
Ilustracin 4 - Configurando servidor JMS........................................................................10
Ilustracin 5 - Seleccionando destino de servidor JMS.....................................................10
Ilustracin 6 - Pantalla de Mdulos JMS..........................................................................11
Ilustracin 7 Configurando un mdulo JMS...................................................................11
Ilustracin 8 Seleccionando destinos para el mdulo del sistema JMS..........................12
Ilustracin 9 - Consulta para la creacin del mdulo de sistema JMS..............................13
Ilustracin 10 - Generando nuevos recursos de mdulos de sistema JMS.......................13
Ilustracin 11 - Configuracin de Fbrica de mensajes en el mdulo de sistema JMS.....14
Ilustracin 12 - Ingreso de datos de configuracin en la fbrica de mensajes, mdulo
JMS................................................................................................................................... 15
Ilustracin 13 - Seleccionando destino para la fbrica de mensajes, mdulo JMS...........15
Ilustracin 14 - Pantalla de recursos generados en los mdulos JMS...............................16
Ilustracin 15 - Generando una Cola en el mdulo del sistema JMS................................16
Ilustracin 16 - Ingreso de datos para la cola en el mdulo del sistema JMS..................17
Ilustracin 17 - Creacin de despliegues secundarios en el mdulo del sistema JMS......18
Ilustracin 18 Ingresando nombre del despliegue secundario.......................................18
Ilustracin 19 - Seleccionando el servidor destino en el despliegue secundario del mdulo
JMS................................................................................................................................... 19
Ilustracin 20 - Pantalla de Eclipse, generando un Oracle Service Bus Project................20
Ilustracin 21 - Generando el nombre del proyecto service bus.......................................21
Ilustracin 22 - Pantalla con el proyecto generado en el eclipse......................................21
Ilustracin 23 - Generando un bussines service en el Eclipse..........................................22
Ilustracin 24 - Pantalla del Wizard para darle el nombre al Bussines Service que se
generara........................................................................................................................... 22
Ilustracin 25 - Pantalla del bussines service en la pestaa General para la configuracin
de la cola de mensajes..................................................................................................... 23
Ilustracin 26 - Pantalla del bussines service en la pestaa Messaging para la
configuracin de la cola de mensajes...............................................................................24
Ilustracin 27 - Pantalla del bussines service en la pestaa Transport para la
Ilustracin 28 - Pantalla del bussines service en la pestaa Transport para la
Ilustracin 29 - Pantalla del bussines service en la pestaa JMS Transport para la
Ilustracin 30 - Pantalla del bussines service en la pestaa Message Handling para la
Ilustracin 31 - Exportando un proyecto a un .Jar...........................................................28
Ilustracin 32 - Pantalla del Wizard para finalizar la exportacin del proyecto.................29
Ilustracin 33 - Pantalla de inicio de sesin en el Oracle Service Bus..............................30
Ilustracin 34 - Creando una sesin para el despliegue...................................................31
Ilustracin 35 - Activando una sesin para control de cambios en los despliegues..........31
Ilustracin 36 - Ingresando a la Administracin del sistema............................................32
Ilustracin 37 - Importando el proyecto service bus generado........................................32
Ilustracin 38 - Pantalla donde se muestra el nombre del proyecto que se va a importar
al Weblogic....................................................................................................................... 33

Ilustracin 39 - Pantalla donde se muestra el bussines service una vez desplegado.......33

Ilustracin 40 Ejecutando pruebas de un Bussines service...........................................34
Ilustracin 41 - Ingresando un mensaje para la ejecucin del bussines service..............34
Ilustracin 42 - Pantalla donde se muestra los valores recibidos en la cola de mensajes.
......................................................................................................................................... 35
Ilustracin 43 - Pantalla con el resumen de mensajes de JMS.........................................35
Ilustracin 44 - Pantalla donde se muestran los paquetes generados para la auditoria del
mensaje en el JDeveloper................................................................................................. 36
Ilustracin 45 - Ingresando los parmetros de conexin con la cola de mensajes en el
MDB.................................................................................................................................. 37
Ilustracin 46 - Pantalla con el despliegue el del proyecto del MDB en el administrador del
Weblogic........................................................................................................................... 38
Ilustracin 47 - Mostrando el mensaje generado desde el bussines service en la consola
donde se est ejecutando el servicio................................................................................38
DATOS IDENTIFICATIVOS DEL DOCUMENTO
Proyecto :
ESB TOCUMEN PANAM
Cliente :
AEROPUERTO INTERNACIONAL DE TOCUMEN
Documento :
MANUAL DE CONFIGURACIN DE COLA DE MENSAJES.
Destinatario:
TOCUMEN
Autores:
Vernica Jardim
Fecha :
Abril 2012
Observaciones


1. INTROCUCCION
1.1 PROPSITO
Este manual tiene como propsito orientar al lector en la configuracin de una
cola de mensajes cuyo fin consiste en gestionar y llevar un control sobre el flujo y estatus
en la peticin de mensajes que son consumidos por servicios.
A continuacin se mostrara paso a paso como realizar dicha configuracin desde el
Weblogic.

2. CONFIGURANDO LA COLA DE MENSAJES

Dirjase a la consola administrativa de Weblogic Server (http://url:puerto/console)
e ingrese usando el usuario Weblogic o un usuario con privilegios administrativos:
Ilustracin 1 - Ingresando a la consola administrativa de Weblogic Server

Al entrar a la consola administrativa observara una pantalla como la que se

muestra a continuacin.
Ilustracin 2 - Pgina de inicio del Weblogic Server

2.1 GENERANDO UNA COLA DE MENSAJES EN EL WEBLOGIC

Dirjase a la seccin Estructura de Dominio/Servicios/ Mensajes/Servidores
JMS. Pulse el botn nuevo para generar un nuevo servidor JMS.
Ilustracin 3 - Servidores JMS

Ingrese el nombre del servidor JMS:JMSServer_tracelogy luego pulse siguiente.
Ilustracin 4 - Configurando servidor JMS
Seleccione como destino el servidor osb_server1 y pulse terminar.
Ilustracin 5 - Seleccionando destino de servidor JMS

JMS.
Dirjase a la seccin de Estructura de Dominio/Servicios/Mensajes/Mdulos
Haga click en el botn nuevo para crear el modulo JMS.
Ilustracin 6 - Pantalla de Mdulos JMS
Ingrese el nombre del Mdulo JMS: TRACE_LOG_MODULE y pulse siguiente.
Ilustracin 7 Configurando un mdulo JMS.

Observar una pantalla donde le solicitara el servidor o cluster que utilizara el modulo del
sistema JMS. Seleccione la opcin osb_server1 y pulse siguiente
Ilustracin 8Seleccionando destinos para el mdulo del sistema JMS.

Seleccione la opcin que dice: Desea agregar recursos a este mdulo de sistema JMS? Y
haga Click en terminar.
Ilustracin 9 - Consulta para la creacin del mdulo de sistema JMS.
Encontrar una pantalla como la se muestra a continuacin, pulse el botn Nuevo para
generar un nuevo recurso.
Ilustracin 10 - Generando nuevos recursos de mdulos de sistema JMS.
Se encontrara con una lista de opciones, seleccione la opcin fbrica de

conexiones y pulse siguiente.

Ilustracin 11 - Configuracin de Fbrica de mensajes en el mdulo de sistema JMS.
Se le solicitaran los datos requeridos para generar el recurso. Para ello ingrese el nombre
de la fbrica de conexiones y el del JDNI con los siguientes nombres:
Nombre: CONNECTION_FACTORY_TRACE_LOG
Nombre de JNDI: CF1
Pulse siguiente para continuar.

Ilustracin 12 - Ingreso de datos de configuracin en la fbrica de mensajes, mdulo JMS.
Seleccione como servidor destino OSB_server1.
Ilustracin 13 - Seleccionando destino para la fbrica de mensajes, mdulo JMS.
Una vez realizado dichos pasos le aparecer un mensaje notificando la activacin de

todos los cambios, mostrando as la fbrica de conexiones que se ha creado.

Pulse el botn Nuevo.
Ilustracin 14 - Pantalla de recursos generados en los mdulos JMS.
Se volver a mostrar la lista de opciones, esta vez seleccione la opcin Cola como se
muestra a continuacin y pulse siguiente para continuar.
Ilustracin 15 - Generando una Cola en el mdulo 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.
Ilustracin 16 - Ingreso de datos para la cola en el mdulo del sistema JMS.

Se le solicitara un despliegue secundario, pulse el botn Crear Nuevo despliegue

secundario.
Ilustracin 17 - Creacin de despliegues secundarios en el mdulo del sistema JMS.
Ingrese el nombre de despliegue secundario: TRACE_LOG_SUBDEPLOYMENT y

pulse el botn aceptar.
Ilustracin 18 Ingresando nombre del despliegue secundario.

En la siguiente pantalla se le solicitara un destino de despliegue secundario,

seleccione JMSServer_tracelog y pulse el botn terminar.
Ilustracin 19 - Seleccionando el servidor destino en el despliegue secundario del mdulo JMS.

2.2 GENERANDO UN PROYECTO SERVICE BUS DESDE ECLIPSE

Una vez culminado dichos pasos dirjase 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.
Ilustracin 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.
Ilustracin 21 - Generando el nombre del proyecto service bus.
Se mostrara unas carpetas del lado lateral izquierdo como se muestra en la imagen.
Ilustracin 22 - Pantalla con el proyecto generado en el eclipse.
Haga click derecho sobre el nuevo proyecto OSB y genere un nuevo business service.

Ilustracin 23 - Generando un business service en el Eclipse.
Ingrese el nombre que desee darle y pulse finalizar como se muestra a continuacin.
Ilustracin 24 - Pantalla del Wizard para darle el nombre al Business Service que se generara.

Se encontrara el business service generado compuesto por varias pestaas

ubicadas en la parte inferior. De la pestaa General seleccione la opcin Messaging
Service como se muestra a continuacin.
Ilustracin 25 - Pantalla del business service en la pestaa General para la configuracin de la cola
de mensajes.

Dirjase a la pestaa Messaging, se encontrara con dos secciones denominadas

Request Message Type y Response Message Type, seleccione para la seccin Request
Message Type la opcin XML y para Response Message Type la Opcion None
Ilustracin 26 - Pantalla del business service en la pestaa Messaging para la configuracin de la

cola de mensajes.

Dirjase a la pestaa 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.
Ilustracin 27 - Pantalla del business service en la pestaa Transport para la configuracin de la

cola de mensajes.
Nota: mientras no pulse el botn Add la pantalla arrojar un error solicitando la direccin,
se quitara en cuanto lo agregue a la lista de Endpoint URI pulsando el botn Add que se
muestra en el lado derecho de la pantalla.

Ilustracin 28 - Pantalla del business service en la pestaa Transport para la configuracin de la

cola de mensajes.
Dirjase a la pantalla JMS Transport y seleccione las siguientes opciones por cada seccin:
Destination Type: Queue
Message Type: Text
Response Queues: None
Ilustracin 29 - Pantalla del businessservice en la pestaa JMS Transport para la configuracin de la

cola de mensajes.

En la pantalla MessageHandling no se le solicitar ingresar datos.
Ilustracin 30 - Pantalla del businessservice en la pestaa MessageHandling para la configuracin

de la cola de mensajes.
Proceda a exportar el business service, para ello dirjase a la carpeta OSB y haga
click derecho sobre ella, seleccione la opcin Export seguido de Oracle Service Bus
Configuration Jar.
Ilustracin 31 - Exportando un proyecto a un .Jar

Ubique la ruta donde desee guardar el .jar haga click en finalizar.
Ilustracin 32 - Pantalla del Wizard para finalizar la exportacin del proyecto.

2.3 IMPORTANDO EL PROYECTO AL ORACLE SERVICE BUS

Al culminar la exportacin del proyecto dirjase al Oracle Service Bus Weblogic e inicie
sesin.
Ilustracin 33 - Pantalla de inicio de sesin en el Oracle Service Bus.
Dirjase al botn Crear, observara una pantalla con una tabla donde se detalla un
historial de cambios realizados en los despliegues previamente generados.
Ilustracin 34 - Creando una sesin para el despliegue.
Proceda a activar una sesin de cambios para desplegar el servicio creado

pulsando el botn Activar.

Ilustracin 35 - Activando una sesin para control de cambios en los despliegues.

Una vez activa la sesin dirjase a la opcin Administracin del Sistema.
Ilustracin 36 - Ingresando a la Administracin del sistema.
Se encontrara una pantalla para importar recursos, pulse el botn de seleccionar

archivo y ubique el .jardel proyecto previamente generado y luego pulse el botn
siguiente.
Ilustracin 37 - Importando el proyecto service bus generado.
Se mostrara una pantalla con el nombre del proyecto generado previamente, pulse el
botn Importar.

Ilustracin 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

importacin de forma correcta.
Ilustracin 39 - Pantalla donde se muestra el businessservice una vez desplegado.
Al haber terminado la importacin del proyecto, dirjase a la seccin 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 botn del insecto denominado consola de prueba que se encuentra al lado del servicio
en la seccin de Acciones en la tabla.

Ilustracin 40 Ejecutando pruebas de un Business service.
Ingrese un mensaje de control de despliegue y pulse el botn Ejecutar.
Ilustracin 41 - Ingresando un mensaje para la ejecucin del businessservice.
Una vez ejecutado el servicio, dirjase al administrador del Weblogic y ubquese en

la Estructura de Dominio y seleccione la opcin de Servicios seguido de Modulos JMS.
Haga click sobre el mdulo TRACE_LOG_MODULE, se encontrara con una tabla de los
recursos creados, haga click sobre el Recurso de cola denominado QUEUE_TRACE_LOG y
dirjase a la pestaa supervisin.

Ilustracin 42 - Pantalla donde se muestra los valores recibidos en la cola de mensajes.
Aqu usted podr observar los mensajes que se han mandado a travs del
servicio. Para visualizarlos haga click en el botn Mostrar Mensajes observara el detalle
de lo que ha recibido la cola de mensajes.
Ilustracin 43 - Pantalla con el resumen de mensajes de JMS.

2.4 GENERANDO
JDEVELOPER
UN
PROYECTO
DE
AUDITORA
DESDE
Una vez que se haya chequeado que la cola haya recibido el mensaje generado por el
servicio, dirjase 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 continuacin.
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 ms adelante.
Ilustracin 44 - Pantalla donde se muestran los paquetes generados para la auditoria del mensaje
en el JDeveloper.
Para la clase AuditoriaDAO.java establezca la conexin 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 interaccin 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 lneas como parmetros de conexin con la cola de mensajes.
@MessageDriven(activationConfig =
{ @ActivationConfigProperty(propertyName = "destinationType",
propertyValue = "javax.jms.Queue"),
@ActivationConfigProperty(propertyName = "CONNECTION_FACTORY_TRACE_LOG",
propertyValue = "CF1") },
mappedName = "QUEUE1");

Ilustracin 45 - Ingresando los parmetros de conexin con la cola de mensajes en el MDB.
2.5 DESPLEGANDO EL PROYECTO DE AUDITORIA AL

SERVER
WEBLOGIC
Una vez que haya realizado la comunicacin del EJB con los diferentes
componentes que estructuran el encapsulamiento del mensaje a travs 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.
Ilustracin 46 - Pantalla con el despliegue el del proyecto del MDB en el administrador del Weblogic.
Vuelva a probar el servicio pasndole un mensaje como se muestra en la

ilustracin 40 y chequee en su consola donde est corriendo el servicio que se haya
recibido el mensaje.

Ilustracin 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 comunicacin

de la cola de mensajes y con esto finalizamos dicha configuracin.


Manual de Configuracion Cola de Mensajes

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Manual de Configuracion Cola de Mensajes

Uploaded by

Copyright:

Available Formats

MANUAL COLA DE MENSAJES

Ciudad de Panam, Abril 2012

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

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

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

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

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

GENERANDO UN PROYECTO DE AUDITORA DESDE JDEVELOPER.............36

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

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Ilustracin 39 - Pantalla donde se muestra el bussines service una vez desplegado.......33

DATOS IDENTIFICATIVOS DEL DOCUMENTO

ESB TOCUMEN PANAM

AEROPUERTO INTERNACIONAL DE TOCUMEN

MANUAL DE CONFIGURACIN DE COLA DE MENSAJES.

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

2. CONFIGURANDO LA COLA DE MENSAJES

Ilustracin 1 - Ingresando a la consola administrativa de Weblogic Server

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Al entrar a la consola administrativa observara una pantalla como la que se

Ilustracin 2 - Pgina de inicio del Weblogic Server

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

2.1 GENERANDO UNA COLA DE MENSAJES EN EL WEBLOGIC

Ilustracin 3 - Servidores JMS

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

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

Ilustracin 4 - Configurando servidor JMS

Seleccione como destino el servidor osb_server1 y pulse terminar.

Ilustracin 5 - Seleccionando destino de servidor JMS

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Dirjase a la seccin de Estructura de Dominio/Servicios/Mensajes/Mdulos

Haga click en el botn nuevo para crear el modulo JMS.

Ilustracin 6 - Pantalla de Mdulos JMS

Ingrese el nombre del Mdulo JMS: TRACE_LOG_MODULE y pulse siguiente.

Ilustracin 7 Configurando un mdulo JMS.

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Ilustracin 8Seleccionando destinos para el mdulo del sistema JMS.

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Ilustracin 9 - Consulta para la creacin del mdulo de sistema JMS.

Ilustracin 10 - Generando nuevos recursos de mdulos de sistema JMS.

Se encontrara con una lista de opciones, seleccione la opcin fbrica de

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Ilustracin 11 - Configuracin de Fbrica de mensajes en el mdulo de sistema JMS.

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Ilustracin 12 - Ingreso de datos de configuracin en la fbrica de mensajes, mdulo JMS.

Seleccione como servidor destino OSB_server1.

Ilustracin 13 - Seleccionando destino para la fbrica de mensajes, mdulo JMS.

Una vez realizado dichos pasos le aparecer un mensaje notificando la activacin de

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Pulse el botn Nuevo.

Ilustracin 14 - Pantalla de recursos generados en los mdulos JMS.

Ilustracin 15 - Generando una Cola en el mdulo del sistema JMS.

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

En las propiedades de destino de JMS ingrese los siguientes datos

Ilustracin 16 - Ingreso de datos para la cola en el mdulo del sistema JMS.

Documento confidencial. Prohibida su reproduccin y la transmisin de su informacin, sin el

Se le solicitara un despliegue secundario, pulse el botn Crear Nuevo despliegue

Ilustracin 17 - Creacin de despliegues secundarios en el mdulo del sistema JMS.

Ingrese el nombre de despliegue secundario: TRACE_LOG_SUBDEPLOYMENT y

Ilustracin 18 Ingresando nombre del despliegue secundario.