Home

JBoss Enterprise Application Platform 5 Manual del usuario de

Contents

1. lt attribute name serverSocketClass gt org jboss jms server remoting ServerSocketwrapper lt attr ibute gt lt attribute name OonewayThreadPool gt org jboss jms server remoting DirectThreadPool lt attribut e gt lt the following parameters are useful when there is a firewall between client and server Uncomment them if so gt ioe lt attribute name numberOfCallRetries isParam true gt 1 lt attribute gt lt attribute name pingFrequency isParam true gt 214748364 lt attribute gt lt attribute name pingWindowFactor isParam true gt 10 lt attribute gt lt attribute name generalizeSocketException isParam true gt true lt attribute gt ses lt Now remoting supports socket write timeout configuration Uncomment this if you need it gt lt lt attribute name writeTimeout isParam true gt 30000 lt attribute gt sas lt End immutable parameters gt lt attribute name stopLeaseOnFailure isParam true gt true lt attribute gt Cap tulo 5 Configuraci n lt Periodicity of client pings Server window by default is twice this figure gt lt attribute name clientLeasePeriod isParam true gt 10000 lt attribute gt lt attribute name validatorPingPeriod isParam true gt 10000 lt attribute gt lt attribute name validatorPingTimeout isParam true gt 5000 lt attribute gt lt attribute name failureDisconnectTimeout isParam true gt 0 lt attribute gt
2. Cap tulo 2 Introducci n JBoss Messaging proporciona una plataforma de mensajer a de c digo abierto y con base en los est ndares para traer la mensajer a de clase empresarial al mercado en masa JBoss Messaging implementa un n cleo de mensajes de alto rendimiento y robusto que est dise ado para soportar la arquitectura orientada a servicios en ingl s Service Oriented Architectures o SOAs ESBs del ingl s Enterprise Service Buses y otras requerimientos de integraci n sin importar el nivel de demanda JBoss Messaging le permite distribuir la carga de la aplicaci n de manera equitativa a trav s del cl ster Balancea los ciclos de la CPU de cada nodo sin ning n punto de fallo proporcionando una implementaci n en cl ster altamente escalable y con un alto rendimiento JBoss Messaging incluye un servicio de mensajer a Java JMS del ingl s Java Messaging Service de manera que los mensajes se entregan en un formato basado en los est ndares y para habilitar el soporte para otros protocolos de mensajer a en el futuro 2 1 Caracter sticas de JBoss Messaging JBoss Messaging proporciona las siguientes funcionalidades Un fuerte enfoque en el rendimiento confiabilidad y escalabilidad con un alto rendimiento y baja latencia Una base para JBoss ESB para las iniciativas SOA JBoss ESB usa JBoss Messaging como su proveedor JMS predeterminado JBoss Messaging tambi n incluye Modelos de mensajer a punto a punto y pub
3. E redhat JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging para uso con JBoss Enterprise Application Platform 5 Edici n 5 1 0 Tim Fox Jeff Mesnil Andy Taylor Clebert Suconic Howard Gao JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging para uso con JBoss Enterprise Application Platform 5 Edici n 5 1 0 Tim Fox Jeff Mesnil Andy Taylor Clebert Suconic Howard Gao Edited by Laura Bailey Jared Morgan Legal Notice Copyright O 2011 Red Hat Inc This document is licensed by Red Hat under the Creative Commons Attribution ShareAlike 3 0 Unported License If you distribute this document or a modified version of it you must provide attribution to Red Hat Inc and provide a link to the original If the document is modified all Red Hat trademarks must be removed Red Hat as the licensor of this document waives the right to enforce and agrees not to assert Section 4d of CC BY SA to the fullest extent permitted by applicable law Red Hat Red Hat Enterprise Linux the Shadowman logo JBoss MetaMatrix Fedora the Infinity Logo and RHCE are trademarks of Red Hat Inc registered in the United States and other countries Linux is the registered trademark of Linus Torvalds in the United States and other countries Java is a registered trademark of Oracle and or its affiliates XFS 0 is a trademark of Silicon Graphics International Corp or its subsidiaries
4. Utilizado para destruir program ticamente un tema Se borra la implementaci n de los temas y todos los datos se borran de la base de datos y se destruyen Esta operaci n retorna true si el tema fue destru do exit samente De otra forma retorna false Y WIN Tenga cuidado al utilizar este m todo ya que borrar todos los datos para el tema listMessageCountersHTML Retorna contadores de mensajes en un formato HT ML de f cil presentaci n ResetAllMesageCounters Reestablece todos los contadores de mensajes a cero enableMessageCounters Habilita todos los contadores de mensajes para todos los destinos Los contadores de mensajes est n desactivados por defecto 21 22 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging disableMessageCounters Inactiva todos los contadores de mensajes para todos los destinos Los contadores de mensajes est n desactivados por defecto retrievePreparedTransactions Recupera una lista de los XIDs para todas las transacciones actualmente en un estado preparado en el nodo showPreparedTransactions Recupera una lista de los XIDs para todas las transacciones actualmente en un estado preparado en el nodo en un formato HT ML de f cil presentaci n listAllPreparedTransactions Presenta los detalles de todas las transacciones preparadas listPreparedTransactions Presenta los detalles de todas las transacciones preparadas en donde la edad de la transacci n sea ig
5. lt attribute name callbackErrorsAllowed gt 1 lt attribute gt lt attribute name registerCallbackListener gt false lt attribute gt lt attribute name useClientConnectionIdentity isParam true gt true lt attribute gt lt attribute name timeout isParam true gt 0 lt attribute gt lt Max Number of connections in client pool This should be significantly higher than the max number of sessions consumers you expect gt lt attribute name JBM_clientMaxPoolSize isParam true gt 200 lt attribute gt lt The maximum time to wait before timing out on trying to write a message to socket for delivery gt lt attribute name callbackTimeout gt 10000 lt attribute gt lt Use these parameters to specify values for binding and connecting control connections to work with your firewall NAT configuration lt attribute name secondaryBindPort gt xyz lt attribute gt lt attribute name secondaryConnectPort gt abc lt attribute gt sas lt invoker gt lt handlers gt lt handler subsystem JMS gt org jboss jms server remoting JMSServerInvocationHandler lt handle r gt lt handlers gt lt config gt lt attribute gt lt mbean gt lt server gt Hay atributos restringidos que no se deben cambiar a menos de que est completamente seguro de comprender el impacto de los cambios Los siguientes atributos se pueden cambiar de manera segura para configurar los requerimientos de su proyecto cli
6. Texto a copiar y luego haga clic en el bot n Copiar Ahora regrese al documento y elija Modificar Pegar de la barra de men de gedit El texto anterior incluye nombres de aplicaci n nombres y elementos del men de todo el sistema nombres de men de aplicaciones espec ficas y botones y texto hallados dentro de una interfaz gr fica de usuario todos presentados en negrita proporcional y distinguibles por contexto It licas negrita monoespaciado o It licas negrita proporcional Ya sea negrita monoespaciado o negrita proporcional la adici n de it licas indica texto reemplazable o variable Las it licas denotan texto que usted no escribe literalmente o texto mostrado que cambia dependiendo de la circunstancia Por ejemplo Para conectar a una m quina remota utilizando ssh teclee ssh nombre de usuario dominio nombre en un int rprete de comandos de shell Si la m quina remota es example com y su nombre de usuario en esa m quina es john teclee ssh john example com El comando mount o remount file system remonta el sistema de archivo llamado Por ejemplo para volver a montar el sistema de archivo home el comando es mount o remount home Para ver la versi n de un paquete actualmente instalado utilice el comando rpm q paquete ste entregar el resultado siguiente paquete versi n lanzamiento Observe que las palabras resaltadas en italicas nombre de usuario dominio nombre sistema de archivo paquete versi
7. base de datos en un entorno con cl sters Si se configura como true la declaraci n SQL se vuelve a ejecutar en caso de que falle al guardar los cambios Si ocurren m s errores el administrador de persistencia asume que el error se debe a que la transacci n anterior guard los cambios de manera exitosa e ignora el error Por defecto este atributo se establece como false Cuando algunas bases de datos tal como MySQL ejecutan en entornos en cl sters pueden fallar al guardar los cambios de transacciones de la base de datos Si esto ocurre entonces el estado final de la transacci n es desconocido 5 6 Configuraci n del administrador de usuarios de JMS El administrador de usuarios JMS mapea los IDs de clientes pre configurados a los usuarios Tambi n administra las tablas de usuarios y roles dependiendo del m dulo login que ha configurado Este es un ejemplo de la configuraci n del JMSUserManager 31 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging lt mbean code org jboss jms server plugin JDBCJMSUserManagerService name jboss messaging service JMSUserManager xmbean dd xmdesc JMSUserManager xmbean xm1 gt lt depends gt jboss jca service DataSourceBinding name DefaultDS lt depends gt lt depends optional attribute name TransactionManager gt jboss service TransactionManager lt depends gt lt attribute name DataSource gt java DefaultDS lt attribute gt lt attribute na
8. consuma de una cola o tema Cuando el puente consume de un tema se puede configurar para que consuma con una subscripci n durable o no durable El puente se puede configurar para que maneje mensajes con uno de tres niveles de calidad de servicio estos son Niveles de calidad de servicio del puente QOS_AT_MOST_ONCE Este modo especifica que los mensajes alcanzaran su destino maximo una vez Los mensajes se consumen desde la fuente y se reconocen antes de enviarlos al destino Por lo tanto existe la posibilidad de que se pierdan si ocurre una falla desde cuando deja la fuente hasta cuando llegan al destino Por lo tanto la entrega ocurrir maximo una vez Este modo est disponible para mensajes persistentes y no persistentes QOS_DUPLICATES_ OK Este modo especifica que los mensajes se consumen desde la fuente y luego se reconocen despu s de que se han enviado exitosamente a su destino Por lo tanto existe la posibilidad de que si ocurre una falla despu s de enviarlos a su destino pero antes de reconocerlos puede que sean enviados de nuevo cuando el sistema se recupere Este modo esta disponible para mensajes persistentes y no persistentes QOS_ONCE_AND_ONLY_ONCE Este modo especifica que los mensajes llegar n exactamente una vez Cuando la fuente del mensaje y el destino se encuentran en la misma instancia del servidor de JBoss Messaging el mensaje se puede enviar y recibir en la misma transacci n local Si la fuente y el des
9. digo fuente los nombres de las clase los m todos las funciones los nombres de variables y valores de retorno mencionados dentro de un p rrafo ser n presentados en Negrita monoespaciado Por ejemplo Las clases de archivo relacionadas incluyen filename para sistema de archivos file para archivos y dir para directorios Cada clase tiene su propio conjunto asociado de permisos Negrita proporcional Esta denota palabras o frases encontradas en un sistema incluyendo nombres de aplicaci n texto de cuadro de di logo botones etiquetados etiquetas de cajilla de verificaci n y bot n de radio t tulos de men y t tulos del submen Por ejemplo Seleccione Sistema Preferencias Rat n desde la barra del men principal para lanzar Preferencias de rat n En la pesta a de Botones seleccione la cajilla de rat n de mano izquierda y luego haga clic en Cerrar para cambiar el bot n principal del rat n de la izquierda a la derecha adecuando el rat n para la mano izquierda Para insertar un car cter especial en un archivo gedit seleccione Aplicaciones gt Accesorios Mapa de caracteres de la barra del men Luego seleccione B squeda gt Buscar de la barra del men de Mapa de caracteres escriba el nombre del car cter en el campo de B squeda y haga clic en Siguiente El car cter que busc ser Prefacio resaltado en la Tabla de caracteres Haga doble clic en ese car cter resaltado para colocarlo en el campo de
10. esta propiedad por defecto 11 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Cap tulo 3 Instalaci n de JBoss Messaging JBoss Enterprise Application Platform EAP viene junto con JBoss Messaging pre instalado como proveedor JMS predeterminado Si est utilizando EAP versi n 4 3 o posterior no ha necesidad de instalar manualmente JBoss Messaging 12 Cap tulo 4 Ejecuci n de los ejemplos Cap tulo 4 Ejecuci n de los ejemplos JBoss Messaging cuenta con un n mero de ejemplos que est n disponibles para descargar Consulte el Installation Guide que se env a junto con JBoss Enterprise Application Platform para aprender a JBoss Enterprise Application Platform gt 5 0 Descomprima el archivo de ejemplos en el directorio JBOSS_HOME docs examples Antes de ejecutar estos ejemplos implemente el jbm examples destinations service ubicado bajo JBOSS_HOME docs examples jboss messaging examples destinations para JBOSS_HOME server default deploy El Los siguientes ejemplos est n inclu dos con JBoss Messaging JBOSS_HOME docs examples jboss messaging examples queue Este ejemplo demuestra un simple env o y recepci n a una cola remota utilizando un cliente JMS JBOSS_HOME docs examples jboss messaging examples queue failover Este ejemplo demuestra la conmutaci n transparente de un consumidor JMS JBOSS_HOME docs examples jboss messaging examples topic Este ejemplo demuestra un simpl
11. gt lt The default JNDI context to use for queues when they are deployed without specifying one gt lt attribute name DefaultQueueJNDIContext gt queue lt attribute gt lt The default JNDI context to use for topics when they are deployed without specifying one gt lt attribute name DefaultTopicJNDIContext gt topic lt attribute gt lt attribute name PostO0ffice gt jboss messaging service PostOffice lt attribute gt lt The default Dead Letter Queue DLQ to use for destinations This can be overridden on a per destinatin basis gt lt attribute name DefaultDLQ gt jboss messaging destination service Queue name DLQ lt attribute gt lt The default maximum number of times to attempt delivery of a message before sending to the DLQ if configured This can be overridden on a per destination basis gt lt attribute name DefaultMaxDeliveryAttempts gt 10 lt attribute gt lt The default Expiry Queue to use for destinations This can be overridden on a per destinatin basis gt lt attribute name DefaultExpiryQueue gt jboss messaging destination service Queue name Expir yQueue lt attribute gt lt The default redelivery delay to impose This can be overridden on a per destination basis gt lt attribute name DefaultRedeliveryDelay gt 0 lt attribute gt lt The periodicity of the message counter manager enquiring on queues for statistics gt lt attribut
12. in the United States and or other countries MySQL is a registered trademark of MySQL AB in the United States the European Union and other countries Node js O is an official trademark of Joyent Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node js open source or commercial project The OpenStack Word Mark and OpenStack Logo are either registered trademarks service marks or trademarks service marks of the OpenStack Foundation in the United States and other countries and are used with the OpenStack Foundation s permission We are not affiliated with endorsed or sponsored by the OpenStack Foundation or the OpenStack community All other trademarks are the property of their respective owners Abstract Un manual del uso de JBoss Messaging 1 4 con JBoss Enterprise Application Platform 5 0 y sus lanzamientos de parches Table of Contents PIetacio E E E A O fad a ANA dog O ARA ARO dd hued AR A ON RA A e Al foot A cn el A at dd o 1 Convenciones del Documento 1 1 Convenciones tipogr ficas 1 2 Convenciones del documento 1 3 Notas y Advertencias 2 C mo obtener ayuda y hacer sus comentarios 2 1 Necesita ayuda 2 2 Necesitamos sus comentarios Cap tulo 1 Sobre JBoss Messaging 1 4 o ooooccccooc ett eens Cap tulo 2 Introducci n s2c neccdearsa rta aa gales bald Rt a A 2 1 Caracter sticas de JBoss Messaging 2 2 Compatibilidad con JBoss MQ 2 3 Propied
13. inician del lado del cliente Esto significa que es ideal en un escenario de cortafuergos t pico en donde se permiten las conexiones entrantes en el servidor o en donde s lo se permiten las conexiones salientes del cliente El transporte bisocket se puede configurar para utilizar SSL en donde se requiera un mayor nivel de seguridad El otro transporte soportado es el transporte HTTP Este utiliza el protocolo de transferencia Hypertext para la comunicaci n entre cliente y servidor El cliente sondea peri dicamente el servidor en busca de mensajes para recibir datos Este transporte es ideal para situaciones en donde hay un cortafuegos entre el cliente y el servidor lo cual s lo permite tr fico HTTP de entrada en el servidor Este transporte no tiene tanto rendimiento como el transporte bisocket debido a la naturaleza del sondeo y a las limitaciones de HTTP No est dise ado para situaciones con bastante carga JBoss Messaging no soporta actualmente ning n otro transporte remoto Los detalles de configuraci n de Remoting se encuentran en JBOSS_HOME ser ver SERVER deploy messaging remoting bisocket service xml El siguiente c digo es un ejemplo de una configuraci n remota bisocket 46 Ejemplo 5 2 Configuraci n remota bisocket Cap tulo 5 Configuraci n 47 48 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging lt xml version 1 0 encoding UTF 8 gt Elise Standard bisocket based Rem
14. message counters that can be viewed via JMX gt lt attribute name EnableMessageCounters gt false lt attribute gt lt The password used by the message sucker connections to create connections THIS SHOULD ALWAYS BE CHANGED AT INSTALL TIME TO SECURE SYSTEM lt attribute name SuckerPassword gt lt attribute gt gt lt The name of the server aspects configuration resource lt attribute name ServerAopConfig gt aop jboss aop messaging server xml lt attribute gt lt The name of the client aspects configuration resource lt attribute name ClientAopConfig gt aop jboss aop messaging client xml lt attribute gt gt lt depends optional attribute name PersistenceManager gt jboss messaging service PersistenceManager lt depends gt lt depends optional attribute name JMSUserManager gt jboss messaging service JMSUserManager lt depends gt lt depends gt jboss messaging service Connector transpor t bisocket lt depends gt lt depends optional attribute name SecurityStore proxy type org jboss jms server SecurityStore gt jboss messaging service SecurityStore lt depends gt lt mbean gt 5 2 Atributos del ServerPeer Esta secci n aborda los atributos del bean administrado ServerPeer ServerPeerID El identificador Unico del ServerPeer Todo nodo implementado tiene que tener un identificador Unico ya sea que los nodos formen un cl ster o que est n enlazados por medio de un pu
15. pertenecen a este tema en un formato HT ML ListDurableSubscriptionsASHT ML Lista todas las subscripciones durables que pertenecen a este tema en un formato HT ML ListNonDurableSubscriptions Lista todos los mensajes no durables que pertenecen a la suscripci n especificada Utilizando un selector JMS como argumento en esta operaci n le permite recuperar un subgrupo de mensajes en la cola que coinciden con los criterios dados ListNonDurableSubscriptionsAsHTML Lista todas las subscripciones no durables de este tema en un formato HT ML 5 8 Configuraci n de f bricas de conexi n 40 Cap tulo 5 Configuraci n Con la configuraci n predeterminada JBoss Messaging enlaza dos f bricas de conexiones en JNDI durante el arranque La primera f brica de conexiones es la f brica de conexiones sin cl sters predeterminada Esta f rbica de conexiones se proporciona para mantener la compatibilidad con las aplicaciones que originalmente se escribieron frente a JBossMQ el cual no tiene conmutaci n autom tica de servidor en caso de fallos ni balanceo de carga Esta f brica de conexiones se debe utilizar si no requiere conmutaci n de servidor en caso de fallos o balaceo de carga autom ticos La primera f brica de conexiones se enlaza a los siguientes contextos JNDI ConnectionFactory XAConnectionFactory java ConnectionFactory java XAConnectionFactory La segunda f brica de conexiones es la predeterminada en cl sters y est e
16. recibe mensajes de otros nodos en el cl ster y replica datos de sesi n JBoss Messaging utiliza JGroups para toda la administraci n del grupo Se utiliza la configuraci n est ndar de JGroups 5 5 Configuraci n del administrador de persistencia JBoss Messaging se env a junto con un administrador de persistencia JDBC utilizado para manejar la persistencia de datos de mensajes en una base de datos relacional accedida a trav s de JDBC El administrador de persistencia es enchufable al servidor de mensajer a y esto hace posible el proporcionar otras implementaciones para persisitir datos de mensajes en almacenamientos no relacionales almacenamientos de archivos La configuraci n de servicios persistentes est agrupada en lt database type gt persistence 28 Cap tulo 5 Configuraci n service xml Por defecto JBoss Messaging se env a junto con el archivo hsqldb persistence service xm1 el cual configura el servidor Messaging a utilizar en la instancia de la base de datos Hypersonic que viene por defecto con cualquier instancia de JBoss Enterprise Application Server Y is Hypersonic no se soporta para uso en un entorno de producci n JBoss Messaging tambi n se env a junto con configuraciones del administrador de persistencia para MySQL Oracle PostgreSQL Sybase y el servidor Microsoft SQL Los archivos de configuraci n de ejemplo tal como mysql persistence service xml y ndb persistence service xml se encuentran d
17. reentrega para este tema Sobreescribe cualquier grupo de valores en el archivo de configuraci n del servidor compa ero MaxDeliveryAttempts Define el n mero m ximo de veces que se intentar entregar un mensaje antes de enviar el mensaje al DLQ si est configurado Elvalor predeterminado es 1 el cual especifica que el valor del archivo de configuraci n del servidor compa ero que se va a utilizar Cualquier otra configuraci n sobreescribe el valor del servidor compa ero CreatedProgrammatically Retorna true si el tema se cre program ticamente MaxSize Especifica un n mero m ximo de mensajes que se pueden mantener en una subscripci n de tema Cualquier mensaje que llegue despu s de este punto se borrar del tema Por defecto es 1 lo cual significa que no hay resticci n en el tama o Clustered Configure esto como true si su destino es un cl ster MessageCounterHistoryDayLimit Define el n mero maximo de d as que se mantiene el historial contador de mensajes 37 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Sobreescribe cualquier valor establecido en el archivo de configuraci n del servidor compa ero MessageCounters Retorna una lista de los contadores de mensajes para las subscriciones del tema AllMessageCount Retorna el n mero total de mensajes en todas las subscripciones que pertenecen a este tema DurableMessageCount Retorna el n mero total de mensajes durab
18. un servidor diferente o si corresponde a un proveedor diferente que no es JBoss JMS entonces puede desplegar otra instancia bean administrada JMSProviderLoader que el puente puede utilizar para contactar el destino en el proveedor JMS remoto Para utilizar una fuente o un destino remoto que no es JBoss Messaging con una entrega QOS_ONCE_AND_ONLY_ONCE el proveedor JMS remoto debe proporcionar una implementaci n de recurso JMS XA completamente funcional que funcione remotamente desde el servidor SourceDestinationLookup La b squeda JNDI completa para el destino fuente por medio del SourceProvider Loader tal como queue mySourceQueue TargetDestinationLookup La b squeda JNDI completa para el destino objetivo por medio del TargetProviderLocator tal como topic myTargetTopic SourceUsername Un atributo opcional que especifica el nombre de usuario para crear la conexi n fuente SourcePassword Un atributo opcional que especifica la contrase a para crear la conexi n fuente TargetUsername Un atributo opcional que especifica el nombre de usuario para crear la conexi n destino TarqetPassword Cap tulo 8 Configuraci n del puente de mensajes de JBoss Messaging Un atributo opcional que especifica la contrase a para crear la conexi n destino QualityOfServiceMode Un n mero entero que representa el modo de la calidad de servicio deseada Los valores posibles son O que representa QOS_AT_MOST_ONCE 1 que representa QOS_DU
19. utilizan en ediciones de HTML si est n instalados en su sistema Si no se muestran tipograf as alternativas pero equivalentes Nota Red Hat Enterprise Linux 5 y siguientes incluyen Liberation Fonts predeterminadas 1 1 Convenciones tipogr ficas Se utilizan cuatro convenciones tipogr ficas para llamar la atenci n sobre palabras o frases espec ficas Dichas convenciones y las circunstancias en que se aplican son las siguientes Negrita monoespaciado Utilizado para resaltar la entrada del sistema incluyendo los comandos de shell nombres de archivos y rutas Tambi n sirve para resaltar teclas y combinaciones de teclas Por ejemplo Para ver el contenido del archivo my_next_bestselling_novel en su directorio actual de trabajo escriba el comando cat my_next_bestselling_novel en el int rprete de comandos de shell y pulse Enter para ejecutar el comando El ejemplo anterior incluye un nombre de archivo un comando de shell y una tecla Todo se presenta en negrita monoespaciado y distinguible gracias al contexto Las combinaciones de teclas se pueden distinguir de las individuales con el signo m s que conecta cada partee de la combinaci n de tecla Por ejemplo Pulse Enter para ejecutar el comando Pulse Ctr1 A1t F2 para pasar a una terminal virtual El primer ejemplo resalta una tecla particular a pulsar El segundo ejemplo resalta una combinaci n de teclas un set de tres teclas pulsadas simult neamente Si se discute el c
20. Manager El administrador del usuario JMS que el ServerPeer utiliza normalmente no es necesario cambiar este atributo SecurityStore El SecurityStore enchufable Si redefine este atributo recuerde que necesitar autenticar el usuario MessageSucker JBM SUCKER con todos los permisos especiales que los cl sters requieren SupportsTxAge Especifica si el tiempo de creaci n de la transacci n se lamacena en el registro de la transacci n Si se configura como true entonces se almacena el registro de la transacci n El valor predeterminado es false 5 2 1 M todos del ServerPeer Los siguientes m todos est n disponibles para el bean administrado ServerPeer deployQueue Utilizado de manera program tica para implementar una cola Si la cola ya existe pero no se ha implementado entonces se implementa De otra manera se crea y se implementa El par metro name coincide con el nombre del destino a desplegar El par metro jndiName opcional representa el nombre JNDI completo a donde enlazar el destino Si no se especifica entonces el destino se enlazar en lt DefaultQueueJNDIContext gt lt name gt Hay dos versiones sobrecargadas de esta operaci n La primera implementa el destino con los par metros de paginaci n predeterminados La segunda despliega el destino con los par metros de paginaci n especificados Para mayor informaci n sobre los par metros de undeployQueue Utilizado program ticamente para borrar la implem
21. PLICATES_OK 2 que representa QOS_ONCE_AND_ONLY_ONCE completa de estos modos Selector Un atributo opcional que le permite proporcionar una expresi n selector JMS al consumir mensajes desde un destino fuente S lo los mensajes que coincidan con la expresi n del selector ser n transportadas a trav s de un puente desde la fuente hasta el destino La expresi n del selector debe seguir la sintaxis del selector JMS especificada aqu Para mayor rendimiento aplique los selectores de subscripci n de temas fuente a consumidores de colas fuente MaxBatchSize Especifica el n mero m ximo de mensajes a consumir desde el destino fuente antes de enviarlos en grupo al destino objetivo Su valor debe sermayor o igual a 1 MaxBatchTime Especifica el n mero m ximo de milisegundos a esperar antes de enviar un grupo de mensajes al destino incluso si no llegado hasta MaxBatchSize Su valor dede ser 1 espere por siempre o mayor o igual a 1 para especificar un tiempo SubName Representa el nombre de la suscripci n durable que consumir del tema destino fuente ClientID Representa el ID de cliente JMS a utilizar al crear o buscar la suscripci n durable que consumir del tema destino fuente FailureRetryInterval La cantidad de tiempo en milisegundos a esperar entre el tratar de recrear las conexiones a los servidores destino o fuente despu s de que se detecta un fallo MaxRetries El numero de veces a intentar recrear la
22. ades del sistema que JBoss Messaging utiliza 2 3 1 support bytes ld 2 3 2 retain oldxabehaviour Cap tulo 3 Instalaci n de JBoss Messaging 1 2 0 2 cece cect teens Capitulo 4 Ejecuci n de los ejemplos 0 ccc ent e etn eens Capitulo 5 Configuraci n e ee tent n ene n ene nee ae ene 5 1 Configuraci n del ServerPeer 5 2 Atributos del ServerPeer 5 2 1 M todos del ServerPeer 5 3 Cambio de la base de datos 5 4 Configuraci n de la oficina postal 5 4 1 Atributos de la oficina postal 5 5 Configuraci n del administrador de persistencia 5 5 1 Atributos MBean PersistenceManager 5 6 Configuraci n del administrador de usuarios de JMS 5 6 1 Atributos Bean administrados JMSUserManager 5 7 Configuraci n de destinos 5 7 1 Destinos pre configurados 5 7 2 Configuraci n de colas 5 7 2 1 Atributos MBean cola 5 7 2 1 1 Configuraci n de seguridad del destino 5 7 2 1 2 Par metros de paginaci n de destinos 5 7 2 1 3 Operaciones Bean administradas en cola 5 7 3 Configuraci n de temas 5 7 3 1 Atributos Bean administrados por temas 5 7 3 1 1 Configuraci n de seguridad del destino 5 7 3 1 2 Par metros de paginaci n de destinos 5 7 3 2 Operaciones Bean administradas por tema 5 8 Configuraci n de f bricas de conexi n 5 8 1 Atributos del Bean administrado ConnectionFactory 5 9 Configuraci n del conector remoto 5 10 ServiceBindingManager Cap tulo 6 Notas Sobre cl sters o ooo
23. bean gt 5 7 2 Configuraci n de colas 5 7 2 1 Atributos MBean cola Nombre Define el nombre de la cola JNDIName Define el nombre JNDI que enlaza la cola DLQ Define el DLQ del ingl s Dead Letter Queue utilizado para esta cola Sobreescribe cualquier grupo de valores en el archivo de configuraci n del ServerPeer ExpiryQueue Define la cola de expiraci n y sobreescribe cualquier grupo de valores en el archivo de configuraci n del servidor compa ero RedeliveryDelay Define el retraso de re entrega a utilizar para esta cola Sobreescribe cualquier valor en el archivo de configuraci n del servidor compa ero MaxDeliveryAttempts Define el n mero m ximo de veces que se intentar entregar un mensaje antes de enviar el mensaje al DLQ si est configurado El valor predeterminado 1 significa que se utiliza el valor del archivo de configuraci n del servidor compa ero Cualquier otra configuraci n sobreescribe el valor establecido en el archivo de configuraci n del servidor compa ero CreatedProgrammatically Retorna true si la cola fue creada program ticamente MessageCount 33 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging co Retorna el n mero total de mensajes en la cola Es decir el n mero de mensajes que se estan programando m s el n mero de los que se est n entregando m s el n mero de los que no se entregan ScheduledMessageCount Retorna el n mero de men
24. ccococcoc tne n eee nee 6 1 Id nico del servidor compa ero 6 2 Destinos con cl sters Table of Contents NOOOuAAAHA 10 10 10 11 12 13 15 15 17 20 22 23 26 28 30 31 32 32 32 33 33 35 35 36 37 37 38 39 40 40 43 45 50 51 51 51 Historial de revisiones JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging 6 3 Subscripciones durables en cl sters 6 4 Destinos temporales en cl sters 6 5 Servidores sin cl sters 6 6 Ordenamiento de mensajes en el cl ster 6 7 Operaciones Idempotent 6 8 F bricas de conexiones en cl sters Cap tulo 7 Configuraci n de JBoss Messaging XA Recovery Cap tulo 8 Configuraci n del puente de mensajes de JBoss Messaging 8 1 Sinopsis del puente de mensajes 8 2 Despliegue del puente 8 3 Configuraci n del puente Cap tulo 9 Habilitaci n del grupo de ordenamiento de JBoss Messaging 9 1 C mo habilitar el grupo de ordenamiento de mensajes 9 1 1 Habilitaci n con el API 9 1 2 Cambios en la configuraci n 9 2 Notas y limitaciones 51 51 51 52 52 52 53 54 55 55 61 61 62 63 Table of Contents JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Prefacio 1 Convenciones del Documento Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atenci n sobre ciertas partes espec ficas de informaci n Liberation Fonts tambi n se
25. ce gt lt attribute name PostOfficeName gt JMS post office lt attribute gt lt The datasource used by the post office to access it s binding information gt lt attribute name DataSource gt java DefaultDS lt attribute gt lt If true will attempt to create tables and indexes on every start up gt lt attribute name CreateTablesOnStar tup gt true lt attribute gt lt If true then we will automatically detect and reject duplicate messages sent during failover gt lt attribute name DetectDuplicates gt true lt attribute gt lt The size of the id cache to use when detecting duplicate messages gt lt attribute name IDCacheSize gt 500 lt attribute gt lt attribute name SqlProperties gt CREATE_POSTOFFICE_TABLE CREATE TABLE JBM_POSTOFFICE POSTOFFICE_NAME VARCHAR 255 NODE_ID INTEGER QUEUE_NAME VARCHAR 255 COND VARCHAR 1023 SELECTOR VARCHAR 1023 CHANNEL_ID BIGINT CLUSTERED CHAR 1 ALL_NODES CHAR 1 PRIMARY KEY POSTOFFICE_NAME NODE_ID QUEUE_NAME ENGINE INNODB INSERT_BINDING INSERT INTO JBM_POSTOFFICE POSTOFFICE_NAME NODE_ID QUEUE_NAME COND SELECTOR CHANNEL_ID CLUSTERED ALL_NODES VALUES 2 2 2 7 2 2 7 DELETE_BINDING DELETE FROM JBM_POSTOFFICE WHERE POSTOFFICE_NAME AND NODE_ID AND QUEUE_NAME LOAD_BINDINGS SELECT QUEUE_NAME COND SELECTOR CHANNEL_ID CLUSTERED ALL_NODES FROM JBM_POSTOFFICE WHERE POSTOFFICE_NAME AND NODE_ID lt attr
26. ck for the control channel gt lt attribute name ControlChannelConfig gt lt config gt lt UDP mcast_port jboss messaging controlchanneludpport 45568 tos 8 ucast_recv_buf_size 20000000 ucast_send_buf_size 640000 mcast_recv_buf_size 25000000 mcast_send_buf_size 640000 loopback false discard_incompatible_packets true max_bundle_size 64000 max_bundle_timeout 30 use_incoming_packet_handler true use_outgoing_packet_handler false pete down_thread false up_thread false enable_bundling false gt lt PING timeout 2000 lt MERGE2 max_interval 100000 lt FD_SOCK down_thread false up_thread false gt lt FD timeout 10000 max_tries 5 down_thread false up_thread false shun true gt lt VERIFY_SUSPECT timeout 1500 down_thread false up_thread false gt lt pbcast NAKACK max_xmit_size 60000 use_mcast_xmit false gc_lag 0 retransmit_timeout 300 600 1200 2400 4800 down_thread false up_thread false discard_delivered_msgs true gt lt UNICAST timeout 300 600 1200 2400 3600 down_thread false up_thread false gt down_thread false up_thread false max_bytes 400000 gt lt pbcast GMS print_local_addr true join_timeout 3000 use_flush true flush_timeout 3000 down_thread false up_thread false join_retry_timeout 2000 shun false view_bundling true gt lt pbcast STATE_TRANSFER down_thread false up_thread false use_flush true fl
27. curity gt el cual contiene m ltiples elementos lt role gt Cada elemento lt role gt define el tipo de accesso para ese rol en particular usando los siguientes atributos read Especifica que el rol puede crear clientes recibir mensajes y navegar el destino write Especifica que el rol puede crear productores o enviar mensajes al destino create Especifica que el rol puede crear suscripciones durables en este destino La configuraci n de seguridad para un destino es opcional Si no se especifica un elemento SecurityConfig entonces se utilizar la configuraci n predeterminada de seguridad del servidor compa ero 5 7 2 1 2 Par metros de paginaci n de destinos Pageable Channels es una funcionalidad de JBoss Messaging que le permite especificar el n mero m ximo de mensajes que se pueden almacenar en la memoria en cualquier momento cola por cola o tema por tema Luego JBoss Messaging pagina los mensajes hacia y desde el almacenamiento de Manera transparente en bloques permiti ndoles crecer a las colas y a las subscripciones hasta tama os muy grandes sin ninguna disminuci n en el rendimiento ya que el tama o del canal se incrementa Los par metros individuales asociados con los canales paginables son los siguientes FullSize Especifica el n mero m ximo de mensajes que las subscripciones de tema o cola mantienen en la memoria en cualquier momento La cola misma puede mantener muchos m s mensajes 35 JBoss Enterpri
28. curre una manera de mejorar este manual nos encantar a escuchar sus sugerencias Complete un reporte en Bugzilla frente al producto JBoss Enterprise Application Platform 5 y el componente doc JBoss_Messaging_User_Guide El siguiente Llene la siguiente plantilla en el campo de Description de Bugzilla Sea tan especifico como le sea posible al describir el problema esto ayudar a asegurarnos de que lo podemos solucionar r pidamente URL del documento N mero de la secci n y nombre Describa el problema Sugerencias para mejorar Informaci n adicional Aseg rese de darnos su nombre para poder darle todo el cr dito por reportar el problema JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Cap tulo 1 Sobre JBoss Messaging 1 4 JBoss Messaging es un sistema de mensajer a empresarial de JBoss Es una completa re escritura de JBossMQ el proveedor JMS del servicio de mensajer a Java JBoss JBoss Messaging es el proveedor JMS predeterminado en JBoss Enterprise Application Platform 4 3 y 5 JBoss Messaging es una parte integral de la estrategia de mensajer a de Red Hat Brinda un rendimiento mejorado en entornos con un s lo nodo o con cl sters Tambi n cuenta con una arquitectura modular que permite el a adir f cilmente nuevas funcionalidades en el futuro Este manual muestra c mo instalar y configurar JBoss Messaging para JBoss Enteprise Application Platform Cap tulo 2 Introducci n
29. de conexiones JBoss Messaging para habilitar la funcionalidad del grupo de ordenamiento Para lograr esto se agregan dos nuevos atributos al archivo de configuraci n del servicio de f brica Estos son EnableOrderingGroup configure esta propiedad como true para habilitar la funcionalidad del grupo de ordenamiento El valor predeterminado para esta propiedad es false y DefaultOrderingGroupName el nombre predeterminado para el grupo de ordenamiento de los mensajes El nombre del grupo se generar autom ticamente si este atributo falta Una vez configurado para habilitar la funcionalidad del grupo de ordenamiento en una f brica de conexiones todos los mensajes que se env an desde cualquier productor creado desde la f brica de conexiones se convierten en mensajes del grupo de ordenamiento El siguiente ejemplo del archivo de configuraci n del servicio de f brica demuestra c mo habilitar la funcionalidad del grupo de ordenamiento 62 Cap tulo 9 Habilitaci n del grupo de ordenamiento de JBoss Messaging lt mbean code org jboss jms server connectionfactory ConnectionFactory name jboss messaging connectionfactory service ConnectionFactory xmbean dd xmdesc ConnectionFactory xmbean xml gt lt depends optional attribute name ServerPeer gt jboss messaging service ServerPeer lt depends gt lt depends optional attribute name Connector gt jboss messaging service Connector transport bisocket lt depe
30. denamiento estricto de mensajes est habilitado en la ConnectionFactory If set to true cualquier mensajes enviado desde los productores los cuales sean creados desde la f brica de conexiones habilitada se vuelven mensajes de grupo ordenados El valor predeterminado para este par metro es false DefaultOrderingGroupName Especifica el nombre predeterminado para el grupo de ordenamiento de mensajes El nombre especificado tendr efecto una vez que el par metro EnableOrderingGroup se establezca como true Si este atributo falta entonces el nombre del grupo se generar autom ticamente 5 9 Configuraci n del conector remoto JBoss Messaging usa JBoss Remoting para toda la comunicaci n entre el cliente y el servidor 45 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Para mayor informaci n sobre la configuraci n de JBoss Remoting y sus funcionalidades consulte el cap tulo Remoting en el JBoss Administration and Configuration Guide La configuraci n predeterminada incluye un s lo conector remoto el cual lo utiliza la nica f brica de conexiones predeterminada Cada f brica de conexiones se puede configurar para que utilice un conector diferente El conector predeterminado se configura para que utilice el transporte bisocket remoto El transporte bisocket es un transporte con base en un socket TCP el cual escucha y acepta conexiones s lo del lado del servidor Es decir las conexiones siempre se
31. do un nodo se une a un cl ster que ya existe El valor predeterminado es 30000 27 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging milisegundos CastTimeout Especifica el tiempo m ximo que la oficina postal esperar por un mensaje de vaciado de respuesta de manera sincr nica El valor predeterminado es 30000 milisegundos FailoverOnNodeLeave Especifica la manera en que las conexiones se manejan cuando un nodo del servidor se apaga Si se configura como true entonces las conexiones asociadas con el nodo del servidor que ha terminado de manera limpia conmutar n a otro nodo en caso de fallo El valor predeterminado es false MaxConcurrentReplications Especifica el n mero m ximo de peticiones de replicaci n concurrentes a retornar antes de que las respuestas se bloqueen Esto previene que JGroups se sobrecargue El valor predeterminado es 50 No debe modificar el valor predeterminado para MaxConcurrentReplications El valor predeterminado es la configuraci n ptima ControlChannelConfig Especifica la configuraci n de la pila JGroups para el canal de control El canal de control env a peticiones y recibe respuestas de otros nodos en el cl ster JBoss Messaging utiliza JGroups para toda la administraci n del grupo Se utiliza la configuraci n est ndar de JGroups DataChannelConfig Especifica la configuraci n de la pila JGroups para el canal de datos El canal de datos env a y
32. e en cl ster autom ticamente dado que su tema se encuentra en un cl ster Para mayor informaci n sobre la configurici n de temas y colas en cl sters consulte el atributo 6 4 Destinos temporales en cl sters JBoss Messaging soporta temas y colas temporales en cl sters Todos los temas y colas temporales se pondr n en cl sters si la oficina postal est en cl ster Para obtener mayor informaci n sobre la configuraci n de temas y colas en cl sters consulte el atributo 6 5 Servidores sin cl sters Establezca el atributo cl ster Postoffice como false si no quiere que todos los nodos participen en un cl ster o si no quiere que el servidor est en cl ster Para mayor informaci n sobre la configuraci n de un servidor sin cl ster consulte los diferentes 51 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging 6 6 Ordenamiento de mensajes en el cl ster Para asegurarse de que los mensajes se consumen en el mismo orden en que se produjeron establezca un ordenamiento JMS estricto configurando el atributo del servidor compa ero DefaultPreserveOrdering como true Mientras est configurado como true los mensajes no se pueden distribuir tan libremente alrededor del cl ster El valor predeterminado es false 6 7 Operaciones Idempotent Se garantiza que un mensaje sea persistido cuando el mensaje enviado a un destino persistente retorna sin excepci n Una excepci n no garantiza que el mensaj
33. e enviar y recibir a un tema remoto utilizando un cliente JMS JBOSS_HOME docs examples jboss messaging examples mdb Este ejemplo demuestra el uso de un Enterprise JavaBean 2 1 MDB con JBoss Messaging JBOSS_HOME docs examples jboss messaging examples ejb3mdb Este ejemplo demuestra el uso de un Enterprise JavaBean 3 0 MDB con JBoss Messaging JBOSS_HOME docs examples jboss messaging examples stateless Este ejemplo demuestra un bean de sesi n sin estado Enterprise JavaBean 2 1 interactuando con JBoss Messaging JBOSS_HOME docs examples jboss messaging examples mdb failure Este ejemplo demuestra la manera de deshacer y re entregar dentro de un Enterprise JavaBean 2 1 JBOSS_HOME docs examples jboss messaging examples secure socket Este ejemplo demuestra un cliente JMS interactuando con un servidor JBoss Messaging por medio de un transporte encriptado SSL JBOSS_HOME docs examples jboss messaging examples http Este ejemplo demuestra un cliente JMS interactuando con un servidor JBoss Messaging construyendo un tunel para el tr fico a trav s de HTTP JBOSS_HOME docs examples jboss messaging examples web service Este ejemplo demuestra JBoss Webservice interactuando con JBoss Messaging JBOSS_HOME docs examples jboss messaging examples distributed queue Este ejemplo demuestra el cliente JMS interactuando con una cola distribu da de JBoss Messaging Para ejecutar este ejemplo se requieren dos instancias de JBoss Enterp
34. e name MessageCounterSamplePeriod gt 5000 lt attribute gt lt The maximum amount of time for a client to wait for failover to start on the server side after it has detected failure gt lt attribute name FailoverStartTimeout gt 60000 lt attribute gt lt The maximum amount of time for a client to wait for failover to complete on the server side after it has detected failure gt lt attribute name FailoverCompleteTimeout gt 300000 lt attribute gt Cap tulo 5 Configuraci n lt attribute name StrictTck gt false lt attribute gt lt The maximum number of days results to maintain in the message counter history gt lt attribute name DefaultMessageCounterHistoryDayLimit gt 1 lt attribute gt lt The name of the connection factory to use for creating connections between nodes to pull messages gt lt attribute name ClusterPullConnectionFactoryName gt jboss messaging connectionfactory service ClusterPullConnectionFactory lt attribute gt lt When redistributing messages in the cluster Do we need to preserve the order of messages received by a particular consumer from a particular producer gt lt attribute name DefaultPreserveOrdering gt false lt attribute gt lt Max time to hold previously delivered messages back waiting for clients to reconnect after failover gt lt attribute name RecoverDeliveriesTimeout gt 300000 lt attribute gt lt Set to true to enable
35. e no fue persistido ya que la falla puede haber ocurrido entre el momento en que el mensaje se estaba persistiendo y el momento en que una respuesta fuera enviada al que realiza la llamada Por lo tanto las aplicaciones deben estas codificadas de manera que las operaciones son idempotent es decir las operaciones se pueden repetir sin hacer que el sistema se vuelva inconsistente Puede implementar este comportamiento en el nivel de la aplicaci n buscando mensajes duplicados y descart dolos si el mensaje original se ha enviado de manera exitosa Este chequeo de duplicados es una t cnica poderosa que puede eliminar la necesidad de transacciones XA JBoss Messaging est configurado por defecto para realizar un chequeo de duplicados en un entorno con cl sters Las consideraciones relacionadas con la persistencia se encuentran en S 6 8 F bricas de conexiones en cl sters Cuando supportsLoadBalancing est configurado como true en la f brica de conexiones entonces los intentos consecutivos de creaci n de conexiones se resolver n de manera equitativa entre los servidores disponibles El primer nodo se escoje al azar Cuando supportsFailover est configurado como true la conmutaci n de servidores en caso de fallo ocurrir de manera transparente y autom ticamente cuando se detecte cualquier error de conexi n 52 Cap tulo 7 Configuraci n de JBoss Messaging XA Recovery Cap tulo 7 Configuraci n de JBoss Messaging XA Rec
36. ea utilinzado el API o realizando cambios en la configuraci n 9 1 1 Habilitaci n con el API Para utilizar la funcionalidad del grupo de ordenamiento de JBoss Messaging es necesario crear un JBossMessageProducer como se demuestra en el siguiente ejemplo del c digo JBossMessageProducer producer JBossMessageProducer session createProducer queue Una vez creado JBossMessageProducer proporciona dos m todos para iniciar y terminar un grupo de ordenamiento enableOrderingGroup El siguiente ejemplo de c digo demuestra la manera de crear un grupo de ordenamiento con el nombre 61 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging ogrpName public void enableOrderingGroup String ogrpName throws JMSException Una vez que se llame el productor enviar mensajes de parte del grupo de ordenamiento Si se proporciona un par metro null entonces se generar de manera autom tica el nombre del grupo de ordenamiento El llamar este m todo m s de una vez sobreescribir cualquier llamada anteriro del m todo disableOrderingGroup El siguiente ejemplo de c digo demuestra c mo parar de producir mensajes de grupo de ordenamiento public void disableOrderingGroup throws JMSException Una vez que se llame el productor parar de enviar mensajes del grupo de ordenamiento y re iniciar su comportamiento predeterminado 9 1 2 Cambios en la configuraci n Los usuarios pueden configurar una f brica
37. eglas Regla uno Los mensajes que forman parte de un grupo de ordenamiento se entregan uno a la vez El siguiente mensaje no se entregar hasta que se complete la entrega de un mensaje anterior Hay varias maneras de se alar que la entrega de un mensaje se ha completado dependiendo de la configuraci n del modo de reconocimiento El modo CLIENT_ACKNOWLEDGE hace que el m todo Message acknowledge se ale el estado de completo Los modos AUTO_ACKNOWLEDGE y DUPS_OK_ACKNOWLEDGE hacen que al completarse el mensaje se identifique con uno de los siguientes un retorno exitoso de uno de los m todos MessageConsumer receive o un retorno exitoso de la llamada onMessage del MessageListener Si el consumidor de mensajes est cerrado entonces se considerar como completado el mensaje que se est procesando en el momento del cierre Esto es sin importar si se ha llamado aun _ACKNOWLEGE antes del cierre del consumidor Regla dos En el caso de recepci n transaccional de mensajes el siguiente mensaje no se entregar hasta que la transacci n haya guardado los cambios lo cual incluye el reconocimiento de la recepci n del mensaje actual Si la transacci n se deshace entonces el mensaje se cancelar se enviar de regreso al servidor JMS y se har disponible para la siguiente entrega 9 1 C mo habilitar el grupo de ordenamiento de mensajes El grupo de ordenamiento de JBoss Messaging se puede habilitar de dos maneras Ya s
38. encial para que los mensajes sean consumidos por consumidores r pidos No es posible el inhabilitar por completo el buffer pero el establecer el atributo SLowConsumers como true reducir el tama o del buffer El configurar este atributo como true es equivalente a establecer PrefetchSize como 1 el cual es el valor menor posible disponible StrictTck Habilita el conmportamiento JMS estricto si el atributo se configura como true El comportamiento JMS estricto lo requiere el kit de compatibilidad de tecnologia T CK del ingl s Technology Compatibility Kit SendAcksAsync Especifica que los reconocimientos se env an de manera asincr nica si el atributo se establece como true Esto puede mejorar el rendimiento particularmente si el modo auto_acknowledge est activo DefaultTempQueueFullSize Atributo opcional que especifica los par metros de paginaci n para los destinos de cola temporales de tama o completo los cuales van para las conexiones creadas con esta f brica de conexiones El valor predeterminado es 200000 Para obtener mayor informaci n sobre DefaultTempQueuePageSize Atributo opcional que especifica los par metros de paginaci n para los destinos de tama o de p gina temporal los cuales van para las conexiones creadas con esta f brica de conexiones El valor predeterminado es 2000 Para mayor informaci n sobre estos atributos consulte DefaultTempQueueDownCacheSize Atributo opcional que especifica los par metro
39. entLeasePeriod Los clientes retornan peri dicamente heartbeats al servidor para confirmarle al servidor que a n se encuentran activos Si el servidor no recibe un heartbeat despu s de cierto tiempo entonces cerrar la conexi n y remover todos los recursos en el servidor correspondiente a la sesi n del cliente El clientLeasePeriod determina el periodo de tiempo entre heartbeats en milisegundos El valor predeterminado es 10000 Por defecto el servidor cierra un cliente si no recibe un heartbeat dentro del doble del clientLeasePeriod En realidad se ajusta el tama o del periodo de acuerdo con la carga del sistema numberOfRetries JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging El n mero de segundos que JBoss Remoting bloquear en el pool de clientes en espera de una conexi n libre Si tiene un n mero grande de sesiones accediendo a mismo tiempo al servidor desde un cliente y no puede obtener conexiones desde el pool deber a considerar el incrementar este valor clientMaxPoolSize JBoss Remoting mantiene un pool del lado del cliente de conexiones TCP en las cuales prestar servicios a las peticiones Si tiene un n mero grande de sesiones simult neas accediendo el servidor desde un cliente y no puede obtener conexiones desde el pool considere el incrementar este valor secondaryBindPort El transporte bisocket utiliza conexiones de control para pasar mensajes de control entre el servidor y el cl
40. entaci n de una cola Las colas no se borran 20 Cap tulo 5 Configuraci n del almacenamiento persistente Esta operaci n retorna true si la cola fue desimplementada exit samente De otra manera retorna false destroyQueue Utilizado de manera program tica para destruir una cola La cola es desimplementada y luego todos sus datos se destruyen de la base de datos Y WI Tenga cuidado al utilizar este m todo ya que borrar todos los datos para la cola Esta operaci n retorna true si la cola se destruy xitosamente De otra manera retorna false deployTopic Se utiliza de manera program tica para implementar un tema Hay dos versiones sobrecargadas de esta operaci n La primera implementa los temas ya existentes con los par metros de paginaci n predeterminados La segunda crea y despliega temas con los para obtener mayor informaci n El par metro name representa el nombre del destino a implementar El par metro jndiName representa el nombre JNDI completo de la ubicaci n a donde enlazar el destino Si esto no se especifica entonces el destino se enlaza en lt DefaultTopicJNDIContext gt lt name gt undeployT opic Utilizado para borrar program ticamente la implementaci n de un tema Se borra la implementaci n de los temas pero no se borran de un almacenamiento persistente Esta operaci n retorna true si se borra la implementaci n del tema de manera exitosa De otra manera se retorna false destroyTopic
41. ente de mensajes El identificador debe ser un n mero entero v lido 17 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging DefaultQueueJNDIContext El contexto JNDI predeterminado a utilizar al enlazar colas Por defecto es queue DefaultT opicJNDIContext El contexto JNDI predeterminado al utilizar al enlazar temas Por defecto es topic PostOffice Esta es la oficina postal que el ServerPeer utiliza Usualmente no es necesario que cambie este atributo La oficina postal es la responsable de enrutar los mensajes a colas y de mantener el mapeo entre direcciones y colas DefaultDLQ El DLQ Dead Letter Queue predeterminado que el servidor utiliza para los destinos El DLQ servidor ha intentado entregarlos sin tener xito m s de cierto n mero de veces Si no se especifica el QLD entonces el mensaje se borrar despu s del n mero m ximo de intentos de entrega El n mero m ximo de intentos de entrega se puede especificar utilizando el atributo DefaultMaxDeliveryAttempts para un valor predeterminado global o individualmente destino por destino DefaultMaxDeliveryAttempts El n mero predeterminado y m ximo de veces que se intentar entregar un mensaje antes de enviar el mensaje al DLQ si est configurado El valor predeterminado es 10 puede sobreescribir este valor destino por destino DefaultExpiryQueue La cola de expiraci n predeterminada que el ServerPeer utilizar para los destinos Puede sob
42. ertenecen a este tema NonDurableSubscriptionsCount Retorna un conteo de todas las subscripciones no durables que pertenecen a este tema 5 7 3 1 1 Configuraci n de seguridad del destino lt SecurityConfig gt determina que roles se permite leer escribir y crear en el destino Tiene exactamente la misma sintaxis y sem ntica que la configuraci n de seguridad en destinos JBossMQ El elemento lt SecurityConfig gt debe contener un elemento lt security gt el cual contiene m ltiples elementos lt role gt Cada elemento lt role gt define el tipo de accesso para ese rol en particular usando los siguientes atributos 38 Cap tulo 5 Configuraci n read Especifica que el rol puede crear clientes recibir mensajes y navegar el destino write Especifica que el rol puede crear productores o enviar mensajes al destino create Especifica que el rol puede crear suscripciones durables en este destino La configuraci n de seguridad para un destino es opcional Si no se especifica un elemento SecurityConfig entonces se utilizar la configuraci n predeterminada de seguridad del servidor compa ero 5 7 3 1 2 Par metros de paginaci n de destinos Previamente para que una aplicaci n soportara una cola o suscripci n era necesario almacenar la cola por completo en la memoria Esto no siempre era posible para las colas o suscripciones muy largas Loa canales paginables es una nueva funcionalidad de JBoss Messaging que le permite e
43. grega un byte que no sea cero al final a cada BLOB antes de la persistencia y se borra del BLOB despu s de la persistencia lo cual previene que la base de datos se trunque El valor predeterminado es false Cap tulo 5 Configuraci n Ciertas versiones de Sybase truncan un BLOB con ceros Este atributo solo se requiere si est ejecutando una base de datos Sybase SupportsBlobOnSelect Especifica la manera en que los BLOBs se insertan en ciertos tipos de bases de datos Cuando se establece como false entonces se utilizar la inserci n en dos etapas El valor predeterminado es true Ciertas bases de datos especificamente Oracle no permiten el insertar BLOBs por medio de una declaraci n INSERT INTO SELECT FROM y requieren una inserci n con un mensaje condicional de dos etapas Configure este atributo como false si est ejecutando una base de datos Oracle u otra base de datos con este requermiento SQLProperties Especifica el DDL y el DML para una base de datos en particular Si una declaraci n DDL o DML en particular no se sobreescribe la configuraci n Hypersonic predeterminada se utilizar para esa declaraci n MaxParams Especifica el n mero m ximo de par metros permitidos por declaraci n preparada al cargar mensajes El valor predeterminado es 500 UseNDBFailoverStrategy Especifica si una declaraci n SQL se debe volver a ejecutar en el evento de que falle al guardar los cambios de una transacci n en una
44. gt queue B lt attribute gt lt The username to use for the source connection lt attribute name SourceUsername gt bob lt attribute gt Ss lt The password to use for the source connection lt attribute name SourcePassword gt BobSecur3 lt attribute gt gt lt The username to use for the target connection lt attribute name TargetUsername gt mary lt attribute gt lt The password to use for the target connection lt attribute name TargetPassword gt MaryS3cur3 lt attribute gt gt lt Optional The Quality Of Service mode to use one of QOS_AT_MOST_ONCE O QOS_DUPLICATES_OK 1 QOS_ONCE_AND_ONLY_ONCE 2 gt lt attribute name QualityOfServiceMode gt 0 lt attribute gt lt JMS selector to use for consuming messages from the source lt attribute name Selector gt specify jms selector here lt attribute gt gt lt The maximum number of messages to consume from the source before sending to the target gt lt attribute name MaxBatchSize gt 5 lt attribute gt lt The maximum time to wait in ms before sending a batch to the target even if MaxBatchSize is not exceeded 1 means wait forever Sun lt attribute name MaxBatchTime gt 1 lt attribute gt lt If consuming from a durable subscription this is the subscription name lt attribute name SubName gt mysub lt attribute gt gt lt If consuming from a durable subscription this is t
45. he client ID to use lt attribute name ClientID gt myClientID lt attribute gt SES 57 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging lt The number of ms to wait between connection retrues in the event connections to source or target fail gt lt attribute name FailureRetryInterval gt 5000 lt attribute gt lt The maximum number of connection retries to make in case of failure before giving up 1 means try forever gt lt attribute name MaxRetries gt 1 lt attribute gt lt If true then the message ID of the message before bridging will be added as a header to the message so it is available to the receiver Can then be sent as correlation ID to correlate ini a distributed request response gt lt attribute name AddMessageIDInHeader gt false lt attribute gt lt mbean gt Atributos de configuraci n del puente de mensajes 58 SourceProviderLoader Cargador TargetProvider El puente utiliza el bean administrado JMSProviderLoader para buscar la f brica de conexiones fuente y el destino fuente Por defecto JBoss Enterprise Application Platform se env a junto con un JMSProviderLoader el cual se implementa en el archivo JBOSS_HOME server PROFILE deploy messaging jms ds xml y sirve como el JMSProviderLoader local predeterminado Para una configuraci n en cl ster hajndi jms ds xml realiza la misma tarea Si su destino objetivo o fuente se encuentra en
46. i ndole continuar El valor predeterminado es true DetectDuplicates Especifica si la oficina postal detectar mensajes duplicados enviados cuando la entrega es restringida en un nuevo nodo despu s de un fallo en el servidor Cuando se configura como true la oficina postal detecta mensajes duplicados El valor predeterminado es true IDCacheSize Especifica el n mero de IDs de mensajes que el cach ID debe mantener Si tiene lugar la conmutaci n de servidores en caso de fallo entonces el cach ID se accede como parte del proceso para prevenir que se env en mensajes duplicados despu s de la conmutaci n de servidores El valor predeterminado es 500 mensajes PostOffice Name Especifica el nombre de la oficina postal NodelDView Retorna los IDs de nodos de todos los nodos en el cl ster como grupo GroupName Especifica el nombre de la oficina postal al cual enlazar con otras oficinas postales con nombres id nticos Las oficinas postales con el mismo nombre de grupo formar n un cl ster juntas Aseg rese de que el nombre de grupo de la oficina postal coincida con todos los nodos con los que quiere formar un cl ster Clustered Especifica si la oficina postal se unir a un cl ster para formar temas y colas distribu das Si es false entonces todos los atributos relacionados con el cl ster se ignorar n StateTimeout Especifica el periodo m ximo que la oficina postal esperar para recibir el estado del grupo cuan
47. ibute gt lt This post office is clustered If you don t want a clustered post office then set to false gt lt attribute name Clustered gt true lt attribute gt lt All the remaining properties only have to be specified if the post office is clustered You can safely comment them out if your post office is non clustered gt lt The JGroups group name that the post office will use gt lt attribute name GroupName gt jboss messaging groupname MessagingPostOf fice lt attribute gt lt Max time to wait for state to arrive when the post office joins the cluster gt lt attribute name StateTimeout gt 5000 lt attribute gt lt Max time to wait for a synchronous call to node members using the MessageDispatcher gt lt attribute name CastTimeout gt 50000 lt attribute gt lt Set this to true if you want failover of connections to occur when a node is shut down gt lt attribute name FailoverOnNodeLeave gt false lt attribute gt lt JGroups stack configuration for the data channel used for sending data across the cluster gt lt By default we use the TCP stack for data gt lt attribute name DataChannelConfig gt lt config gt lt TCP start_port 7900 loopback true recv_buf_size 20000000 send_buf_size 640000 discard_incompatible_packets true max_bundle_size 64000 max_bundle_timeout 30 use_incoming_packet_handler true u
48. iente Este atributo define la direcci n a la que se enlaza el ServerSocket secundario Para trabajar por detr s de un corta fuegos es posible que necesite especificar un valor en particular para su configuraci n del corta fuegos secondaryConnectPort El puerto que el cliente utiliza para conectarse Puede especificar esto para permitirle a los clientes trabajar con enrutadores NAT maxPoolSize El n mero de hilos utilizados en el lado del servidor para atender peticiones Por defecto JBoss Messaging se enlaza a jboss bind address el cual se puede definir ejecutando el comando run sh c yourconfig b yourIP Si es necesario puede cambiar remoting bisocket service xml parautilizar un puerto de comunicaci n diferente A No cambie los valores en la configuraci n del conector aparte de los listados anteriormente El cambiarlos puede causar que JBoss Messaging pare de funcionar correctamente 5 10 ServiceBindingManager El SeviceBindingManager proporciona m ltiples instancias del servidor de aplicaciones ejecutando en la misma IP usando diferentes rangos de puerto lo cual es til durante el desarrollo Hay otras maneras de lograr esto pero el ServiceBindingManager hace la mayor parte del trabajo duro 50 Cap tulo 6 Notas sobre cl sters Cap tulo 6 Notas sobre cl sters Para ayudar a ubicar la informaci n relacionada con los cl sters en esta parte del manual proporcionamos un resumen de cada consideraci n co
49. ino o tema usualmente en un servidor diferente Los servidores fuente y de destino no se tienen que encontrar en el mismo cl ster lo cual hace que el realizar el puente sea apropiado para enviar mensajes desde un cl ster al otro por ejemplo a trav s de un WAN y en donde puede que la conexi n sea poco confiable Un puente se despliega como un bean administrado dentro de cualquier instancia de JBoss Enterprise Application Platform Para implementar agregue el descriptor bean administrado en el directorio deploy de una configuraci n de la plataforma de aplicaciones empresariales que contenga JBoss Messaging El ejemplo en JBOSS_HOME docs examples jboss messaging examples bridge demuestra el despliegue de un puente simple en JBoss Enterprise Application Platform y el movimiento de mensajes del destino al destino El puente tambi n se puede utilizar para recuperar mensajes desde servidores JMS que no son JBoss Messaging en tanto cumplan con los requeriminetos de JMS 1 1 El puente tiene una capacidad de recuperaci n de fallos incorporada as que si la conexi n al servidor fuente o al de destino se pierde por ejemplo debido a fallas en la red el puente volver a intentar conectarse a la fuente o al destino hasta que se reestablezca la red Cuando se vuelve a conectar reiniciar su operaci n de manera normal El puente se puede configurar para consumir mensajes que coincidan un selector JMS en particular Se puede configurar para que
50. installation el cual contiene JBoss Messaging 8 3 Configuraci n del puente El siguiente c digo es un ejemplo de la configuraci n del puente de mensajes con todos los atributos A algunos atributos se les quit el comentario para esta configuraci n ya que no es apropiado especificarlos todos al mismo tiempo Los que debe especificar depende de la configuraci n que quiera 55 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Ejemplo 8 1 Configuraci n del puente de mensajes 56 Cap tulo 8 Configuraci n del puente de mensajes de JBoss Messaging a N lt mbean code org jboss jms server bridge BridgeService name jboss messaging service Bridge name TestBridge xmbean dd xmdesc Bridge xmbean xml gt lt The JMS provider loader that is used to lookup the source destination gt lt depends optional attribute name SourceProviderLoader gt jboss messaging service JMSProviderLoader name JMSProvider lt depends gt lt The JMS provider loader that is used to lookup the target destination gt lt depends optional attribute name TargetProviderLoader gt jboss messaging service JMSProviderLoader name JMSProvider lt depends gt lt The JNDI lookup for the source destination gt lt attribute name SourceDestinationLookup gt queue A lt attribute gt lt The JNDI lookup for the target destination gt lt attribute name TargetDestinationLookup
51. ionConsumer se observar el ordenamiento de los mensajes Sin embargo el ConnectionConsumer no controla la sesi n que recibir el siguiente mensaje En el caso de una cola distribu da el usuario debe utilizar HASingleton para asegurarse de que la funcionalidad del grupo de ordenamiento sirve de manera correcta 63 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Historial de revisiones Revisi n 5 1 0 2 400 2013 10 31 R diger Landmann Rebuild with publican 4 0 0 Revisi n 5 1 0 2 2012 07 18 Anthony Towns Rebuild for Publican 3 0 Revisi n 5 1 Wed Sep 15 2010 Jared Morgan Se cambi el n mero de la versi n de acuerdo con los nuevos requerimientos de la versi n Revisado para JBoss Enterprise Application Platform 5 1 0 GA incluyendo Se modificaron los cap tulos 6 y 7 para el proyecto de criterios comunes 5 1 Se resalt el c digo donde era apropiado JBOSSCC 49 se incorporaron todos los comentarios del nuevo manual de JBoss Messaging 64
52. isponibles en el directorio j boss as docs examples jms del grupo del lanzamiento El administrador de persistencia JDBC usa SQL est ndar como su lenguaje de manipulaci n de datos DML del ingl s Data Manipulation Language as que el escribir una configuraci n del administrador de persistencia para otro tipo de base de datos es solo cambiar el lenguaje de definici n de datos DDL del ingl s Data Definition Language de la configuraci n lo cual usualmente es diferente para cada base de datos JBoss Messaging tambi n se env a con una opci n de configuraci n del asministrador de persistencia nulo la cual se puede utilizar cuando no quiere nada de persistencia El archivo predeterminado de configuraci n del administrador de persistencia de Hypersonic es el siguiente lt mbean code org jboss messaging core jmx JDBCPersistenceManagerService name jboss messaging service PersistenceManager xmbean dd xmdesc JDBCPersistenceManager xmbean xm1 gt lt depends gt jboss jca service DataSourceBinding name DefaultDS lt depends gt lt depends optional attribute name TransactionManager gt jboss service TransactionManager lt depends gt lt The datasource to use for the persistence manager gt lt attribute name DataSource gt java DefaultDS lt attribute gt lt If true will attempt to create tables and indexes on every start up gt lt attribute name CreateTablesOnStar tup gt true lt attribute gt lt If t
53. jes al almacenamiento desde la cola primero van a un Down Cache antes de escribirlos en el almacenamiento Esto activa la escritura para que ocurra como una sola operaci n lo cual ayuda al rendimiento 39 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Los par metros de paginaci n utilizados para colas temporales se deben especificar en la f brica de conexiones apropiadas Consulte la configuraci n de la f brica de conexiones para obtener m s detalles 5 7 3 2 Operaciones Bean administradas por tema RemoveAllMessages Remueve y borra todos los mensajes de las subscripciones que pertenecen a este tema Utilice esto con precauci n ya que borrar permanentemente todos los mensajes del tema ListAllMessages Lista todos los mensajes que pertenecen a una suscripci n especificada Utilizando un selector JMS como argumento en esta operaci n le permite recuperar un subgrupo de mensajes en la cola que coincidan con los criterios dados ListDurableMessages Lista todos los mensajes durables que pertenecen a la suscripci n especificada Utilizando un selector JMS como argumento en esta operaci n le permite recuperar un subgrupo de mensajes en la cola que coinciden con los criterios dados ResetMessageCounter Reestablece el contador de mensajes a cero ResetMessageCounterHistory Reestablece el historial del contador de mensajes ListAllSubscriptionsASHT ML Lista todas las subscripciones que
54. l de conteo de mensajes el cual muestra el n mero de mensajes que llegan a cada cola durante cierto n mero de d as Este atributo representa el n mero m ximo de d as que se debe almacenar el historial de conteo de mensajes Se puede sobreescribir destino por destino ClusterPullConnectionFactoryName La f brica de conexiones que se utiliza para traer o extraer los mensajes entre colas Puede omitir este atributo para inhabilitar la extracci n de mensajes y retener la conmutaci n de servidores en caso de fallos DefaultPreserveOrdering RecoverDeliveriesTimeout Cuando la conmutaci n en caso de fallo tiene lugar los mensajes que ya se han entregado se almacenan en espera de que los clientes se reconecten Dado el caso en que los clientes no se vuelvan a conectar por ejemplo el cliente est muerto entonces eventualmente estos mensajes expirar n y se a adir n de regreso a la cola Este atributo establece el valor en milisegundos Por defecto es 300000 cinco minutos EnableMessageCounters Cuando es true se activan los contadores de mensajes cuando el servidor inicia SuckerPassword JBoss Messaging internamente crea conexiones entre nodos con el fin de redistribuir los mensajes entre destinos en cl sters Estas conexiones se crean con el nombre de usuario reservado Este atributo define la contrase a a utilizar al crear estas conexiones Para las versiones de JBoss Messaging posteriores a 1 4 1 GA debe definir la SuckerPa
55. lar no se sobreescribe la configuraci n Hypersonic predeterminada se utilizar para esa declaraci n Tambi n puede insertar datos de usuarios predeterminados y de propiedades de roles adjuntandole el prefijo POPULATE TABLES a los datos 5 7 Configuraci n de destinos 5 7 1 Destinos pre configurados JBoss Messaging se envia junto con un grupo predeterminado de destinos pre configurados que se implementar n durante el arranque del servidor La informaci n sobre la configuraci n de estos destinos se puede encontrar em la siguiente secci n de destinations service xml 32 Cap tulo 5 Configuraci n i The Default Dead Letter Queue This destination is a dependency of an EJB MDB container ooo lt mbean code org jboss jms server destination QueueService name jboss messaging destination service Queue name DLQ xmbean dd xmdesc Queue xmbean xm1 gt lt depends optional attribute name ServerPeer gt jboss messaging service ServerPeer lt depends gt lt depends gt jboss messaging service Postoffice lt depends gt lt mbean gt los The Default Expiry Queue gt lt mbean code org jboss jms server destination QueueService name jboss messaging destination service Queue name ExpiryQueue xmbean dd xmdesc Queue xmbean xm1 gt lt depends optional attribute name ServerPeer gt jboss messaging service ServerPeer lt depends gt lt depends gt jboss messaging service Postoffice lt depends gt lt m
56. les en todas las subscripciones que pertenecen a este tema NonDurableMessageCount Retorna el n mero total de mensajes no durables en todas las subscripciones de este tema DropOldMessageOnRedeploy Especifica la manera en que se manejan los servicios de cola con los atributos del cl ster que difieren de los atributos implementados anteriormente Si se establece como true todos los mensajes que quedan en la cola se borran despu s de la re implementaci n del servicio de colas si el atributo del servicio de colas contiene un atributo cl ster diferente Si se configura como false predeterminado todos los mensajes se reservan N Advertencia Consideraciones al volver a implementar 3 Cuando vuelve a implementar un destino debe apagar todos los nodos en el cluster realizar los cambios apropiados a la configuraci n y luego re iniciar los nodos El volver a implementar desde la cola sin cl sters a una cola con cl sters requiere que configure el atributo cl ster como true y debe agregar la configuraci n de servicio de cola para cada nodo El volver a implementar desde una cola con cl sters a una sin cl sters requiere que configure el atributo cl ster como false en una de las configuraciones de cola y debe borrar las otras colas en el cl ster AllSubscriptionsCount Retorna un conteo de todas las subscripciones que pertenecen a este tema DurableSubscriptionsCount Retorna el conteo de todas las subscripciones durables que p
57. licar suscribir Mensajes persistentes y no persistentes Entrega garantizada de mensajes lo que asegura que los mensajes llegan s lo una vez a donde se requiere Interfaz transaccional y confiable que soporta la sem ntica ACID Un marco de trabajo de seguridad personalizable basado en JAAS Integraci n completa con JBoss Transactions conocido antes como Arjuna JT A para soportar la recuperaci n completa de transacciones Una interfaz extensiva de administraci n JMX Soporte para la mayor a de las bases de datos m s importantes incluyendo Oracle DB2 Sybase Microsoft SQL Server PostgreSQL y MySQL Transporte HTTP para permitir el uso a trav s de cortafuegos que s lo permiten tr fico HTTP Transporte servlet para permitir la mensajer a por medio de un servlet dedicado Transporte SSL DLQs del ingl s Dead Letter Queues configurables y colas de vencimiento Estad sticas de mensajes las cuales proporcionan una vista hist rica de los mensajes que se entregaron a qu colas y a qu subscripciones La paginaci n autom tica de los mensajes al almacenamiento Esto le permite el uso de colas muy largas que ser an demasiado largas para caber en la memoria del sistema por completo Ordenamiento estricto de mensajes lo cual hace que los mensajes que pertenecen a un grupo de mensajes en particular sean entregados de acuerdo al orden en que llegaron a la cola de destino JBoss Messaging tambi n incluye las siguientes fu
58. los atributos implementados anteriormente Si se establece como true todos los mensajes que quedan en la cola se borran despu s de la re implementaci n del servicio de colas si el atributo del servicio de colas contiene un atributo cl ster diferente Si se configura como false predeterminado todos los mensajes se reservan 34 Cap tulo 5 Configuraci n A Advertencia Consideraciones al volver a implementar A Cuando vuelve a implementar un destino debe apagar todos los nodos en el cl ster realizar los cambios apropiados a la configuraci n y luego re iniciar los nodos El volver a implementar desde la cola sin cl sters a una cola con cl sters requiere que configure el atributo cl ster como true y debe agregar la configuraci n de servicio de cola para cada nodo El volver a implementar desde una cola con cl sters a una sin cl sters requiere que configure el atributo cl ster como false en una de las configuraciones de cola y debe borrar las otras colas en el cl ster 5 7 2 1 1 Configuraci n de seguridad del destino lt SecurityConfig gt determina que roles se permite leer escribir y crear en el destino Tiene exactamente la misma sintaxis y sem ntica que la configuraci n de seguridad en destinos JBossMQ lt SecurityConfig gt lt security gt lt role read true write true create true gt lt security gt lt SecurityConfig gt El elemento lt SecurityConfig gt debe contener un elemento lt se
59. m1 para cada ejemplo proporciona los detalles de configuraci n la salida esperada y resoluci n de problemas simples Importante Ejemplos en clusters Los ejemplos con cl sters requieren que dos instancias de JBoss Enterprise Application Platform est n ejecutando con nombres de cl stersy puertos correctamente configurados El readme html para cada ejemplo proporciona los detalles de configuraci n las salidas que se esperan y resoluci n de problemas simples Cap tulo 5 Configuraci n Cap tulo 5 Configuraci n El API JMS del ingl s Java Message Service especifica la manera en que un cliente de mensajer a interact a con un servidor de mensajer a La manera en que los servicios de mensajer a tal como los destinos de mensajes y las f bricas de conexiones se definen y se implementan depende del proveedor JMS JBoss Messaging tiene sus propios archivos para configuraci n de servicios Este cap tulo le muestra la manera de configurar varios servicios disponibles en JBoss Messaging que funcionan juntos para proporcionar servicios a nivel de API JMS para las aplicaciones cliente La configuraci n de JBoss Messaging abarca varios archivos de configuraci n Dependiendo de la funcionalidad que brindan los servicios que configura los datos de configuraci n se distribuyen entre messaging service xml remoting bisocket service xml xxx persistence service xml en donde xxx es el nombre de su base de datos connection factories
60. me CreateTablesOnStar tup gt true lt attribute gt lt attribute name SqlProperties gt CREATE_USER_TABLE CREATE TABLE JBM_USER USER_ID VARCHAR 32 NOT NULL PASSWD VARCHAR 32 NOT NULL CLIENTID VARCHAR 128 PRIMARY KEY USER_ID ENGINE INNODB CREATE_ROLE_TABLE CREATE TABLE JBM_ROLE ROLE_ID VARCHAR 32 NOT NULL USER_ID VARCHAR 32 NOT NULL PRIMARY KEY USER_ID ROLE_ID ENGINE INNODB SELECT_PRECONF_CLIENTID SELECT CLIENTID FROM JBM_USER WHERE USER_ID POPULATE TABLES 1 INSERT INTO JBM_USER USER_ID PASSWD CLIENTID VALUES jdoe jdoepw jdoe id lt attribute gt lt mbean gt 5 6 1 Atributos Bean administrados JMSUserManager CreateTablesOnStartup Especifica si se intenta crear las tablas e ndices cuando inicia el MBean JMSUserManager Cuando se configura como true valor predeterminado el JMSUserManager tratar de crear las tablas e ndices en el arranque Si las tablas o ndices ya existen el controlador JDBC presentar una SQLException y el administrador de presistencia la ignorar permiti ndole continuar sin problemas UsingBatchUpdates Especifica si m ltiples actualizaciones de la base de datos se agrupan en grupos para mejorar el rendimiento Configure este valor como true si su base de datos soporta actualizaciones en grupo JDBC El valor predeterminado es false SQLProperties Especifica el DDL y el DML para una base de datos en particular Si una declaraci n DDL o DML en particu
61. n enlaces a los componentes relacionados de JBoss Messaging 6 1 Id nico del servidor compa ero En la mayor a de los casos JBoss Messaging funciona en un entorno con cl sters con cambios m nimos en la configuraci n Un cambio crucial que se debe realizar es el asignar un id nico de servidor a cada nodo Todo nodo desplegado debe tener un id nico incluyendo aquellos nodos que forman un cl ster LAN y los nodos enlazados por puentes de mensajes 6 2 Destinos con cl sters JBoss Messaging pone en cl sters colas y temas JMS del ingl s Java Message Service de manera transparente a trav s del cl ster Los mensajes enviados a un tema o a una cola distribu da en un nodo son consumibles en otros nodos Para hacer un destino en particular en cl ster se utiliza el atributo para mayor informaci n JBoss Messaging balancea los mensajes entre nodos satisfaciendo consumidores con diferentes velocidades de manera que el procesamiento de cargas se pueda distribuir eficiente a trav s del cl ster Para inhabilitar la redistribuci n de mensajes entre nodos pero si a n quiere retener las otras caracter sticas de los destinos en cl sters no especifique el atributo 6 3 Subscripciones durables en cl sters Las subscripciones durables de JBoss Messaging tambi n se pueden poner en cl sters de manera que le permite a m ltiples subscriptores en m ltiplos nodos consumir de una subscripci n durable Una subscrici n durable se pon
62. n y lanzamiento Cada palabra es un marcador de posici n ya sea de texto a ingresar cuando se ejecuta un comando o para un texto ejecutado por el sistema Aparte del uso est ndar para presentar el t tulo de un trabajo las italicas denotan el primer uso de un t rmino nuevo e importante Por ejemplo Publican es un sistema de publicaci n de DocBook 1 2 Convenciones del documento Los mensajes de salida de la terminal o fragmentos de c digo fuente se distinguen visualmente del texto circundante Los mensajes de salida enviados a una terminal se muestran en romano monoespaciado y se presentan as books Desktop documentation drafts mss photos stuff svn books_tests Desktopi downloads images notes scripts svgs Los listados de c digo fuente tambi n se muestran en romano monoespaciado pero se presentan y resaltan de la siguiente manera JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging package org jboss book jca ex1 import javax naming InitialContext public class ExClient public static void main String args throws Exception InitialContext iniCtx new InitialContext Object ref iniCtx lookup EchoBean EchoHome home EchoHome ref Echo echo home create System out println Created Echo System out println Echo echo Hello echo echo Hello be 1 3 Notas y Advertencias Finalmente utilizamos tres estilos visuales para llamar la atenci n sobre la inf
63. ncionalidades de cl sters Colas y temas completamente en cl sters Los temas y colas l gicas se distribuyen a trav s del cl ster Puede enviar o recibir una cola o un tema desde y hacia cualquier nodo en el cl ster Subscripciones durables completamente en cl sters JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Una subscripci n durable en particular se puede acceder desde cualquier nodo del cl ster lo cual le permite distribuir la carga de procesamiento desde esa subscripci n a trav s de todo el cl ster Colas temporales completamente en cl sters Si un mensaje enviado incluye el replyTo de una cola temporal se puede retornar en cualquier nodo del cl ster Redistribuci n inteligente de mensajes Los mensajes se mueven de manera autom tica entre nodos del cl ster para tomar ventaja de las diferentes velocidades del consumidor en diferentes nodos Esto ayuda a prevenir el hambre o la acumulaci n de mensajes en un nodo en particular Protecci n del orden de mensajes Habilite esto para asegurarse de que el orden de los mensajes generados por un productor es id ntico al orden de los mensajes consumidos por un consumidor Esto funciona incluso si la redistribuci n de mensajes est activa gt Conmutaci n de servidores en caso de fallo de manera completamente transparente Cuando un servidor falla sus sesiones continuan sin excepciones en un nuevo nodo Esto es completamente config
64. nds gt lt depends gt jboss messaging service PostOffice lt depends gt lt attribute name JNDIBindings gt lt bindings gt lt binding gt MyConnectionFactory lt binding gt lt binding gt XAComectionFactory lt binding gt lt binding gt java MyConnectionFactory lt binding gt lt binding gt java XAConnectionFactory lt binding gt lt bindings gt lt attribute gt lt This are the two properties gt lt attribute name EnableOrderingGroup gt true lt attribute gt lt attribute name DefaultOrderingGroupName gt MyOrderingGroup lt attribute gt lt mbean gt La ventaja de habilitar la funcionalidad del grupo de ordenamiento al realizar cambios en la configuraci n es la facilidad con la que se puede lograr la funcionalidad de ordenamiento de mensajes sin la necesidad de cambiar el c digo 9 2 Notas y limitaciones Debe notar los siguientes puntos con relaci n a la funcionalidad del grupo de ordenamiento Las colas se tienen que utilizar con la funcionalidad del grupo de ordenamiento La funcionalidad no servir con temas La funcionalidad del grupo de ordenamiento no se debe utilizar junto con selectores de mensajes ni la entrega programada Un mensaje se considera completo y el siguiente mensaje estar disponible para la entrega si el mensaje original est muerto o si ha caducado Un mensaje muerto se mueve al DLQ mientras que un mensaje caducado se mueve a la ExpiryQueue Al utilizar un Connect
65. nlazada a los siguientes contextos JNDI ClusteredConnectionFactory ClusteredXAConnectionFactory java ClusteredConnectionFactory java ClusteredXAConnectionFactory Si quiere brindar un ID de cliente predeterminado para una f brica de conexiones o si quiere enlazarla a diferentes locationConsider JNDI entonces configure e implemente f bricas de conexiones diferentes Para implementar una nueva f brica de conexiones configure un nuevo bean administrado ConnectionFactory en connection factories service xml Tambi n es posible crear un nuevo descriptor de despliegue de servicios lt name gt service xml y desplegarla en JBOSS_HOME server messaging deploy Habilita el soporte para la conmutaci n de servidores autom tica en caso de fallo o el balanceo de carga configurando los atributos relevantes en su f brica de conexiones 41 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Ejemplo 5 1 F brica de conexiones Esta f brica de conexiones de ejemplo crea una f brica de conexi n con el ID del cliente preconfigurado myClientID el cual est enlazado a dos lugares en el rbol JNDI MyConnectionFactory y factories cf El ejemplo sobreescribe los siguientes valores predeterminados PreFetchSize DefaultTempQueueFullSize DefaultTempQueuePageSize DefaultTempQueueDownCacheSize DupsOKBatchSize SupportsFailover SupportsLoadBalancing LoadBalancingFactory La fabrica de conexiones usa el conect
66. or remoto predeterminado Para utilizar un conector remoto diferente con la fabrica de conexiones cambiel el atributo Connector para especificar el nombre del servicio del conector que desea utilizar 42 Cap tulo 5 Configuraci n lt mbean code org jboss jms server connectionfactory ConnectionFactory name jboss messaging connectionfactory service MyConnectionFactory xmbean dd xmdesc ConnectionFactory xmbean xm1 gt lt depends optional attribute name ServerPeer gt jboss messaging service ServerPeer lt depends gt lt depends optional attribute name Connector gt jboss messaging service Comnector transport bisocket lt depends gt lt depends gt jboss messaging service Post0ffice lt depends gt lt attribute name JNDIBindings gt lt bindings gt lt binding gt MyConnectionFactory lt binding gt lt binding gt factories cf lt binding gt lt bindings gt lt attribute gt lt attribute name ClientID gt myClientID lt attribute gt lt attribute name SupportsFailover gt true lt attribute gt lt attribute name SupportsLoadBalancing gt false lt attribute gt lt attribute name LoadBalancingFactory gt org acme MyLoadBalancingFactory lt attribute gt lt attribute name PrefetchSize gt 1000 lt attribute gt lt attribute name SlowConsumers gt false lt attribute gt lt attribute name StrictTck gt true lt attribute gt lt attribute name SendAcksAsync gt false lt attribute gt lt at
67. ormaci n que de otro modo se podr a pasar por alto Una nota es una sugerencia atajo o enfoque alternativo para una tarea determinada Ignorar una nota no deber a tener consecuencias negativas pero podr a perderse de algunos trucos que pueden facilitarle las cosas Importante Los cuadros con el t tulo de importante dan detalles de cosas que se pueden pasar por alto f cilmente cambios de configuraci n nicamente aplicables a la sesi n actual o servicios que necesitan reiniciarse antes de que se aplique una actualizaci n Ignorar estos cuadros no ocasionar p rdida de datos pero puede causar enfado y frustraci n Las advertencias no deben ignorarse Ignorarlas muy probablemente ocasionar p rdida de datos 2 C mo obtener ayuda y hacer sus comentarios 2 1 Necesita ayuda Si encuentra dificultades con alguno de los procedimientos descritos en este documento visite el Portal y buscar o navegar a trav s de la base de art culos de soporte t cnico sobre productos de Red Hat enviar un caso de soporte a Servicios de Soporte Global de Red Hat GSS y acceder a otra documentaci n del producto Red Hat alberga una lista grande de correos electr nicos para discutir sobre software de Red Hat y tecnolog a Encontrar un listado de las listas de correo disponibles al p blico en o Prefacio para acceder a los archivos de listados 2 2 Necesitamos sus comentarios Si encuentra algun error o si se le o
68. oting service deployment descriptor Id remoting bisocket service xml 3981 2008 03 28 18 00 41Z timfox gt lt server gt lt Standard bisocket connector the bisocket transport only opens connection from client gt server so can be used with firewalls where only outgoing connections are allowed For examples of HTTP and SSL transports see docs examples gt lt mbean code org jboss remoting transport Connector name jboss messaging service Connector transpor t bisocket display name Bisocket Transport Connector gt lt attribute name Configuration gt lt config gt lt invoker transport bisocket gt lt There should be no reason to change these parameters warning Changing them may stop JBoss Messaging working correctly gt lt attribute name marshaller isParam true gt org jboss jms wireformat JMSwWireFormat lt attribute gt lt attribute name unmarshaller isParam true gt org jboss jms wireformat JMSWireFormat lt attribute gt lt attribute name dataType isParam true gt jms lt attribute gt lt attribute name socket check_connection isParam true gt false lt attribute gt lt attribute name serverBindAddress gt jboss bind address lt attribute gt lt attribute name serverBindPort gt jboss messaging connector bisocket port 4457 lt attribute gt lt attribute name clientSocketClass isParam true gt org jboss jms client remoting ClientSocketWrapper lt attribute gt
69. overy Esta secci n describe la manera de configurar JBoss Transactions en JBoss Enterprise Application Platform para manejar la recuperaci n XA para recursos de JBoss Messaging El administrador de recuperaci n de transacciones de JBoss se puede configurar para sondear continuamente y poder recuperar recusos de JBoss Messaging XA Esto proporciona un alto nivel de durabilidad de transacciones Para habilitar el administrador de recuperaci n de transacciones de JBoss agr guele una l nea a JBOSS_HOME server PROFILE conf jbossts properties xml El siguiente pedazo de c digo incluye la l nea requerida lt properties depends arjuna name jta gt lla Support subtransactions in the JTA layer Default is NO aa lt property name com arjuna ats jta supportSubtransactions value NO gt lt property name com arjuna ats jta jtaTMImplementation value com arjuna ats internal jta transaction arjunacore TransactionManagerImple gt lt property name com arjuna ats jta jtaUTImplementation value com arjuna ats internal jta transaction arjunacore UserTransactionImple gt lls Add this line to enable recovery for JMS resources using DefaultJMSProvider aes lt property name com arjuna ats jta recovery XAResourceRecovery JBMESSAGING1 value org jboss jms server recovery MessagingXAResourceRecovery java DefaultJMSPr ovider gt lt properties gt Aqu el administrador de recuperaci n trata de recuperar
70. que no est siendo utilizado Consulte la documentaci n del servidor Microsoft SQL para ver los comandos DBCC ShrinkDatabase y UpdateUsage para obtener informaci n sobre c mo reclamar el espacio no utilizado Para 5 5 1 Atributos MBean PersistenceManager Los siguientes atributos est n disponibles para configurar el MBean administrador de persistencia CreateTablesOnStartup Especifica si debe intentar la creaci n de tablas e ndices cuando se inicia el administrador de persistencia Cuando esta configurado como true por defecto el administrador de persistencia intentar crear tablas e ndices cuando inicia Si las tablas o ndices ya existen el controlador JDBC presentar una SQLException y el administrador de persistencia lo ignorar permiti ndole continuar UsingBatchUpdates Especifica si m ltiples actualizaciones de la base de datos se deben agrupar para mejorar el rendimiento Configure este valor como true si su base de datos soporta actualizaciones en grupos JDBC El valor predeterminado es false UsingBinaryStream Especifica si los mensajes se almacenan y leen con un flujo binario JDBC en lugar de por medio de getBytes y setBytes Configure este valor como false si su base de datos debe utilizar getBytes y setBytes El valor predeterminado es true UsingTrailingByte Especifica la manera en que se deben manejar los BLOBs de la base de datos Sybase que contienen ceros al final Cuando se configura como true se a
71. r un ExceptionListener JMS para atrapar excepciones de manera asincr nica Cuando se atrapa una conexi n el c digo del lado del cliente debe buscar una nueva f brica de conexiones utilizando HAJNDI y recrea la conexi n DisableRemotingChecks Especifica si la f brica de conexiones chequea que el JBoss Remoting Connector correspondiente tenga valores sensatos JBoss Messaging es muy sensible a estos valores y casi nunca hay necesidad de cambiarlos Para desactivar tal chequeo de sanidad configure DisableRemotingChecks como false El valor predeterminado es truen In Y WI No inhabilite los chequeos remotos inestabilidad del sistema LoadBalancingFactory Especifica la implementaci n de la f brica de balanceo de carga del lado del cliente que la f brica de conexiones utiliza El valor debe corresponder al nombre de una clase que implementa la interfaz org jboss jms client plugin LoadBalancingFactory El valor predeterminado es org jboss jms client plugin RoundRobinLoadBalancingFactory el cual balancea la carga de conexiones a trav s del cl ster de una manera equitativa Conector Especifica el conector remoto que la f brica de conexiones utiliza Diferentes f bricas de conexiones pueden utilizar diferentes conectores as que puede desplegar una f brica de conexiones que use el transporte HTTP para comunicarse con el servidor y otra que utilice el transporte bisocket para comunicar EnableOrderingGroup Especifica si el or
72. recuperar un sub grupo de mensajes en la cola que coinciden con los criterios dados ListDurableMessages Lista todos los mensajes durables en la cola Utilizando un selector JMS como argumento en esta operaci n le permite recuperar un subgrupo de mensajes en la cola que coinciden con los criterios dados ListNonDurableMessages Lista todos los mensajes no durables en la cola Utilizando un selector JMS como argumento le permite recuperar un subgrupo de mensajes en la cola que coinciden con los criterios dados ResetMessageCounter Reestablece el contador de mensajes a cero 36 Cap tulo 5 Configuraci n ResetMessageCounterHistory Reestablece el historial del contador de mensajes ListMessageCounterAsHT ML Lista el contador de mensajes en un formato HT ML ListMessageCounterHistoryAsHTML Lista el historial del contador de mensajes en un formato HT ML 5 7 3 Configuraci n de temas 5 7 3 1 Atributos Bean administrados por temas Nombre Define el nombre del tema JNDIName Define la ubicaci n JNDI en donde se enlaza el tema DLQ Define el DLQ del ingl s Dead Letter Queue utilizado para este tema Sobreescribe cualquier valor en el archivo de configuraci n del servidor comapero ExpiryQueue Define la cola de expiraci n utilizada para este tema Sobreescribe cualquier valor establecido en el archivo de configuraci n del servidor compa ero RedeliveryDelay Define el periodo de retraso entre los intentos de
73. recursos JMS utilizando el JMS Provider Loader DefaultJMSProvider DefaultJMSProvider se env a junto con JBoss Enterprise Application Platform Se define en JBOSS_HOME server PROFILE conf jms ds xml or in a clustered environment hajndi jms ds xml Para realizar la recuperaci n con un cargador proveedor JMS diferente por ejemplo uno que corresponda con un proveedor JMS remoto agregue otra l nea al archivo de propiedades y especifique su proveedor remoto en lugar de DefaultJMSProvider el nombre de su proveedor se debe listar en su archivo de configuraci n bean administrado Cada proveedor requiere un nombre nico por ejemplo com arjuna ats jta recovery XAResourceRecovery JBMESSAGING1 com arjuna ats jta recovery XAResourceRecovery JBMESSAGING2 etc La recuperaci n debe funcionar con cualquier proveedor JMS que implemente XAResources recuperables por ejemplo implementa apropiadamente XAResource recover Para que el administrador de recuperaci n recupere desde cualquier nodo del cl ster es necesario agregar una l nea en Ihajndi jms ds xml para todos los nodos del cluster 53 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Cap tulo 8 Configuraci n del puente de mensajes de JBoss Messaging 8 1 Sinopsis del puente de mensajes JBoss Messaging incluye un puente de mensajes completamente funcional El puente consume mensajes de una cola fuente o tema y los env a a una cola dest
74. reescribir este valor destino por destino como se puede ver en la secci n sobre la configuraci n del bean administrado de destino Una cola de expiraci n mantiene los mensajes que han expirado La expiraci n de un mensaje est determinada por el valor de Message getJMSExpiration Si la cola de expiraci n no se especifica entonces el mensaje se borrar despu s de que ha expirado DefaultRedeliveryDelay Este atributo le permite retrasar un intento de re entrega lo cual ayuda a prevenir el acabar con la entrega fallo El valor predeterminado es 0 es decir no hay retraso Puede sobreescribir este valor destino por destino MessageCounterSamplePeriod Este atributo define el periodo de tiempo entre las peticiones del servidor a la cola en busca de estad sticas sobre la cola El valor predeterminado es 5000 milisegundos FailoverStartTimeout El n mero m ximo de milisegundos que el cliente esperar para que inicie la conmutaci n en caso de fallo en el lado del servidor cuando se detecta un problema El valor predeterminado es 60000 un minuto FailoverCompleteTimeout El n mero m ximo de milisegundos que el cliente esperar para que complete la conmutaci n en caso de fallo en el lado del servidor despu s de que ha iniciado la conmutaci n de servidores El valor predeterminado es 300000 cinco minutos 18 Cap tulo 5 Configuraci n DefaultMessageCounterHistoryDayLimit JBoss Messaging proporciona un historia
75. rise 13 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Application Platform JBOSS_HOME docs examples jboss messaging examples distributed topic Este ejemplo demuestra un cliente JMS interactuando con un tema distribu do de JBoss Messaging Para ejecutar este ejemplo se requiere dos instancias de JBoss Enterprise Application Platform se encuentren ejecutando JBOSS_HOME docs examples jboss messaging examples servlet Este ejemplo demuestra c mo utilizar el transporte servlet con JBoss Messaging Implementa un servlet y una ConnectionFactory la cual utiliza el transporte servlet JBOSS_HOME docs examples jboss messaging examples ordering group Este ejemplo demuestra el uso del ordenamiento estricto de mensajes Usa la API del grupo de ordenamiento de JBoss Messaging para entregar mensajes estrictamente ordenados sin importar la prioridad de los mensajes JBOSS_HOME docs examples jboss messaging examples bridge Este ejemplo demuestra el uso de un puente de mensajes Despliega un puente de mensajes dentro de JBoss Enterprise Application Platform el cual mueve los mensajes desde una cola fuente a una destino Familiaricese con los ejemplos para ganar una buena comprensi n de JBoss Messaging Y Importante Ejemplos sin clusters Los ejemplos sin cl sters esperan que una instancia de JBoss Enterprise Application Platform est ejecutando con todos los valores predeterminados El readme ht
76. rue then will use JDBC batch updates gt lt attribute name UsingBatchUpdates gt false lt attribute gt lt The maximum number of parameters to include in a prepared statement gt lt attribute name MaxParams gt 500 lt attribute gt lt mbean gt 29 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging El tama o m ximo de los tipos de datos de imagen y texto de la base de datos Sybase se configura como 2 kilobytes por defecto Cualquier mensaje que exceda este l mite es truncado sin ninguna informaci n o advertencia Configure el par metro de la base de datos TEXTSIZE con un valor m s alto para prevenir que potencialmente se trunquen los mensajes Este truncado tambi n puede tener lugar en el servidor Microsoft SQL Server si el valor TEXTSIZE se establece como un valor menor que el valor predeterminado Para mayor El servidor Microsoft SQL no desasigna autom ticamente el espacio de disco duro cuando se borran datos de una base de datos Cuando se utiliza el espacio de la base de datos del disco duro como almacenamiento de datos para un servicio que almacena temporalmente muchos registros tal como el servicio de mensajer a el espacio de disco se volver mucho m s grande m s r pidamente que la cantidad de datos que de hecho se est almacenando Los administradores de la base de datos deben implementar planes de mantenimiento de la base de datos para asegurarse de reclamar el espacio
77. s conexiones a los servidores fuente o destino despu s de detectar fallos El puente parar de intentar recrear la conexi n Un valor de 1 significa que el puente tratar de reconectarse indefinidamente AddMessagelDinHeader Cuando es true el id del mensage original se a adir en el encabezado de JBossMessage JBOSS_MESSAGING_BRIDGE_MESSAGE_ID_LIST del mensaje que se est enviando al destino Si se realiza un puente para el mensaje m s de una vez entonces se a adir el de ID de cada mensaje al encabezado Esto activa un patr n de petici n respuesta 59 60 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging distribu do Cap tulo 9 Habilitaci n del grupo de ordenamiento de JBoss Messaging Cap tulo 9 Habilitaci n del grupo de ordenamiento de JBoss Messaging Esta secci n describe la manera de utilizar la funcionalidad del grupo de ordenamiento de JBoss Messaging para lograr un ordenamiento de mensajes estricto Los grupos de ordenamiento de mensajes es la implementaci n de JBoss Messaging del ordenamiento estricto de mensajes Cuando se habilita la funcionalidad del grupo de ordenamiento las prioridades del mensaje ya no influencian el orden en que los mensajes se entregan Los mensajes en un grupo de ordenamiento particular se entregar n en el orden exacto en que llegan a la cola destino Los grupos de ordenamiento est n identificados por sus nombres en cadena y siguen las siguientes r
78. s de paginaci n para los destinos de tama o cach temporal los cuales van para las conexiones creadas con esta f brica de conexiones El valor predeterminado es 2000 Para obtener mayor informaci n sobre estos atributos consulte DupsOKBatchSize Especifica el numero de reconocimientos DUPS_OK_ACKNOWLEDGE que se mandan al buffer localmente antes de enviarlos El valor predeterminado es 2000 SupportsLoadBalancing Especifica si el balanceo de carga del lado del cliente se encuentra activado en una fabrica de conexiones Si si est habilitado entonces cualquier conexi n creada con esa f brica de conexiones tendr balanceo de carga a trav s de los nodos del cl ster Una vez se crea una conexi n en un nodo en particular esta permanece en ese nodo El valor predeterminado es false SupportsFailover Especifica si la conmutaci n autom tica de servidores en caso de fallos del lado del cliente est habilitada para la f brica de conexiones en instalaciones con cl sters Si la conmutaci n autom tica est habilitada entonces JBoss Messaging de manera autom tica y transparente Cap tulo 5 Configuraci n conmutar en caso de fallo a otro nodo en el cl ster cuando se detecte un problema en la conexi n El valor predeterminado es false Cuando la conmutaci n autom tica en caso de fallo est inhabilitada el c digo del usuario es el responsable de atrapar excepciones de conexiones en operaciones JMS sincr nicas y debe instala
79. sajes programados en la cola Este es el n mero de mensajes programados para que sean entregados en una fecha posterior La entrega programada le permite especificar el momento m s temprano en el que se entregar un mensaje en particular Por ejemplo puede enviar un mensaje ahora y especificar que no se entregue sino hasta dentro de dos horas Para lograr esto configure lo siguiente en el encabezado del mensaje long now System currentTimeMillis Message msg sess createMessage msg setLongProperty JBossMessage JMS_JBOSS_SCHEDULED_DELIVERY_PROP_NAME now 1000 60 60 2 prod send msg MaxSize Se especifica el n mero m ximo de mensajes que se pueden mantener en una cola Cualquier mensaje que llegue despu s de este punto se borrar Por defecto es 1 que significa desvinculado Clustered Este atributo se debe configurar como true si el destino es un cl ster MessageCounter Cada cola mantiene un contador de mensajes MessageCounterStatistics Las estadisticas para el contador de mensajes MessageCounterHistoryDayLimit El numero maximo de dias que se mantiene el historial del contador de mensajes Sobreescribe cualquier valor establecido en el archivo de configuraci n del servidor compa ero ConsumerCount El n mero de consumidores actualmente consumiendo de la cola DropOldMessageOnRedeploy Especifica la manera en que se manejan los servicios de cola con los atributos del cl ster que difieren de
80. se Application Platform 5 Manual del usuario de JBoss Messaging que esto pero estos se paginan para el almacenamiento y desde l cuando sea necesario en el momento que se a adan o se consuman los mensajes Si no se especifica el valor predeterminado es 75000 PageSize Especifica el n mero m ximo de mensajes que se pre cargan por operaci n al cargar los mensajes desde la cola o suscripci n Si no se especifica un valor entonces el predeterminado es 2000 DownCacheSize Especifica el n mero m ximo de mensajes que el Down Cache mantiene antes de que los mensajes se vac en al almacenamiento El valor predeterminado es 2000 mensajes Al paginar mensajes al almacenamiento desde la cola primero van a un Down Cache antes de escribirlos en el almacenamiento Esto activa la escritura para que ocurra como una sola operaci n lo cual ayuda al rendimiento Si quiere especificar los par metros de paginaci n utilizados para colas temporales entonces necesita especificarlos en la f brica de conexiones apropiada Consulte las diferentes f bricas de conexiones disponibles 5 7 2 1 3 Operaciones Bean administradas en cola RemoveAllMessages Remueve y borra todos los mensajes de la cola Importante Utilice esto con precauci n ya que borrar permanentemente todos los mensajes de la cola ListAllMessages Lista todos los mensajes actualmente en la cola Utilizando un selector JMS como argumento en esta operaci n le permite
81. se_outgoing_packet_handler false down_thread false up_thread false enable_bundling false use_send_queues false sock_conn_timeout 300 skip_suspected_members true gt lt MPING timeout 4000 bind_to_all_interfaces true mcast_addr jboss messaging datachanneludpaddress 228 6 6 6 mcast_port jboss messaging datachanneludpport 45567 i ls ge num_initial_members 2 num_ping_requests 1 gt lt MERGE2 max_interval 100000 down_thread false up_thread false min_interval 20000 gt lt FD_SOCK down_thread false up_thread false gt lt VERIFY_SUSPECT timeout 1500 down_thread false up_thread false gt lt pbcast NAKACK max_xmit_size 60000 use_mcast_xmit false gc_lag 0 retransmit_timeout 300 600 1200 2400 4800 down_thread false up_thread false discard_delivered_msgs true gt lt pbcast STABLE stability_delay 1000 desired_avg_gossip 50000 down_thread false up_thread false max_bytes 400000 gt lt pbcast GMS print_local_addr true join_timeout 3000 down_thread false up_thread false join_retry_timeout 2000 shun false view_bundling true gt lt config gt Cap tulo 5 Configuraci n JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging lt attribute gt lt JGroups stack configuration to use for the control channel used for control messages gt lt We use udp sta
82. service xml y destinations service xml Las pilas del interceptor AOP se configuran en aop messaging client xml para el comportamiento del lado del cliente y aop messaging server xml para el comportamiento del lado del servidor Usualmente no hay necesidad de cambiar estos archivos pero algunos de los interceptores se pueden remover para mejorar el rendimiento en caso de que no los necesite Antes de remover el interceptor de seguridad tenga en consideraci n las implicaciones en la seguridad 5 1 Configuraci n del ServerPeer El ServerPeer es el coraz n de la fachada de JBoss Messaging JMS Puede configurar su comportamiento modificando JBOSS_HOME server PROFILE deploy messaging messaging service xml Todos los servicios de JBoss Messaging se basan en el ServerPeer A continuaci n encontrar un ejemplo de una configuraci n de un servidor compa ero Observe que no todos los valores para los atributos del servidor compa ero se especifican en el ejemplo 15 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging lt ServerPeer MBean configuration lt mbean code org jboss jms server ServerPeer 16 name jboss messaging service ServerPeer xmbean dd xmdesc ServerPeer xmbean xml gt lt The unique id of the server peer in a cluster each node MUST have a unique value must be an integer gt lt attribute name ServerPeerID gt jboss messaging ServerPeer1D 0 lt attribute
83. specificar el n mero m ximo de mensajes que se pueden almacenar en la memoria en cualquier momento cola por cola o tema por tema Luego JBoss Messaging pagina los mensajes hacia y desde el almacenamiento de manera transparente en bloques permiti ndoles crecer a las colas y a las subscripciones hasta tama os muy grandes sin ninguna disminuci n en el rendimiento ya que el tama o del canal se incrementa Esto se ha probado con colas por encima de diez millones de mensajes de 2 kilobytes en hardware muy b sico y tiene el potencial de escalar a n mero de mensajes mucho m s grandes Los par metros individuales asociados con los canales paginables son los siguientes FullSize Especifica el numero maximo de mensajes que las subscripciones de tema o cola mantienen en la memoria en cualquier momento La cola misma puede mantener muchos mas mensajes que esto pero estos se paginan para el almacenamiento y desde l cuando sea necesario en el momento que se a adan o se consuman los mensajes Si no se especifica el valor predeterminado es 75000 PageSize Especifica el n mero m ximo de mensajes que se pre cargan por operaci n al cargar los mensajes desde la cola o suscripci n Si no se especifica un valor entonces el predeterminado es 2000 DownCacheSize Especifica el n mero m ximo de mensajes que el Down Cache mantiene antes de que los mensajes se vac en al almacenamiento El valor predeterminado es 2000 mensajes Al paginar mensa
84. ssword en el SecurityMetadataStore El SuckerPassword se tiene que cambiar en el momento de la instalaci n o de otra manera se utilizar la contrase a predeterminada Cualquier persona que conozca la contrase a predeterminada podr ganar acceso a cualquier destino en el servidor SuckerConnectionRetryTimes Este es el n mero m ximo de veces que se le permite reintentar a la conexi n de un sucker en caso de un fallo El valor predeterminado es 1 el cual representa re intente indefinidamente n t n SuckerConnectionRetrylnterval Este es el intervalo en milisegundos entre cada intento de la conexi n del sucker fallido El valor predeterminado es 5000 StrictTck Para habilitar la semantica T CK del ingl s Technology Compatibility Kit JMS estricta configure este atributo como true 19 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging Destinos Retorna una lista de los destinos colas y temas actualmente desplegados MessageCounters Un contador de mensajes para una cola en particular MessageStatistics Estadisticas sobre cada contador de mensajes para cada cola SupportsFailover Cuabndo este atributo es false la conmutaci n de servidores en caso de fallo del lado del servidor no ocurre cuando un nodo se cuelga en un cl ster PersistenceManager Este es el administrador de persistencia que el ServerPeer utiliza normalmente no es necesario que cambie este atributo JMSUser
85. tal enruta los mensajes a su destino o destinos Mantiene los mapeos entre direcciones a las cuales se puede enviar el mensaje y la cola final Por ejemplo cuando al enviar un mensaje con una direcci n que representa una cola JMS la oficina postal enruta el mensaje a esa cola JMS Al enviar un mensaje con una direcci n que representa un tema JMS la oficina postal enruta el mensaje a un grupo de colas uno para cada subscripci n JMS La oficina postal tambi n maneja la persistencia para el mapeo de direcciones Las oficinas postales de JBoss Messaging tienen en cuenta los cl sters En un cl ster enrutar n de manera autom tica y obtendr n mensajes entre nodos con el fin de proporcionar temas y colas JMS completamente distribu das Configure la oficina postal en el archivo lt database type gt persistence service xml Por ejemplo 23 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging lt mbean code org jboss messaging core jmx MessagingPostO0fficeService 24 name jboss messaging service PostOffice xmbean dd xmdesc MessagingPostOf fice xmbean xm1 gt lt depends optional attribute name ServerPeer gt jboss messaging service ServerPeer lt depends gt lt depends gt jboss jca service DataSourceBinding name DefaultDS lt depends gt lt depends optional attribute name TransactionManager gt jboss service TransactionManager lt depends gt lt The name of the post offi
86. tino se encuentran en servidores diferentes puede implementar una alta 54 Cap tulo 8 Configuraci n del puente de mensajes de JBoss Messaging durabilidad del mensaje utilizando una transacci n JTA controlada por la implementaci n JTA de JBoss Transactions Si se requiere JTA ambas f bricas de conexiones deben ser implementaciones XAConnectionFactory Este modo solo est disponible para mensajes persistentes Este modo requiere el registro en el administrador de transacciones y en el lado del recurso para soportar la recuperaci n Si requiere este nivel de calidad del servicio entonces tiene que habilitar la recuperaci n XA con JBoss Transactions om M todos opcionales YEs posible que pueda aplicar la sem ntica una y solo una vez a una aplicaci n en especifico sin configurar QOS_ONCE_AND_ONLY_ONCE Establezca el modo QOS_DUPLICATES_OK y luego busque y descarte mensajes duplicados en el destino Puede implementar QOS_ONCE_AND_ONLY_ONCE a nivel de la aplicaci n manteniendo un cach de IDs de mensajes recibidos en el disco y comparando los mensajes recibidos en este cach El cach s lo ser v lido por un periodo de tiempo as que este enfoque no es tan infalible pero puede ser una opci n til dependiendo de su aplicaci n 8 2 Despliegue del puente Puede implementar un puente de mensajes agregando un descriptor bean administrado en el directorio deploy de su instalaci n de JBoss Enterprise Application Platform
87. tribute name DefaultTempQueueFullSize gt 50000 lt attribute gt lt attribute name DefaultTempQueuePageSize gt 1000 lt attribute gt lt attribute name DefaultTempQueueDownCacheSize gt 1000 lt attribute gt lt attribute name DupsOKBatchSize gt 10000 lt attribute gt lt mbean gt 5 8 1 Atributos del Bean administrado ConnectionFactory ClientID Puede pre configurar una f brica de conexiones con un ID de cliente Cualquier conexi n creada utilizando esta f brica de conexiones obtendr este ID de cliente JNDIBindings Lista de enlaces disponibles JNDI para esta fabrica de conexiones PrefetchSize Especifica cuantos mensajes puede tener una ventana en un momento dado para el control de flujo del consumidor El tama o de la ventana determina el n mero de mensajes que un servidor puede enviar a un consumidor sin bloquearse Cada consumidor mantiene un buffer de mensajes desde donde consume El protocolo de control de transmisi n TCP del ingl s Transmission Control Protocol implementa su propio control de flujo adicional El consumo de mensajes tambi n se puede 43 JBoss Enterprise Application Platform 5 Manual del usuario de JBoss Messaging bloquear si el tama o de la ventana TCP es menor que el par metro PrefetchSize SlowConsumers Especifica si el tama o de buffer permitido para los consumidores lentos se reduce El reducir el tama o del buffer para los consumidores lentos minimiza el incremento del pot
88. ual o mayor que el tiempo especificado showMessageDetails Presenta los detalles de un mensaje El ID del mensaje se utiliza para especificar el mensaje que se va a presentar commitPreparedTransaction Guarda manualmente los cambios de una transacci n preparada El Id de la transacci n se utiliza para especificar la transacci n que se va a guardar rollbackPreparedTransaction Deshace manualmente una transacci n preparada El ID de la transacci n se utiliza para especificar la transacci n que se va a deshacer Cap tulo 5 Configuraci n A Debe cambiar su base de datos La configuraci n predeterminada de persistencia funciona con Hypersonic HSQLDB de manera que las plataformas empresariales de JBoss Enterprise Platforms pueden ejecutar tal como vienen empacadas Sin embargo Hypersonic no se soporta en producci n y no se debe ustilizar en un entorno de producci n Los problemas conocidos con la base de datos Hypersonic incluyen No hay aislamiento de transacciones Fugas de sockest e hilos connection close no limpia los recursos n t n Calidad de persistencia y los registros usualmente se da an despu s de un fallo lo cual evita una recuperaci n autom tica Corrupci n de la base de datos Estabilidad bajo carga los procesos de la base de datos se detienen cuando hay demasiados datos No es viable en entornos con cl sters Consulte el cap tulo Using Other Databases en el Getting Started Guide para ma
89. uncionen con JBoss Messaging El modelo de datos de la base de datos es completamente diferente as que no intente utilizar JBoss Messaging con un esquema de datos JBoss MQ y vice versa 2 3 Propiedades del sistema que JBoss Messaging utiliza 2 3 1 support bytesld 10 Cap tulo 2 Introducci n Esta propiedad del sistema controla el comportamiento predeterminado al construir un objeto JBossMessage desde un objeto for neo de mensajes Establezca esta propiedad por medio de la l nea de comandos durante el arranque del servidor con la opci n D Si esta propiedad se configura como true entonces el constructor JBossMessage tratar de extraer el ID de correlaci n byte nativo de los encabezados for neos del mensaje Si se configura como false utilizar el tipo de cadena normal JMSCorrelationID Esta propiedad por defecto es true si no se establece o cuando se configura con algo diferente a true o false 2 3 2 retain oldxabehaviour Esta propiedad del sistema controla el tipo de excepci n que presenta un JMS XAResource en caso de que se llame el m todo prepare despu s de que se rompa la conexi n Establezca esta propiedad por medio de la l nea de comandos durante el arranque del servidor con la opci n D Si esta propiedad no se define entonces se presenta una XAException con un c digo de error XA_RBCOMMFALL De otra manera se presenta una XAException con un c digo de error XA_RETRY Debe notar que JBoss Messaging no define
90. urable si no quiere implementar este comportamiento de conmutaci n de servidores en caso de fallo puede desactivarlo y regresar a las excepciones y manualmente recrear las conexiones en un nuevo nodo Alta disponibilidad y conmutaci n no aparente del servidor en caso de fallos Si el nodo falla conmutar de manera autom tica a otro nodo y no perder ning n mensaje persistente y puede continuar con su sesi n sin ning n cambio aparente En todo momento se respeta la pol tica de entrega de mensajes de s lo una vez gt Puente de mensajes JBoss Messaging contiene un componente de puente de mensajes el cual le habilita a establecer puentes de mensajes entre dos destinos cualesquiera JMS1 1 Esto le permite conectar cl sters separados geogr ficamente formando grandes temas y colas l gicas globalmente distribu das 2 2 Compatibilidad con JBoss MQ JBoss MQ era la implementaci n de JMS enviada con Enterprise Application Platform 4 2 Ya que JBoss Messaging es compatible con JMS 1 1 y JMS 1 0 2b el c digo JMS escrito frente a JBoss MQ ejecutar con JBoss Messaging sin ning n cambio JBoss Messaging no tiene compatibilidad de formato con JBoss MQ as que es necesario actualizar los clientes JBoss MQ con JARs de clientes JBoss Messaging Aunque los descriptores de despliegue de JBoss Messaging son similares a los descriptores de despliegue de JBoss MQ no son id nticos as que necesitar n algunos ajustes simples para que f
91. ush_timeout 3000 gt auto_flush_conf false gt lt config gt lt attribute gt lt mbean gt 5 4 1 Atributos de la oficina postal Los siguientes atributos est n disponibles para configurar la oficina postal de mensajer a DataSource mcast_addr jboss messaging controlchanneludpaddress 228 7 7 7 down_thread false up_thread false num_initial_members 3 gt down_thread false up_thread false min_interval 20000 gt lt pbcast STABLE stability_delay 1000 desired_avg_gossip 50000 lt FRAG2 frag_size 60000 down_thread false up_thread false gt lt pbcast FLUSH down_thread false up_thread false timeout 20000 Especifica la fuente de datos para persistir los datos mapeados de la oficina postal 26 Cap tulo 5 Configuraci n SQLProperties Especifica el DDL y el DML para una base de datos en particular Si este atributo no se sobreescribe entonces se utilizar la configuraci n Hypersonic predeterminada A Hypersonic no se soporta para entornos de producci n Este valor se debe cambiar para uso en producci n CreateTablesOnStartup Especifica si las tablas e ndices se crean cuando se inicia el servicio de la oficina postal Cuando se establece como true la oficina postal crear las tablas e ndices al iniciar Si las tablas o los ndices ya existen el controlador JDBC presentar una excepci n SQLException y ser ignorada por el administrador de persistencia permit
92. yor informaci n El administrador de persistencia la oficina postal y el administrador de usuarios JMS interact an con el almacenamiento persistente El administrador de persistenccia maneja la persistencia relacionada con los mensajes La oficina postal maneja el enlace de la persistencia relacionada El administrador de usuarios JMS maneja la persistencia relacionada con los usuarios Todas las configuraciones para estos beans administrados se maneja en el archivo lt your database type gt persistence service xml Encontrar ejemplos de archivos de configuraci n para las bases de datos MySQL Oracle PostgreSQL Microsoft SQL Server y Sybase en el directorio jboss as docs examples jms del lanzamiento Para habilitar el soporte para una de estas bases de datos reemplace el archivo de configuraci n predeterminado jboss as server PROFILE deploy messaging hsqldb persistence service xml con el archivo de configuraci n especifico para el tipo de su base de datos y re inicie el servidor Por defecto los servicios de mensajer a que dependen de un almacenamiento de datos est n referenciando java DefaultDS para la fuente de datos Para implementar una fuente de datos con un nombre JNDI diferente entonces necesita actualizar todos los atributos DataSource en el archivo de configuraci n de persistencia En la distribuci n encontrar configuraciones de fuentes de datos de ejemplo 5 4 Configuraci n de la oficina postal La oficina pos

Download Pdf Manuals

Related Search

Related Contents

Yamaha CRW8824SX Series Owner's Manual  Red Hat Developer Toolset 2.x User Guide  User Manual - Stability Dynamics  HRConneCt USeR ManUaL  Manuale_utente_ DT60  Catalyst Dx Sample Preparation Poster  Manuale di istruzioni per l`uso e la manutenzione  Lenovo 41N5631 User's Manual  User manual  Betriebsanleitung  

Copyright © All rights reserved.

• https://telegra.ph/Calculate-Wire-Resistor-from-Voltage-Drop-6b946405-11-16
• https://telegra.ph/DC-Voltage-Drop-Calculator-f9261a07-11-16
• https://telegra.ph/Calculate-Wire-Resistor-from-Voltage-Drop-9080829c-11-16
• https://telegra.ph/Calculate-Current-from-Voltage-Drop-c5febbf9-11-16
• https://telegra.ph/Calculat-Wire-Area-From-Voltage-Drop-9769062c-11-16
• https://telegra.ph/Concrete-Volume-Calculator-for-Curbs-Gutters-69747c7f-11-16
• https://telegra.ph/Square-Column-Concrete-Volume-Calculator-7bce876f-11-17
• https://telegra.ph/Calculate-Current-from-Voltage-Drop-51a7616b-11-17
• https://telegra.ph/Wire-Size-Calculator-From-Voltage-Drop-a48513c6-11-18
• https://telegra.ph/Calculate-Wire-Resistor-from-Voltage-Drop-66a981ab-11-18