Capítulo 1 Notas de la versión

Versión 4.4 Update 1

Número de referencia 821-1512-10

Estas notas de la versión contienen información importante que está disponible en el momento del lanzamiento de Sun GlassFish Message Queue 4.4 Update 1. Además de tratarse otros temas, aquí se describen las funciones, las mejoras, las limitaciones y los problemas conocidos del producto. Antes de empezar a utilizar Message Queue 4.4 Update 1 lea este documento.

Estas notas de la versión también contienen información sobre las versiones 4.4, 4.3, 4.2, 4.1 y 4.0 de Message Queue. Por ejemplo, consulte Nuevas funciones de Message Queue 4.2, Nuevas funciones de Message Queue 4.1 y Nuevas funciones de Message Queue 4.0, respectivamente, para obtener información sobre las nuevas funciones de cada versión.

La versión más actualizada de estas notas de la versión se encuentra en el sitio web de documentación de Sun GlassFish Message Queue, http://docs.sun.com/coll/1307.7. Consulte el sitio web antes de instalar y configurar el software y, después, visítelo de forma periódica para ver los manuales y las notas de la versión más actualizados.

En estas notas de la versión se incluyen los siguientes apartados:

• Historial de revisiones de las notas de la versión

• Acerca de Message Queue 4.4 Update 1

• Plataformas y componentes compatibles con Message Queue 4.4 Update 1

• Nuevas funciones de Message Queue 4.4 Update 1 y versiones recientes

• Funciones que se eliminarán en futuras versiones

• Errores solucionados en Message Queue 4.4 Update 1 y versiones recientes

• Actualizaciones de documentación de Message Queue 4.4 Update 1

• Limitaciones y problemas conocidos

• Archivos redistribuibles

• Funciones de accesibilidad para personas con discapacidad

• Cómo informar sobre problemas y enviar comentarios

• Sun agradece sus comentarios

• Recursos adicionales de Sun

Este documento contiene referencias a direcciones URL de otras organizaciones para proporcionar información adicional relacionada.

Sun no se responsabiliza de la disponibilidad de las páginas web de otras empresas que se mencionan en este documento. Sun no avala ni se hace responsable del contenido, la publicidad, los productos ni otros materiales disponibles en dichos sitios o recursos, o a través de ellos. Sun tampoco se hace responsable de los daños o pérdidas, supuestos o reales, provocados por el uso o la confianza puesta en el contenido, los bienes o los servicios disponibles en dichos sitios o recursos, o a través de ellos.

Historial de revisiones de las notas de la versión

La siguiente tabla contiene una lista de las fechas de todas las versiones 4.x del producto Message Queue y describe los cambios realizados en este documento en relación a cada versión.

Acerca de Message Queue 4.4 Update 1

Sun GlassFish Message Queue es un servicio de mensajería completo que proporciona funciones fiables y asíncronas, conformes con la especificación Java Messaging Specification (JMS) 1.1. Además, Message Queue incluye funciones que van más allá de la especificación JMS para satisfacer las necesidades de las instalaciones en grandes empresas.

Message Queue 4.4 Update 1 es una versión secundaria que proporciona un nuevo programa de instalación basado en el sistema de empaquetado de imagen IPS independiente de la plataforma pkg(5). Además, versión 4.4 Update 1 incluye una serie de mejoras en las funciones y soluciones de errores.

Plataformas y componentes compatibles con Message Queue 4.4 Update 1

Esta sección cubre los siguientes temas relacionados con los requisitos del sistema para Message Queue 4.4 Update 1:

• Sistemas operativos compatibles

• Virtualización del sistema compatible

• Dependencias de componentes

Sistemas operativos compatibles

Message Queue 4.4 Update 1 es compatible con sistemas operativos Solaris, Linux, Windows y AIX. En la Tabla 1–2 se muestran las versiones compatibles de cada sistema operativo. Para obtener información sobre los requisitos de hardware de cada plataforma, consulte la Sun Java System Message Queue 4.3 Installation Guide

Virtualización del sistema compatible

La virtualización del sistema es una tecnología que permite que varias instancias del sistema operativo (SO) se ejecuten de forma independiente en un hardware compartido. Desde el punto de vista de la funcionalidad, el software ejecutado en un SO alojado en un entorno virtualizado no detecta, normalmente, que la plataforma subyacente se ha virtualizado. Sun realiza pruebas de sus productos de Sun Java System en determinadas combinaciones de SO y virtualización de sistemas para confirmar que los productos de Sun Java System siguen funcionando en entornos virtualizados con una configuración y un tamaño correctos, del mismo modo que lo harían en sistemas que no se hayan virtualizado. Para obtener información sobre los productos Sun Java System compatibles con entornos virtualizados, consulte http://download.oracle.com/820-4651.

Dependencias de componentes

Además de los requisitos específicos de cada plataforma, Message Queue también depende de determinados componentes básicos que deben instalarse para desarrollar y ejecutar clientes Message Queue. En la Tabla 1–3 se describen estos componentes. Asimismo, pueden utilizarse versiones distintas o implementaciones de otros proveedores, pero Sun Microsystems no las ha probado y, por tanto, no garantiza oficialmente su compatibilidad.

En la Tabla 1–4 se muestran los componentes adicionales que puede instalar para dar mayor soporte a los clientes Message Queue. Es posible que no necesite todos los componentes de la lista, por ejemplo, si no piensa escribir en C, no necesitará el compilador C, la biblioteca de tiempo de ejecución C++, NSPR ni NSS.

Nuevas funciones de Message Queue 4.4 Update 1 y versiones recientes

Las nuevas funciones de Message Queue 4.4 Update 1 y versiones anteriores de la familia Message Queue 4.x se describen en las siguientes secciones:

• Nuevas funciones de Message Queue 4.4 Update 1

• Nuevas funciones de Message Queue 4.4

• Nuevas funciones de Message Queue 4.3

• Nuevas funciones de Message Queue 4.2

• Nuevas funciones de Message Queue 4.1

• Nuevas funciones de Message Queue 4.0

Nuevas funciones de Message Queue 4.4 Update 1

Message Queue 4.4 Update 1 es una versión menor que incluye nuevas mejoras en lo que a funciones y soluciones a fallos se refiere. En esta sección se describen las nuevas funciones incluidas en esta versión:

• Nuevo programa de instalación

• Admisión de registros de transacciones para agrupaciones

• Agente interno del proceso

Nuevo programa de instalación

Message Queue 4.4 Update 1 incluye un nuevo instalador multiplataforma basado en el sistema pkq(5), también conocido como IPS (Image Packaging System). Para obtener más información sobre este programa de instalación, consulte Sun GlassFish Message Queue 4.4 Update 1 Installation Guide.

Admisión de registros de transacciones para agrupaciones

Message Queue 4.4 Update 1 incluye un mecanismo de persistencia de transacción para almacenes de datos basados en archivos que es compatible con agrupaciones de agentes. Este mecanismo proporciona otras funciones, descritas en Optimizing File-Based Transaction Persistence de Sun GlassFish Message Queue 4.4 Administration Guide.

Agente interno del proceso

Message Queue 4.4 Update 1 permite ejecutar un agente desde el cliente Java. Un agente de este tipo, llamado agente interno del proceso o incrustado, se ejecuta en la misma JVM que el cliente Java encargado de la creación y el inicio. Si necesita más información, consulte el Capítulo 6, Embedding a Message Queue Broker in a Java Client de Sun GlassFish Message Queue 4.4 Developer’s Guide for Java Clients.

Nuevas funciones de Message Queue 4.4

Message Queue 4.4 es una versión secundaria que incluye nuevas mejoras de funciones y soluciones de errores. En esta sección se describen las nuevas funciones incluidas en esta versión:

• Servicio de conexión JMS

• Servicio de conexión STOMP

• Mejoras adicionales

Servicio de conexión JMS

Debido a que la especificación JMS no define un protocolo para la comunicación entre agentes y clientes, cada proveedor de soluciones JMS (incluido Message Queue) utiliza su propio protocolo patentado. Esta situación ha provocado que las soluciones JMS de diferentes proveedores no sean compatibles.

El servicio de conexión JMS de Message Queue 4.4 soluciona este problema al permitir que un agente de Message Queue asigne sus destinos a destinos de proveedores JMS externos. Esta asignación permite que el agente de Message Queue se comunique de manera efectiva con clientes del proveedor JMS externo.

El servicio de conexión JMS permite asignar destinos de proveedores JMS externos que:

• Sean compatibles con JMS 1.1

• Admitan objetos administrados JNDI

• Utilicen fabricas de conexión de tipo javax.jms.ConnectionFactory o javax.jms.XAConnectionFactory

• Para la asignación con transacción, se admiten interfaces XA como administrador de recursos

Muchas soluciones JMS de otros proveedores, tanto de código abierto como comerciales, cumplen estos requisitos; por lo que el servicio de conexión JMS es un sistema efectivo para integrar Message Queue en entornos de mensajería con otros proveedores JMS.

Si necesita más información sobre el servicio de conexión JMS, consulte:

• Si necesita más información sobre la arquitectura, los subcomponentes y las funciones del servicio de conexión JMS, consulte la sección JMS Bridge Service de Sun GlassFish Message Queue 4.4 Technical Overview.

• Si necesita más información sobre cómo configurar y administrar las conexiones JMS de un agente, consulte la sección Configuring and Managing JMS Bridge Services de Sun GlassFish Message Queue 4.4 Administration Guide.

Servicio de conexión STOMP

Como se ha mencionado anteriormente, la especificación JMS no define un protocolo de conexión para la comunicación entre agentes y clientes. El proyecto de código abierto STOMP (Streaming Text Oriented Messaging Protocol) de http://stomp.codehaus.org define un protocolo de conexión simple que pueden usar clientes escritos en cualquier lenguaje para comunicarse con cualquier proveedor de mensajería compatible con el protocolo STOMP.

Message Queue 4.4 es compatible con el protocolo STOMP mediante el servicio de conexión STOMP. Este servicio permite a un agente de Message Queue comunicarse con clientes STOMP.

Si necesita más información sobre el servicio de conexión STOMP, consulte:

• Si necesita más información sobre la arquitectura y las funciones del servicio de conexión STOMP, consulte la sección STOMP Bridge Service de Sun GlassFish Message Queue 4.4 Technical Overview.

• Si necesita más información sobre cómo configurar y administrar una conexión STOMP de un agente, consulte la sección Configuring and Managing STOMP Bridge Services de Sun GlassFish Message Queue 4.4 Administration Guide.

Mejoras adicionales

Message Queue 4.4 también incluye las siguiente mejoras adicionales:

• Nuevas funciones UMS (Universal Message Service)

• Admisión de paquetes IPS

• Función de registro de auditoría reincorporada

Nuevas funciones UMS (Universal Message Service)

Ahora, el servicio UMS proporciona funciones que utilizan HTTP GET para ofrecer múltiples servicios:

• getBrokerInfo: obtiene información sobre el agente.

• getConfiguration: obtiene información sobre la configuración UMS.

• debug: activa o desactiva el registro de errores en el servidor UMS.

• ping: se comunica con el agente para confirmar que esté en ejecución.

Para obtener más información sobre estas nuevas funciones, consulte Query and utility functions using HTTP GET en https://mq.dev.java.net/4.4-content/imqums/protocol.html.

Para ver una descripción general de UMS, consulte Universal Message Service (UMS). Para consultar la documentación de la API UMS, visite https://mq.dev.java.net/4.4-content/imqums/protocol.html. Para ver ejemplos de programación en diferentes lenguajes, consulte https://mq.dev.java.net/4.4-content/imqums/examples/README.html.

Admisión de paquetes IPS

Ahora, Message Queue se empaqueta para su distribución con el sistema de código abierto IPS (Image Packaging System), también conocido como sistema pkg(5). Este sistema de empaquetado se utiliza para integrar Message Queue con Sun GlassFish Enterprise Server 2.1.1.

Función de registro de auditoría reincorporada

Message Queue 3.7 incluía una función de registro de auditoría que se eliminó en Message Queue 4.0. Esta función se ha reincorporado en Message Queue4,4. Para obtener más información acerca de esta función, consulte Audit Logging de Sun GlassFish Message Queue 4.4 Administration Guide.

Nuevas funciones de Message Queue 4.3

Message Queue 4.3 es una versión secundaria que incluye varias mejoras de funciones y errores corregidos. En esta sección se describen las nuevas funciones incluidas en esta versión:

• Universal Message Service (UMS)

• Compatibilidad con la plataforma AIX

• Nuevo instalador basado en Zip

• Compatibilidad con plataformas ampliada

• Mejoras adicionales

Universal Message Service (UMS)

Message Queue 4.3 incluye un nuevo servicio UMS (Universal Messaging Service) y una API de mensajería que permiten acceder a Message Queue desde cualquier dispositivo con http. Como resultado, prácticamente cualquier aplicación puede comunicarse con otras aplicaciones y aprovechar la fiabilidad y el envío garantizado de la mensajería JMS. Además, el servicio UMS ofrece una mayor escalabilidad para la mensajería JMS, lo que permite aumentar el número de clientes de mensajería hasta proporciones de escala de Internet.

Arquitectura

La siguiente figura muestra la arquitectura UMS básica:

Figura 1–1 Arquitectura UMS

UMS, que se ejecuta en un servidor web, es un servicio independiente de la plataforma y con lenguaje neutro. El servicio UMS actúa como una puerta de enlace entre cualquier aplicación cliente no JMS y un proveedor JMS. Recibe mensajes enviados con la API UMS, los transforma en mensajes JMS y los produce en destinos del proveedor JMS mediante el protocolo nativo del proveedor. De modo similar, extrae mensajes de destinos del proveedor JMS, los transforma en mensajes de texto o SOAP y los envía a clientes no JMS según lo soliciten los clientes mediante la API UMS.

La API UMS, sencilla, independiente del lenguaje y basada en protocolo, admite tanto aplicaciones web como no basadas en web, y puede usarse con lenguajes de secuencias de comandos y de programación. La API está disponible en dos modelos: una API de mensajería sencilla que utiliza un protocolo de tipo REST (REpresentational State Transfer), y una API de mensajería XML que incrusta el protocolo en un encabezado de mensaje SOAP. En ambos modelos, la API sólo necesita una solicitud http para enviar o recibir un mensaje.

La sencillez y flexibilidad de la API UMS permite que aplicaciones AJAX, .NET, Python, C, Java y de otro tipo puedan enviar mensajes de texto o SOAP (con adjuntos) a destinos JMS o recibir mensajes de destinos JMS. Por ejemplo, las aplicaciones Python pueden comunicarse con aplicaciones .NET, las aplicaciones de iPhone pueden comunicarse con aplicaciones Java, etc.

Para Message Queue 4.3, el servicio UMS sólo admite Message Queue como proveedor JMS.

Funciones adicionales

La función del servicio UMS va más allá que una simple puerta de enlace, descrita anteriormente. Admite sesiones cliente con estado y sin estado. Si lo solicita el cliente, el servicio UMS mantendrá el estado de sesión de la aplicación cliente en varias solicitudes de servicio. El servicio UMS puede utilizar autenticación administrada por contenedor, o configurarse para autenticar los clientes mediante el agente de Message Queue, o ambos. El servicio UMS también admite transacciones, lo que permite a las aplicaciones cliente confirmar o deshacer varias solicitudes de servicio como una única unidad atómica.

El servicio UMS admite un gran número de clientes en una única conexión con el agente de Message Queue, lo que reduce la carga de los servicios de conexión del agente y permite una escalabilidad máxima. Además, la capacidad del servicio UMS puede aumentarse con escalado horizontal, lo que permite trabajar con cargas de mensajes de escala de Internet.

En el cliente, gracias a la sencillez de la API UMS basada en protocolo, no se necesitan bibliotecas de cliente. Como resultado, la API puede ampliarse en el futuro para aplicar nuevas funciones JMS sin necesidad de actualizar las aplicaciones del cliente.

Uso del servicio UMS

Para utilizar el servicio UMS debe implementar UMS en un contenedor web compatible con las especificaciones Servlet 2.4 o posterior, iniciar el agente de Message Queue, crear los destinos correspondientes y escribir una aplicación de mensajería que utilice la API UMS para enviar o recibir mensajes.

El archivo UMS imqums.war, incluido en Message Queue 4.3, se instala en la siguiente ubicación, según la plataforma:

Puede cambiar el nombre del archivo .war según sus necesidades.

Cuando haya implementado el archivo imqums.war en un contenedor web en localhost:puerto, podrá consultar la documentación de UMS en:

http://localhost:puerto/imqums

De lo contrario, puede encontrar la documentación de UMS como se indica a continuación:

• Para obtener información acerca de la configuración de UMS, consulte https://mq.dev.java.net/4.3-content/ums/config.html.

• Si necesita documentación sobre la API UMS, consulte https://mq.dev.java.net/4.3-content/ums/protocol.html.

• Para ver ejemplos de programación en diferentes lenguajes, consulte https://mq.dev.java.net/4.3-content/ums/examples/README.html.

Contenedores web compatibles

Actualmente, los siguientes contenedores web admiten UMS:

• Sun GlassFish Enterprise Server, Versión 2.1 y Versión 3 Prelude

• Tomcat, versiones 5.5 y 6.0

Compatibilidad con la plataforma AIX

Message Queue 4.3 incluye paquetes para la plataforma AIX y el instalador correspondiente.

La implementación AIX de Message Queue admite el siguiente software:

• AIX v 6.1 o posterior (se admiten versiones anteriores de AIX mediante el paquete Unix/Java Only)

• Admisión de DB2

• Compilador C/C++ IBM XL V9.0

• JDK 1.5 o superior

Si necesita instrucciones de instalación, consulte el Capítulo 4, AIX Installation, de la Sun Java System Message Queue 4.3 Installation Guide.

En la plataforma AIX, los archivos de Message Queue se instalan en un único directorio raíz de Message Queue, IMQ_HOME. IMQ_HOME se refiere al directorio mqInstallHome/mq, mqInstallHome es el directorio raíz de la instalación especificado al instalar el producto (de manera predeterminada, es home-directory /MessageQueue).

La estructura de directorios de Message Queue resultante es la misma que en Windows (consulte la sección Windows del Apéndice A, Distribution-Specific Locations of Message Queue Data de Sun GlassFish Message Queue 4.4 Administration Guide.)

Message Queue es compatible con la plataforma AIX, incluida la C-API de Message Queue. Si necesita instrucciones para generar y compilar aplicaciones C en la plataforma AIX, consulte XREF.

Nuevo instalador basado en Zip

Message Queue 4.3 incluye un nuevo instalador para distribuciones basadas en zip, en lugar de distribuciones de paquete nativo. El instalador permite instalar las nuevas distribuciones .zip de Message Queue para la plataforma AIX.

El nuevo instalador extrae los archivos .zip de Message Queue en cualquier directorio para el que el usuario tenga derechos de escritura (no son necesarios privilegios root) y también permite registrar la instalación de Message Queue con Sun Connection.

Para minimizar el tamaño de los paquetes de descarga, Java Runtime no se incluye en la distribución basada en zip (la mayoría de sitios ya lo tienen). Por lo tanto, el comando installer requiere que se especifique un JDK o JRE, ya sea mediante la variable de entorno JAVA_HOME o utilizando la opción -j en la línea de comando, como se muestra a continuación:

$ installer -j ruta-JDK/JRE

ruta-JDK/JRE es la ruta del JDK o JRE especificado.

Compatibilidad con plataformas ampliada

Message Queue 4.3 será compatible con las siguientes plataformas adicionales:

• Oracle 11g

• Windows Server 2008

Mejoras adicionales

Message Queue 4.3 incluye las siguientes mejoras adicionales:

• Nueva estructura de directorios en Windows

• Nuevas propiedades de agente

• Mejoras de la API de administración JMX

• Listado de suscripciones duraderas de suscriptores comodín

Nueva estructura de directorios en Windows

La estructura de directorios de la instalación de Message Queue en Windows se ha modificado con respecto a versiones anteriores, para que sea igual que en la plataforma AIX. En el futuro, esta estructura de directorios se utilizará también en Solaris y Linux para facilitar el uso de varias instalaciones en un único equipo y las actualizaciones automáticas de Message Queue mediante Sun Connection; un servicio de Sun que facilita el control, la organización y el mantenimiento de hardware y software de Sun (consulte Compatibilidad del instalador con el registro en Sun Connection).

Nuevas propiedades de agente

Pueden utilizarse las siguientes propiedades nuevas para configurar un agente:

Mejoras de la API de administración JMX

Se han añadido claves de datos compuestas y un atributo nuevo a la API JMX:

• Se ha añadido un atributo NextMessageID al Destination Monitor MBean para proporcionar el ID de mensaje JMS del siguiente mensaje que debe enviarse a un consumidor.

• Se ha añadido una clave NextMessageID para datos compuestos al Consumer Manager Monitor MBean para proporcionar el ID de mensaje JMS del siguiente mensaje que debe enviarse al consumidor.

• Se ha añadido una clave NumMsgsPending para datos compuestos al Consumer Manager Monitor MBean para proporcionar el número de mensajes que se han enviado al consumidor.

Si necesita más información, consulte el Capítulo 3, Message Queue MBean Reference de Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients.

Listado de suscripciones duraderas de suscriptores comodín

El comando para obtener una lista de las suscripciones duraderas:

list dur [-d topicName]

se ha mejorado para poder especificar el nombre de tema. Si no se especifica ningún tema, el comando muestra todas las suscripciones duraderas de todos los temas, incluidas las que contengan caracteres comodín.

Nuevas funciones de Message Queue 4.2

Message Queue 4.2 es una versión secundaria que incluye varias funciones nuevas, funciones mejoradas y errores corregidos. En esta sección se describen las nuevas funciones de la versión 4.2 y se ofrecen más referencias para su uso:

• Varios destinos para un editor o suscriptor

• Validación del esquema de mensajes de carga de datos XML

• Admisión de C-API para transacciones distribuidas

• Compatibilidad del instalador con el registro en Sun Connection

• Admisión de bases de datos MySQL

• Mejoras adicionales

Para obtener información sobre las funciones que se incluyen en Message Queue 4.1 y 4.0, consulte Nuevas funciones de Message Queue 4.1 y Nuevas funciones de Message Queue 4.0, respectivamente.

Varios destinos para un editor o suscriptor

Con Message Queue 4.2, un editor puede publicar mensajes en varios destinos de temas y un suscriptor puede consumir mensajes de varios destinos de temas. Esta función se logra al utilizar un nombre de destino de temas que incluye caracteres comodín que representen varios destinos. Al utilizar dichos nombres simbólicos, los administradores pueden crear destinos de temas adicionales, según sea necesario, coherentes con el esquema de asignación de nombres comodín. Los editores y suscriptores publican y consumen automáticamente a partir de los destinos añadidos. (Los suscriptores de los temas comodín son más comunes que los editores.)

Esta función no se aplica a destinos de cola.

Puede consultar el formato de los nombres de destinos de temas simbólicos y ver ejemplos de uso en la sección Supported Topic Destination Names de Sun GlassFish Message Queue 4.4 Administration Guide.

Validación del esquema de mensajes de carga de datos XML

Esta nueva función de Message Queue 4.2, permite validar el contenido de un mensaje XML de texto (no de objeto) con un esquema XML, cuando el mensaje se envía al agente. La ubicación del esquema XML (XSD) se especifica como propiedad de un destino de Message Queue. Si no se especifica ninguna ubicación XSD, la declaración DTD del documento XML se utilizará para realizar la validación DTD. (la validación XSD, que incluye la validación del intervalo de valores y el tipo de datos, es más rigurosa que la validación DTD.)

Para obtener información sobre el uso de esta función, consulte Schema Validation of XML Payload Messages de Sun GlassFish Message Queue 4.4 Developer’s Guide for Java Clients.

Admisión de C-API para transacciones distribuidas

Según el modelo de transacciones distribuidas X/Open, la compatibilidad con transacciones distribuidas se basa en un administrador de transacciones de este tipo que supervisa y administra las operaciones que realizan uno o más administradores de recursos. Con Message Queue 4.2 la C-API de Message Queue es compatible con la interfaz XA (entre un administrador de transacciones distribuidas y Message Queue como administrador de recursos compatibles con XA), lo que permite a los clientes de la C-API de Message Queue funcionar en un entorno de procesamiento de transacciones distribuidas (tales como BEA Tuxedo) con el fin de participar en transacciones distribuidas.

Esta compatibilidad con transacciones distribuidas cuenta con las siguientes nuevas funciones de C-API (y nuevos parámetros y códigos de error) que se utilizan para implementar la especificación de la interfaz XA:

MQGetXAConnection()
MQCreateXASession()

Si la aplicación de un cliente C se va a utilizar en el contexto de una transacción distribuida, debe obtener una conexión a través de MQGetXAConnection() y crear una sesión para producir y consumir mensajes mediante MQCreateXASession(). El inicio, la confirmación y la anulación de cualquier transacción distribuida se administra a través de interfaces API suministradas por el administrador de transacciones distribuidas.

Si necesita más información sobre el uso de funciones de transacción distribuida, consulte la sección Working With Distributed Transactions de Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients.

Message Queue 4.2 incluye ejemplos de programación basados en el administrador de transacciones Tuxedo. Si necesita información sobre el uso de estos programas de ejemplo, consulte la sección Distributed Transaction Sample Programs de Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients.

La función de transacción distribuida se admite en Solaris, Linux y Windows, aunque hasta ahora sólo se ha certificado para la plataforma Solaris.

Compatibilidad del instalador con el registro en Sun Connection

El instalador de Message Queue se ha mejorado para permitir el registro de Message Queue en Sun Connection, un servicio de Sun que le ayuda a supervisar, organizar y mantener software y hardware de Sun.

Puede registrar Message Queue en Sun Connection al instalarlo. La información acerca del Message Queue instalado, como por ejemplo la versión, el nombre del sistema, el sistema operativo, la fecha de instalación y otra información básica, se transmite de forma segura a la base de datos de Sun Connection. El servicio de inventario de Sun Connection puede ayudarle a organizar su hardware y software de Sun, mientras que el servicio de actualización puede informarle de las últimas soluciones de seguridad disponibles, actualizaciones recomendadas y mejoras de funciones.

Para obtener más información sobre el registro de Message Queue con Sun Connection, consulte Sun GlassFish Message Queue 4.3 Installation Guide .

Admisión de bases de datos MySQL

Message Queue 4.2 es compatible con bases de datos MySQL como almacén de datos basado en JDBC. MySQL Cluster Edition puede usarse como una base de datos JDBC para un agente independiente y como el almacén de datos de alta disponibilidad necesario para una agrupación de agentes mejorada. Si necesita información sobre cómo configurar Message Queue para utilizar MySQL, consulte la sección Configuring a JDBC-Based Data Store de Sun GlassFish Message Queue 4.4 Administration Guide y Enhanced Broker Cluster Properties de Sun GlassFish Message Queue 4.4 Administration Guide .

Mejoras adicionales

Además de las funciones descritas anteriormente, Message Queue 4.2 incluye las siguientes mejoras:

• Estadísticas de mensaje generadas remotamente

  Message Queue 4.4 Update 1 incluye nuevos métodos de medición de destino que pueden resultar útiles a la hora de controlar destinos en una agrupación de agentes. En una agrupación de agentes, los mensajes almacenados en un destino específico de un agente determinado de la agrupación son mensajes generados directamente para enviarlos al destino, así como mensajes enviados al destino desde agentes remotos de la agrupación. Al analizar el enrutamiento y la entrega de mensajes en una agrupación de agentes, a veces resulta útil saber cuántos mensajes de un destino son locales (se han generado localmente) y cuántos son remotos (se han generado de forma remota).

  Message Queue 4.2 incluye dos nuevas cantidades de medición de destino físico: Num messages remote y Total Message bytes remote. Puede acceder a las nuevas cantidades de medición con los comandos imqcmd list dst e imqcmd query dst (consulte la sección Viewing Physical Destination Information de Sun GlassFish Message Queue 4.4 Administration Guide) o usando nuevos atributos JMX (consulte la sección Destination Monitor de Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients).

• Información sobre el generador y el consumidor de comodines

  Los nuevos datos de control ofrecen información que permite el uso de caracteres comodín en nombres de destino (consulte Varios destinos para un editor o suscriptor). Por ejemplo, puede ver el número de generadores y consumidores de comodines asociados con un destino con el comando imqcmd query dst (consulte la sección Viewing Physical Destination Information de Sun GlassFish Message Queue 4.4 Administration Guide) o utilizando los nuevos atributos JMX (consulte la sección Destination Monitor de Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients). La información de comodines también puede obtenerse mediante los MBeans ConsumerManager Monitor y ProducerManager Monitor.

• Admisión del formato de nombre de usuario DN para la autenticación del cliente

  Message Queue 4.2 admite el formato de nombre de usuario DN al autenticar la conexión del cliente con un almacén de usuarios LDAP. La compatibilidad incluye la siguiente nueva propiedad de agente (y el valor):

  imq.user_repository.ldap.usrformat=dn

  Esta propiedad permite al agente autenticar un usuario del cliente con un almacén de usuarios LDAP extrayendo del formato de nombre de usuario DN el valor del atributo especificado por la siguiente propiedad:

  imq.user_repository.ldap.uidattr

  El agente utiliza el valor del anterior atributo como nombre de usuario en las operaciones de control de acceso.

  Por ejemplo, si imq.user_repository.ldap.uidattr=udi y un nombre de usuario de autenticación de cliente están en el formato udi=mquser,ou=People,dc=red,dc=sun,dc=com, se extraería “mquser” para realizar el control de acceso.

• Mejora de la autenticación JAAS

  Message Queue 4.2 permite la autenticación JAAS por dirección IP y por nombre de usuario.

Nuevas funciones de Message Queue 4.1

Message Queue 4.1 es una versión secundaria que incluye varias funciones nuevas, funciones mejoradas y errores corregidos. Esta sección describe las nuevas funciones de la versión 4.1 y le ofrece más referencias para su uso:

• Agrupaciones de agentes de alta disponibilidad

• Compatibilidad con JAAS

• Cambio del formato del almacén de datos persistente

• Configuración del entorno del agente

• Compatibilidad con Java ES Monitoring Framework

• Administración de transacciones mejorada

• Puertos fijos para las conexiones de los clientes C

Para obtener información sobre las funciones nuevas de Message Queue 4.0, consulte Nuevas funciones de Message Queue 4.0.

Agrupaciones de agentes de alta disponibilidad

Message Queue 4.1 incluye una agrupación de agentes nueva y mejorada. En comparación con una agrupación de agentes convencional, que sólo ofrece disponibilidad de servicio de mensajería (si un agente falla, hay otro agente disponible para ofrecer el servicio de mensajería), las agrupaciones de agentes de alta disponibilidad también incluyen disponibilidad de datos (si un agente falla, están disponibles sus mensajes persistentes y sus datos de estado para que otro agente los utilice con el fin de hacerse cargo del envío de mensajes).

El sistema de alta disponibilidad que se utiliza en Message Queue 4.1 utiliza un almacén de datos compartido basado en JDBC: en lugar de que cada agrupación de agentes tenga su propio almacén de datos persistente, todos los agentes de la agrupación comparten la mima base de datos JDBC. Si un agente en particular tiene algún error, otro agente de la agrupación asume el envío del mensaje del agente que ha fallado. Al hacer esto, el agente sustituto utiliza datos e información sobre el estado del almacén de datos compartido. Los clientes de mensajería del agente que ha fallado se reconectan al agente de sustitución, que ofrece un servicio de mensajería sin interrupciones.

El almacén compartido basado en JDBC utilizado en la implementación de alta disponibilidad de Message Queue 4.1 debe ser de por sí altamente disponible. Si no cuenta con una base de datos de alta disponibilidad o si el envío de mensajes ininterrumpido no le resulta importante, puede continuar utilizando agrupaciones convencionales, que ofrecen disponibilidad de servicios sin disponibilidad de datos.

Para configurar una agrupación de agentes mejorada en Message Queue 4.1, debe especificar las siguientes propiedades de cada agente de la agrupación:

• Propiedades de pertenencia a la agrupación, que sirven para especificar si el agente forma parte de una agrupación de agentes mejorada, el ID del clúster y el ID del agente del clúster.

• Propiedades de la base de datos de alta disponibilidad, que especifican el modelo de datos persistentes (JDBC), el nombre del proveedor de la base de datos y las propiedades de configuración específicas del proveedor.

• Detección de fallos y propiedades de error, que especifica cómo se detectan fallos del agente y cómo se administran mediante un agente de sustitución.

Para utilizar el sistema de agrupación de agentes mejorada, debe hacer lo siguiente:

1. Instalar una base de datos de alta disponibilidad.

2. Instalar el archivo .jar del controlador de JDBC.

3. Crear el esquema de la base de datos para el almacén de datos persistente de alta disponibilidad.

4. Establecer propiedades de alta disponibilidad para cada agente de la agrupación.

5. Iniciar cada uno de los agentes de la agrupación.

Si necesita una explicación del concepto de agrupaciones de agentes mejoradas en relación a las agrupaciones convencionales, consulte el Capítulo 4, Broker Clusters de Sun GlassFish Message Queue 4.4 Technical Overview. Si necesita información sobre los procedimientos y datos de referencia sobre las agrupaciones de agentes mejoradas, consulte el Capítulo 10, Configuring and Managing Broker Clusters de Sun GlassFish Message Queue 4.4 Administration Guide y la sección Cluster Configuration Properties de Sun GlassFish Message Queue 4.4 Administration Guide.

Si ha estado utilizando una base de datos de alta disponibilidad con Message Queue 4.0 y desea cambiar a una agrupación de agentes mejorada, puede utilizar la herramienta Database Manager (imqdbmgr) para convertir el sistema en un almacén de datos persistente compartido. Consulte también Agrupaciones de agentes si necesita más información sobre problemas conocidos y limitaciones.

Compatibilidad con JAAS

Además de los mecanismos de autenticación basados en archivos y en LDAP integrados, Message Queue 4.1 también es compatible con JAAS (Java Authentication and Authorization Service), que le permite conectar un mecanismo de autenticación externo al agente para autenticar los clientes de Message Queue.

Para obtener una descripción de la información que un agente pone a su disposición en un servicio de autenticación compatible con JAAS y una explicación acerca de cómo configurar el agente para utilizar dicho servicio, consulte Using JAAS-Based Authentication de Sun GlassFish Message Queue 4.4 Administration Guide.

Cambio del formato del almacén de datos persistente

El almacén de datos basado en JDBC de Message Queue 4.1 se cambió para admitir agrupaciones de agentes mejoradas. Por este motivo, el formato del almacén de datos basado en JDBC se ha ampliado a la versión 410. Las versiones con formato 350, 370 y 400 se migran automáticamente a la versión 410.

Tenga en cuenta que el formato del almacén de datos persistente basado en archivos permanece en la versión 370 dado que no se realizaron cambios en el mismo.

Configuración del entorno del agente

La propiedad IMQ_DEFAULT_EXT_JARS se ha añadido al archivo de configuración del entorno de Message Queue 4.1, imqenv.conf. Puede configurar esta propiedad para especificar el nombre de las rutas de los archivos .jar que deben incluirse en CLASSPATH al iniciarse el agente. Si utiliza esta propiedad para especificar la ubicación de los archivos .jar externos, ya no necesitará copiar estos archivos en el directorio lib/ext. Los archivos .jar externos pueden hacer referencia a los controladores de JDBC o a módulos de registro JAAS. La siguiente propiedad de ejemplo especifica la ubicación de los controladores JDBC.

IMQ_DEFAULT_EXT_JARS=/opt/SUNWhadb4/lib/hadbjdbc4.jar:/opt/SUNWjavadb/derby.jar

Compatibilidad con Java ES Monitoring Framework

Message Queue 4.1 es compatible con Sun Java Enterprise System (Java ES) Monitoring Framework, que permite controlar los componentes de Java ES mediante una interfaz gráfica común. La interfaz se implementa mediante una consola basada en web llamada "Sun Java System Monitoring Console". Los administradores pueden utilizar la Consola para ver las estadísticas de rendimiento, crear reglas para realizar un control automático y alarmas de confirmación. Si ejecuta Message Queue junto con otros componentes de Java ES, le resultará más cómodo gestionar todos los componentes con una única interfaz.

Para obtener más información sobre cómo utilizar la función Java ES Monitoring Framework para controlar Message Queue, consulte XREF.

Administración de transacciones mejorada

Anteriormente, los administradores sólo podían deshacer transacciones que estuvieran en estado PREPARED Es decir, si una sesión que formara parte de una transacción distribuida no terminaba correctamente, la transacción permanecía en un estado que era imposible de reorganizar para el administrador. Con Message Queue 4.1, el usuario puede utilizar la herramienta Command (imqcmd) para limpiar (deshacer) transacciones que se encuentren en los siguientes estados: STARTED, FAILED, INCOMPLETE, COMPLETE y PREPARED.

Para poder determinar si una transacción puede deshacerse (especialmente si no se encuentra en un estado PREPARED), la herramienta Command proporciona datos adicionales en la información imqcmd query txn generada: el id de la conexión que ha iniciado la transacción y la hora a la que se creó la misma. Basándose en esta información, el administrador puede decidir si es preciso deshacer o no la transacción. Por lo general, el administrador debe evitar deshacer una transacción prematuramente.

Puertos fijos para las conexiones de los clientes C

En Message Queue 4.1, los clientes C, como los clientes Java, pueden conectarse a un puerto de agente fijo en lugar de a un puerto asignado dinámicamente por el servicio Port Mapper del agente. Las conexiones a puertos fijos son útiles si intenta utilizar un servidor de seguridad o si necesita omitir el servicio Port Mapper por alguna otra razón.

Para configurar una conexión a puerto fija, debe configurar el agente y el tiempo de ejecución del cliente C (ambos extremos de la conexión). Por ejemplo, si desea conectar a su cliente con el puerto 1756 mediante ssljms, tendría que hacer lo siguiente:

• En el cliente, establezca las siguientes propiedades:

  MQ_SERVICE_PORT_PROPERTY=1756

  MQ_CONNECTION_TYPE_PROPERTY=SSL

• En el agente, establezca la propiedad imq.serviceName.protocolType .puerto de la siguiente manera:

  imq.ssljms.tls.port=1756

La propiedad de conexión MQ_SERVICE_PORT_PROPERTY ha pasado al puerto anterior de Message Queue 3.7 Update 2.

Nuevas funciones de Message Queue 4.0

Message Queue 4.0 es una versión secundaria que se limita a ser compatible con Application Server 9 PE. Incluía algunas nuevas funciones, algunas mejoras relacionadas con las funciones y soluciones a fallos. Esta sección incluye una descripción de las nuevas funciones de esta versión:

• Compatibilidad con la API de administración JMX

• Registro del tiempo de ejecución del cliente

• API de notificación de sucesos de conexión

• Mejoras en la administración del agente

• Mostrar información sobre el almacén de datos basado en JDBC

• Compatibilidad con el proveedor de JDBC

• Cambios en el formato del almacén de datos persistente.

• Propiedades de mensajes adicionales

• Compatibilidad con SSL

Uno de los cambios más insignificantes que incorporaba la versión 4.0, pero que puede provocar interrupciones, era la anulación de la opción de línea de comandos para especificar una contraseña. De ahora en adelante, debe guardar todas las contraseñas en un archivo tal y como se describe en Opción de contraseña eliminada, o introducirlas cuando se le soliciten.

Compatibilidad con la API de administración JMX

Se ha añadido una nueva API a Message Queue 4.0 para configurar y supervisar los agentes de Message Queue de acuerdo con la especificación Java Management Extensions (JMX). Con esta API, puede configurar y supervisar las funciones de agente de forma práctica desde una aplicación Java. En versiones anteriores de Message Queue, sólo era posible acceder a estas funciones desde las utilidades de administración de línea de comando o la consola de administración.

Si necesita más información, consulte la Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients .

Registro del tiempo de ejecución del cliente

Message Queue 4.0 incluía compatibilidad con el registro de conexión del tiempo de ejecución del cliente y eventos relacionados con las sesiones.

Para obtener más información sobre el registro del tiempo de ejecución del cliente y cómo configurarlo, consulte la página 137 de la Guía para desarrolladores de Java.

API de notificación de sucesos de conexión

Message Queue 4.0 incluía una API de notificación de sucesos que permitía que el tiempo de ejecución de cliente informase a una aplicación sobre los cambios en el estado de la conexión. Las notificaciones de los sucesos de conexión permiten al cliente de Message Queue escuchar los sucesos de cierre y reconexión, y tomar las medidas oportunas en función del tipo de notificación y del estado de conexión. Por ejemplo, si se produce un error y el cliente se vuelve a conectar a otro agente, es posible que una aplicación quiera limpiar el estado de su transacción y continuar con una nueva.

Para obtener información acerca de los eventos de conexión y sobre cómo crear un receptor de eventos, consulte la página 96 de la Guía para desarrolladores de Java.

Mejoras en la administración del agente

En Message Queue 4.0, se añadieron varias opciones de comando y un nuevo subcomando a la utilidad Command (imqcmd) para permitir a los administradores desactivar un agente, cerrar un agente tras un intervalo específico, destruir una conexión o establecer propiedades del sistema java (por ejemplo, propiedades relacionadas con la conexión).

• Al desactivar el agente, éste pasa a un estado inactivo, lo cual permite drenar los mensajes antes de cerrar o reiniciar el agente. No es posible crear conexiones con un agente que está desactivado. Para desactivar el agente, introduzca un comando como el siguiente:

  imqcmd quiesce bkr -b Wolfgang:1756

• Para que el agente se cierre después del intervalo especificado, introduzca un comando como el siguiente: (El intervalo de tiempo especifica el número de segundos que debe transcurrir para que se cierre el agente.)

  imqcmd shutdown bkr -b Hastings:1066 -time 90

  Si especifica un intervalo de tiempo, el agente registrará un mensaje indicando cuándo se producirá el cierre. Por ejemplo:

  El agente se cerrará en 29 segundos (29996 milisegundos)

  Mientras el agente espera a que se produzca el cierre, su comportamiento se verá afectado de la siguiente forma:

  • Seguirá aceptando las conexiones jms administrativas.

  • No aceptará nuevas conexiones jms.

  • Las conexiones jms existentes continuarán funcionando.

  • El agente no podrá sustituir a ningún otro agente de una agrupación de agentes mejorada.

  • La utilidad imqcmd no se bloqueará, sino que enviará la solicitud de cerrar el agente e informará inmediatamente.

• Para destruir una conexión, introduzca un comando como el siguiente:

  imqcmd destroy cxn -n 2691475382197166336

  Utilice los comandos imqcmd list cxn o imqcmd query cxn para obtener el ID de conexión.

• Para establecer una propiedad con imqcmd, utilice la nueva opción –D. Es útil para establecer o anular las propiedades de fábrica de la conexión JMS o las propiedades del sistema java relacionadas con la conexión. Por ejemplo:

  imqcmd list svc -secure -DimqSSLIsHostTrusted=true
  imqcmd list svc -secure -Djavax.net.ssl.trustStore=/tmp/mytruststore 
              -Djavax.net.ssl.trustStorePassword=mytrustword

Encontrará toda la información sobre la sintaxis del comando imqcmd en el Capítulo 16, Command Line Reference de Sun GlassFish Message Queue 4.4 Administration Guide.

Mostrar información sobre el almacén de datos basado en JDBC

En Message Queue 4.0 se añadió un nuevo subcomando query a la utilidad Database Manager, imqdbmgr. Este subcomando se utiliza para mostrar información sobre el almacén de datos basado en JDBC, como la versión de la base de datos, el usuario de la base de datos y si se han creado las tablas de la base de datos.

A continuación, se muestra un ejemplo de la información mostrada por este comando.

imqdbmgr query

[04/Oct/2005:15:30:20 PDT] Using plugged-in persistent store:
        version=400
        brokerid=Mozart1756
        database connection url=jdbc:oracle:thin:@Xhome:1521:mqdb
        database user=scott
Running in standalone mode.
Database tables have already been created.

Compatibilidad con el proveedor de JDBC

En Message Queue 4.0, Apache Derby Version 10.1.1 ya es compatible como proveedor de almacén de datos basado en JDBC.

Cambios en el formato del almacén de datos persistente.

Message Queue 4.0 introdujo cambios en el almacén de datos basado en JDBC para optimizar el sistema y permitir mejoras en el futuro. Por este motivo, el formato del almacén de datos basado en JDBC se amplió a la versión 400. Tenga en cuenta que en Message Queue 4.0, la versión del almacén de datos basado en archivos sigue siendo la 370, porque no se ha realizado ningún cambio.

Propiedades de mensajes adicionales

Message Queue 4.0 añadió dos nuevas propiedades que están configuradas en todos los mensajes ubicados en la cola de mensajes inactivos.

• JMS_SUN_DMQ_PRODUCING_BROKER indica al agente dónde se generó el mensaje.

• JMS_SUN_DMQ_DEAD_BROKER indica al agente quién marcó el mensaje como inactivo.

Compatibilidad con SSL

Desde la versión Message Queue 4.0, el valor predeterminado de la propiedad de fábrica de la conexión del cliente imqSSLIsHostTrusted es false. Si su aplicación depende del valor predeterminado anterior true, deberá cambiar la configuración y establecer la propiedad explícitamente en true.

Puede elegir si desea confiar en el host cuando el agente está configurado para utilizar certificados autofirmados. En este caso, además de especificar que la conexión debe usar un servicio de conexión basado en SSL (con la propiedad imqConnectionType), debería establecer la propiedad imqSSLIsHostTrusted en true.

Por ejemplo, para ejecutar de forma segura las aplicaciones del cliente cuando el agente utiliza certificados autofirmados, utilice un comando como el siguiente:

java -DimqConnectionType=TLS 
      -DimqSSLIsHostTrusted=true ClientAppName

Para utilizar la utilidad Comando (imqcmd) de forma segura cuando el agente utiliza certificados autofirmados, utilice un comando como el siguiente (para enumerar los servicios del conector).

imqcmd list svc -secure -DimqSSLIsHostTrusted=true

Funciones que se eliminarán en futuras versiones

Las siguientes funciones nuevas se dejarán de utilizar en una versión futura:

• Supervisión basada en mensajes

  La supervisión basada en mensajes utiliza el productor de mensajes de medición (Metrics Message Producer) configurable del agente para escribir datos de medición en mensajes JMS, que se envían a continuación a destinos de temas de medición, en función del tipo de información sobre medición que contengan los mensajes. Puede acceder a esta información sobre medición escribiendo una aplicación de cliente que se suscriba al destino de temas de medición adecuado, consuma sus mensajes y procese los datos según desee.

  La función de supervisión basada en mensajes ha sido sustituida por la API de administración JMX que se utilizaba en MQ 4.0 (consulte Compatibilidad con la API de administración JMX). La API JMX es más completa (incluye más datos sobre medición que los que aparecen en los destinos de temas) y está basada en el estándar del sector JMX.

  No hay razón de peso para utilizar la supervisión basada en mensajes ahora que Message Queue es compatible con la API JMX. La información sobre la supervisión basada en mensajes permanecerá en la documentación de Message Queue hasta que la función se cancele formalmente.

• Programa de instalación basado en texto

  El modo de texto del instalador de Message Queue (installer -t) se eliminará en todos los sistemas operativos. En el modo de texto, se muestra texto sin formato en la ventana de terminal para simular el aspecto del modo de interfaz gráfica de usuario (GUI). El modo de interfaz gráfica y el modo silencioso seguirán activos.

• Compatibilidad con plataformas

  Windows 2000 y Red Hat Linux 3 ya no se admitirán en futuras versiones.

• Adaptador de recursos JMSRA

  El adaptador de recursos de Message Queue imqjmsra.rar, normalmente llamado JMSRA, se reemplazará por un nuevo adaptador de recursos en la próxima versión de Message Queue. JMSRA se utiliza para integrar Message Queue con el servidor de aplicaciones Sun Java System Application Server.

  El nuevo adaptador de recursos, que combinará las funciones de JMSRA con las de otros adaptadores Sun JMS, será específicamente compatible con Message Queue, así como con otros proveedores, en un entorno de servidor de aplicaciones Java EE 5. Como tal, se utilizará para integrar Message Queue en Sun GlassFish Enterprise Server y Sun Java Composite Application Platform Suite (Java CAPS).

Errores solucionados en Message Queue 4.4 Update 1 y versiones recientes

Message Queue 4.4 Update 1 incluye nuevas correcciones de errores, así como correcciones de errores de versiones anteriores de la familia Message Queue 4.x.

Las siguientes secciones enumeran errores que se resolvieron en sus respectivas versiones:

• Errores solucionados en Message Queue 4.4 Update 1

• Errores solucionados en Message Queue 4.4

• Errores solucionados en Message Queue 4.3

• Errores solucionados en Message Queue 4.2

• Errores solucionados en Message Queue 4.1

• Errores solucionados en Message Queue 4.0

Errores solucionados en Message Queue 4.4 Update 1

En la siguiente tabla se muestran los errores solucionados en Message Queue Algunos de estos problemas están marcados con "(OpenMQ)", que indica el problema se ha arreglado en el proyecto de código abierto Open Message Queue en el que está basado Sun GlassFish Message Queue.

Errores solucionados en Message Queue 4.4

La siguiente tabla muestra los errores solucionados en Message Queue 4.4.

Errores solucionados en Message Queue 4.3

La siguiente tabla muestra los errores solucionados en Message Queue 4.3.

Errores solucionados en Message Queue 4.2

La siguiente tabla muestra los errores solucionados en Message Queue 4.2.

Errores solucionados en Message Queue 4.1

La siguiente tabla muestra los errores solucionados en Message Queue 4.1.

Errores solucionados en Message Queue 4.0

La siguiente tabla muestra los errores solucionados en Message Queue 4.0.

Actualizaciones de documentación de Message Queue 4.4 Update 1

Esta sección contiene información relacionada con las actualizaciones de la documentación de Message Queue 4.4 Update 1:

• Problemas de compatibilidad

• Cambios en el conjunto de documentación de Message Queue 4.4 Update 1

Problemas de compatibilidad

En esta sección se tratan los problemas de compatibilidad de Message Queue 4.4 Update 1.

Estabilidad de interfaz

Sun GlassFish Message Queue utiliza muchas interfaces que pueden cambiar con el tiempo. El Apéndice B, Stability of Message Queue Interfaces de Sun GlassFish Message Queue 4.4 Administration Guide incluye una clasificación de las interfaces según su estabilidad. Cuanto más estable sea la interfaz, menos probable es que cambie en las siguientes versiones del producto.

Problemas en relación a la próxima versión importante de Message Queue

La próxima versión importante de Message Queue puede introducir cambios que hagan que las aplicaciones de los clientes de Message Queue dejen de ser compatibles con el producto. Esta información puede ser revelada completamente.

• Las ubicaciones de los archivos instalados como parte de Sun GlassFish Message Queue pueden cambiar. Esto puede hacer que dejen de funcionar algunas de las aplicaciones que dependen de la ubicación actual de archivos de Message Queue.

• Es posible que el agente Message Queue 3.5 y agentes anteriores dejen de funcionar en un agrupaciones con agentes más recientes.

• En futuras versiones, es posible que los clientes de Message Queue no puedan utilizar versiones de JDK anteriores a la 1.5.

• En futuras versiones, es posible que los clientes de Message Queue no puedan utilizar versiones de JDK anteriores a la 1.6.

Cambios en el conjunto de documentación de Message Queue 4.4 Update 1

El conjunto de documentación de Message Queue 4.4 Update 1 incluye actualizaciones al conjunto de documentación de Message Queue 4.4 tal y como se describe a continuación:

Descripción general técnica

La Sun GlassFish Message Queue 4.4 Technical Overview contiene las nuevas funciones de &ProductName 4.4.

Guía de administración

La Sun GlassFish Message Queue 4.4 Administration Guide incluye pequeñas correcciones de errores y refleja nuevas funciones de Message Queue 4,4.

Guía del desarrollador para clientes Java

La Sun GlassFish Message Queue 4.4 Developer’s Guide for Java Clients incluye pequeñas correcciones de errores.

Guía del desarrollador para clientes C

La Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients incluye correcciones de errores menores.

La Guía del desarrollador para el cliente JMX

La Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients incluye el nombre de producto y número de versión de Message Queue.

Limitaciones y problemas conocidos

Esta sección contiene una lista de los problemas conocidos de Message Queue 4.4 Update 1. Se describen las siguientes áreas:

• Problemas relacionados con la instalación

• Opción de contraseña eliminada

• Problemas de administración y configuración

• Problemas de agentes

• Agrupaciones de agentes

• Problemas con JMX

• Compatibilidad con SOAP

Para consultar una lista de los fallos actuales, sus estados y sus soluciones alternativas, invitamos a los miembros de Java Developer Connection™ a visitar la página Bug Parade del sitio web Java Developer Connection. Consulte la página antes de informar sobre un nuevo error. A pesar de que no se muestran todos los problemas de Message Queue la página es un buen punto de partida para ver si un problema ha sido comunicado.

http://bugs.sun.com/bugdatabase/index.jsp

Aunque la suscripción a Java Developer Connection es gratuita, es necesario registrarse. Encontrará información sobre cómo ser miembro de Java Developer Connection en la página web "For Developers" de Sun.

Para informar de un nuevo problema o enviar una petición de nuevas funciones, envíe un mensaje a imq-feedback@sun.com .

Problemas relacionados con la instalación

Esta sección describe los problemas relacionados con la instalación de la versión 4.4 Update 1.

Registro del producto y Java ES

Message Queue 4.4, al igual que Message Queue 4.2 y 4.1, se instala mediante un instalador relativamente nuevo, que a su vez instala y actualiza los componentes compartidos de Java Enterprise System (Java ES) que requiere Message Queue; como por ejemplo, JDK, NSS, JavaHelp, etc.

El nuevo instalador de Message Queue y el antiguo instalador de Java ES, que se utilizaba para instalar versiones anteriores de Message Queue, no comparten el mismo registro del producto. Si una versión de Message Queue instalada con el instalador Java ES se elimina y, más adelante, se instala Message Queue 4.4 mediante el instalador de Message Queue, el registro del producto Java ES puede tener un estado incoherente. Como resultado, si se ejecuta el desinstalador Java ES, es posible que elimine Message Queue 4.4; y los componentes compartidos de los que depende por error, aunque dicho instalador no los haya instalado.

La mejor manera de actualizar el software Message Queue que instaló el instalador de Java ES es la siguiente.

1. Desinstale Message Queue y sus componentes compartidos con el desinstalador Java ES.

2. Vuelva a instalarlo con el instalador de Message Queue 4.4.

Instalación en todas las plataformas

Los siguientes problemas afectan a la instalación en todas las plataformas:

• La pantalla Listo para la instalación mostrará el nombre del producto como “mq”, en lugar de como Sun Java System Message Queue 4.3. (Fallo 6650841)

• Cuando el instalador está en proceso de instalar Message Queue 4.3 y aparece la pantalla de progreso, el botón Cancelar está activo. Si en ese momento se pulsara el botón Cancelar, la instalación quedaría incompleta o interrumpida. (Fallo 6595578)

• La pantalla de resumen del instalador contiene una serie de vínculos que, al pulsar sobre ellos, activan un registro o un visor de la página de resumen. Al cerrar la ventana de este visor con el botón X de la ventana en lugar de con el botón marcado con la etiqueta "cerrar", ya no podrá volver a abrir la ventana del visor. (Fallo 6587138)

  Solución: Cierre la ventana con el botón Cerrar.

• Al ejecutar el instalador en modo "sólo registro" (installer -r) después de realizar una instalación silenciosa en la que se ha omitido el registro, éste falla con un error "fin de archivo prematuro". (Fallo 6767988)

• Al ejecutar el instalador de Message Queue en un equipo sin ningún JDK instalado, aparece el siguiente mensaje de error: "Raíz no válida en clave de registro "HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion." (Fallo 6764358)

  Solución: instale el JDK antes de ejecutar el instalador.

• El instalador de Message Queue crea el directorio mqInstallHome antes de que el usuario haga clic en el botón Listo para instalar de la pantalla Listo para instalar. (Fallo 6595590)

Instalación en Windows

Al instalar Message Queue en Windows, tenga presente las siguientes limitaciones:

• La estructura de directorios de Message Queue 4.3 en la plataforma Windows es distinta a la de las versiones anteriores. Consulte Installed Directory Structure en la Sun Java System Message Queue 4.3 Installation Guide.

• El instalador no añade entradas de Message Queue en el menú Inicio>Programas. (Fallo 6567258)

  Solución: Para iniciar la consola de administración, utilice la línea de comandos tal y como se indica en la sección Starting the Administration Console de Sun GlassFish Message Queue 4.4 Administration Guide.

• El instalador no añade el directorio IMQ_HOME\mq\bin a la variable de entorno PATH). (Fallo 6567197)

  Solución: Los usuarios deben añadir esta entrada a la variable de entorno PATH o proporcionar un nombre de ruta completa al invocar las utilidades de Message Queue (IMQ_HOME\mq\bin\ command).

• El instalador no agrega entradas al registro de Windows para indicar que Message Queue está instalado. (Fallo 6586389)

• El instalador no añade el agente de Message Queue como servicio de Windows.

  Solución: añada manualmente el agente de Message Queue como servicio de Windows mediante el comando imqsvcadm.

• Si no hay ningún JDK instalado, el programa de instalación generará el siguiente error: "Raíz no válida en clave del registro HKLM\\SOFTWARE\\JavaSoft\\Java Runtime Environment\\CurrentVersion". (Fallo 6764358)\par

  Solución: si aparece este error, instale un JDK y continúe.

• Cuando se ejecuta en modo silencio con un archivo de respuesta, el instalador rebota de inmediato. La instalación se lleva a cabo, pero el usuario no tiene forma de saber cuándo se ha completado la instalación silenciosa.(Fallo 6586560)

• El programa de instalación instala Message Queue en C:\ incluso si el sistema operativo está instalado en una unidad diferente. (Fallo 6673511)

• Para instalar y desinstalar en Windows, no existen archivos .bat que el usuario pueda ejecutar ni instalar mediante la función Agregar o Quitar programas del panel de control de Windows. (Fallo 6673417)

• En Windows Vista no se puede instalar Message Queue en C:\Archivos de programa a menos que instale con una interfaz de línea de comandos como administrador. (Fallo 6701661)

  Solución: Para realizar la instalación con una interfaz de línea de comandos como Administrador:

  1. Inicio->Programas->Accesorios->Símbolos del sistema.

  2. Haga clic con el botón derecho del ratón en la ventana de línea de comandos.

  3. Seleccione Ejecutar como administrador.

  4. Cambie el directorio a la imagen de instalación de Message Queue 4.2.

  5. Ejecute installer.vbs.

• Si el desinstalador se ejecuta en modo de ejecución seca (uninstaller -n), realiza una desinstalación de forma incorrecta. (Fallo 6719051)

  Solución: Realice una instalación silenciosa utilizando el siguiente comando:

  uninstaller -s

• La cadena “Install Home” de la página inicial del instalador no está localizada. (Fallo 6592491)

• El desinstalador de Message Queue basado en zip se bloquea en 2003. (Fallo 6764370)

  Solución: eliminar manualmente el directorio mqInstallHome.

Instalación en Solaris

• Si el instalador se ejecuta en modo de ejecución seca (installer –n), la pantalla de resumen muestra algunos mensajes de error y el estado de instalación como “incompleto”. Esto es incorrecto y confunde al usuario; una ejecución seca no instala nada en el sistema, sino que crea sólo un archivo de respuesta que puede utilizarse después para realizar la instalación silenciosa. (Fallo 6594351)

• El instalador no realizará el registro en Sun Connection cuando se ejecute en modo silencioso con un archivo de respuesta (installer -a nombrearchivo -s). (Fallo 6710268)

Instalación en Linux

Estos son los problemas que se producen al hacer la instalación en la plataforma Linux:

• En Red Hat Linux 5, la biblioteca compat-libstdc++ necesaria para ejecutar aplicaciones de cliente C no está incluida en la distribución de Message Queue y, por lo tanto, el instalador de Message Queue no la instala. Si va a desarrollar y ejecutar clientes C, deberá instalar esta biblioteca manualmente.

  El rpm compat-libstdc++ suele estar incluido en el soporte de instalación de la versión de Linux que se esté utilizando. Se puede instalar mediante el comando siguiente:

  rpm -ivh compat-libstdc++-x-x.x.x.x..rpm

  x es el número de la versión.

  Para comprobar que la biblioteca se ha instalado correctamente, utilice el siguiente comando:

  rpm -qa | grep compat-libstdc++

• En Red Hat Linux 5, los clientes C pueden fallar con un error PR_LOAD_LIBRARY_ERROR (Error 6885978)

  En Red Hat Linux 5, los clientes C pueden fallar y mostrar un mensaje parecido a:

  "Preparing for NSS initialization ..." "Initializing NSS ..." "Could not connect to broker because 'PR_LOAD_LIBRARY_ERROR' (-5977)." producer(): Error: PR_LOAD_LIBRARY_ERROR

  Este error se produce porque las bibliotecas NSS/NSPR no están accesibles.

  Para solucionar este problema, defina la variable de entorno LD_LIBRARY_PATH para incluir la ruta a las bibliotecas NSS/NSPR, IMQ_HOME/nss/lib .

• En el panel de selección de JDK, la lista desplazable sólo muestra un elemento. Esto dificulta la selección de otro JDK de la lista. (Fallo 6584735)

• Si el JDK es actual y el usuario selecciona "Instalar JDK predeterminado" en la pantalla de selección de JDK, el instalador seguirá intentando instalarlo e informará de que no puede instalar el paquete. La instalación se realiza correctamente a pesar de este problema. (Fallo 6581310)

• Si el JDK instalado actualmente es una versión anterior a JDK 1.5.0_15 (la versión que normalmente instala el instalador de Message Queue), el desinstalador de Message Queue no podrá encontrar el directorio predeterminado IMQ_JAVAHOME y se producirá un error. (Fallo 6673415)

  Solución: Instale el JDK 1.5 manualmente de la siguiente manera antes de ejecutar el desinstalador de Message Queue.

  # cd installImage/Product/UNIX/LINUX/X86/2.4/Packages

  # rpm -i --force jdk-1.5.0_15–linux- arch.rpm

  arch es i586 o amd64.

• Si el instalador se ejecuta en modo de ejecución seca (installer –n), la pantalla de resumen muestra algunos mensajes de error y el estado de instalación como “incompleto”. Esto es incorrecto y confunde al usuario; una ejecución seca no instala nada en el sistema, sino que crea sólo un archivo de respuesta que puede utilizarse después para realizar la instalación silenciosa. (Fallo 6594351)

Anomalías de versión del instalador

El instalador muestra la información de la versión de Message Queue de una manera poco clara. (Fallo 6586507)

Plataforma Solaris

En la plataforma Solaris, consulte la siguiente tabla para determinar la versión de Message Queue que aparece en el instalador.

Para versiones con parche de 3.6 SP4 (por ejemplo, 3.6 SP4 Patch 1), la cadena de las versiones que muestra el instalador sigue siendo la misma. Debe ejecutar el comando imqbrokerd -version para determinar la versión exacta.

Plataforma Linux

En la plataforma Linux, el número de versión que aparece en el instalador tiene el siguiente formato.

majorReleaseNumber.minorReleaseNumber-someNumber

Por ejemplo, 3.7–22. Esto quiere decir únicamente que se trata de una de las versiones 3.7, pero no especifica cuál. Para determinar la versión de Message Queue instalada, ejecute el comando:

imqbrokerd -version.

Problemas relacionados con la traducción

Estos son los problemas relacionados con la localización.

• Cuando el instalador se ejecuta en modo texto (installer –t ) en una configuración regional de lengua no inglesa, los caracteres de varios bytes aparecen como texto basura. (Fallo 6586923)

• En la pantalla de progreso del instalador, la barra de progreso muestra caracteres extraños. La información sobre herramientas no es modificable en configuraciones regionales de lengua no inglesa. (Fallo 6591632)

• La pantalla de licencia del instalador muestra el texto de licencia en inglés, al margen de cuál sea la configuración regional en la que se haya ejecutado. (Fallo 6592399)

  Solución: Para acceder a los archivos de licencia traducidos, busque el archivo LICENSE_MULTILANGUAGE.pdf.

• El texto de ayuda sobre el uso del instalador no está traducido. (Fallo 6592493)

• La cadena "Ninguno" que aparece en la página resumen del instalador aparece en inglés y no es modificable. (Fallo 6593089)

• Cuando el instalador se ejecuta en una configuración regional alemana, la pantalla de Bienvenida no muestra el texto completo que se ve en otras configuraciones regionales. (Fallo 6592666)

• La cadena "Inicio de instalación" que se ve en la página del instalador del mismo nombre no está traducida. Aparece en inglés aunque el instalador se haya ejecutado en configuraciones regionales de lengua no inglesa. (Fallo 6592491)

• Cuando el instalador se ejecuta en modo texto (installer –t ), aparecen las opciones de respuesta en inglés "Yes" y "No", aunque el instalador se haya ejecutado en otra configuración regional. (Fallo 6593230)

• La información sobre herramientas del botón Examinar de la pantalla de selección de JDK del instalador aparece en inglés y no es modificable. (Fallo 6593085)

Opción de contraseña eliminada

En versiones anteriores de Message Queue, podía usarse la opción —p o —password para especificar la contraseña de manera interactiva para los siguientes comandos: imqcmd, imqbrokerd y imdbmgr. A partir de la versión 4.0., estas opciones se han eliminado.

En lugar de ello, puede crear un archivo de contraseñas que especifique las contraseñas relevantes y hacer referencia al archivo de contraseñas utilizando la opción del comando -passfile, o simplemente introducir una contraseña cuando el comando se lo solicite.

Un archivo de contraseñas puede contener una o varias de las contraseñas enumeradas más abajo.

• Una contraseña keystore utilizada para abrir el keystore de SSL. Utilice la propiedad imq.keystore.password para especificar la contraseña.

• Una contraseña de depósito LDAP utilizada para conectar de forma segura con un directorio LDAP si la conexión no es anónima. Utilice la propiedad imq.user_repository.ldap.password para especificar esta contraseña.

• Una contraseña de base de datos JDBC utilizada para conectarse con la base de datos compatible con JDBC. Utilice la propiedad imq.persist.jdbc.vendorName.password para especificar esta contraseña. El componente vendorName del nombre de propiedad es una variable que especifica el proveedor de la base de datos. Las opciones son hadb, derby, pointbase, oracle o mysql.

• Una contraseña para el comando imqcmd (para realizar tareas administrativas del agente). Utilice la propiedad imq.imqcmd.password para especificar esta contraseña.

En el siguiente ejemplo, la contraseña de la base de datos JDBC se ha establecido en el archivo de contraseñas como abracadabra.

imq.persist.jdbc.mysql.password=abracadabra

Puede utilizar un archivo de contraseñas de cualquiera de las siguientes formas.

• Configure el agente que va a utilizar el archivo de contraseñas estableciendo las siguientes propiedades en el archivo config.properties del agente.

  imq.passfile.enabled=trueimq.passfile.dirpath= contraseñaDirectorioArchivo imq.passfile.name=contraseñaNombreArchivo

• Utilice la opción -passfile del comando relevante, como por ejemplo:

  imqbrokerd -passfile contraseñaNombreArchivo

Problemas de administración y configuración

Los siguientes problemas son generados por la administración y la configuración de Message Queue.

• En plataformas Windows, debe añadir manualmente el agente de Message Queue como un servicio de Windows utilizando el comando imqsvcadm. El programa de instalación no hará por usted.

• En plataformas Windows, el cortafuegos integrado en Windows, que está activado de manera predeterminada, debe configurarse de forma manual con una regla de cortafuegos que permita al agente aceptar conexiones entrantes de clientes. (Fallo 6675595)

  1. En el Panel de control, haga doble clic en Firewall de Windows

     Debe hacer clic en Continuar en el cuadro de diálogo Control de cuentas de usuario para que se abra el cuadro de diálogo Configuración de Firewall de Windows.

  2. En el cuadro de diálogo Configuración de Firewall de Windows, haga clic en la ficha Excepciones.

  3. Haga clic en Añadir programa.

  4. En el cuadro de diálogo Añadir un programa, seleccione java.exe y haga clic en Examinar.

     Windows identifica el proceso del agente como Java Platform SE binary. Por lo tanto, busque el archivo java.exe que ha utilizado el agente (normalmente en jdk1.5.0_15\jre\bin\java.exe).

  5. Haga clic en Cambiar ámbito.

  6. En el cuadro de diálogo Cambiar ámbito, seleccione “Cualquier equipo (incluyendo los que están en Internet).”

  7. Haga clic en Aceptar.

  8. En el cuadro de diálogo Añadir un programa, haga clic en Aceptar.

  9. En el cuadro de diálogo Configuración de Firewall de Windows, haga clic en Aceptar.

• En plataformas Windows, los comandos imqadmin y imqobjmgr generan un error cuando CLASSPATH contiene comillas dobles. (Fallo 5060769)

  Solución: Abra una ventana de línea de comandos y anule CLASSPATH:

  set classpath=

  A continuación, ejecute el comando que desee con la misma ventana de línea de comandos, por ejemplo:

  mqInstallHome\mq\bin\imqadmin

• La opción -javahome en todas las secuencias de comandos de Solaris y Windows no funciona si el valor proporcionado contiene un espacio. ( Fallo 4683029)

  Los comandos y herramientas de Message Queue utilizan la opción javahome para especificar un entorno de tiempo de ejecución alternativo compatible con Java 2. Pero el nombre de la ruta del entorno de tiempo de ejecución de Java alternativo no debe contener espacios. A continuación le mostramos ejemplos de rutas que incluyen espacios.

  Windows: C:\jdk 1.4

  Solaris: /work/java 1.4

  Solución: Instale el tiempo de ejecución Java en una ubicación o ruta que no contenga espacios en blanco.

• El atributo imqQueueBrowserMaxMessagesPerRetrieve especifica el número máximo de mensajes que el tiempo de ejecución del cliente extrae a la vez cuando examina el contenido de una cola. El atributo influye en cómo se agrupan los mensajes en cola que se van a enviar al tiempo de ejecución de cliente, pero no afecta al número total de mensajes examinados. El atributo sólo afecta al mecanismo de navegación, no afecta al envío de los mensajes en cola. (Fallo 6387631)

• En plataformas Linux con SELinux, el comando pkg del Centro de actualización falla (Bug 6892062)

  Solución: Este error lo provoca un problema conocido del Centro de actualización (https://updatecenter2.dev.java.net/issues/show_bug.cgi?id=1211). Utilice el siguiente comando para activar pkg de modo que funcione en SELinux con activación forzada:

  # chcon -f -t textrel_shlib_t $IMAGE/pkg/vendor-packages/OpenSSL/crypto.so

Problemas de agentes

Los problemas siguientes afectan al agente de Message Queue.

• Los clientes de Message Queue 4.4 reciben una advertencia poco clara al conectarse con agentes de Message Queue 3.7 (Error 6899886)

  Cuando un cliente de Message Queue 4.4 se conecta a un agente de Message Queue 3.7, el cliente recibe una advertencia de tipo:

  WARNING [I500]: Caught JVM exception: ... 
  [C4036]: A broker error occurred. :[505] bad version ...

  Esta advertencia de “versión incorrecta” indica que el cliente debe conectarse al agente con un nivel de protocolo inferior.

• Al utilizar un almacén de datos JDBC, la contraseña de la base de datos se almacena como texto visible (Error 6691717)

  Solución: proteger el archivo de contraseña que contiene la contraseña de la base, tal y como se describe en Password Files de Sun GlassFish Message Queue 4.4 Administration Guide.

• No se puede tener acceso al agente cuando un almacén de datos persistente abre demasiados destinos. (Fallo 4953354)

  Solución: Esta situación se produce cuando el agente alcanza el límite de descriptor de archivos abiertos del sistema. En Solaris y Linux utilice la orden ulimit para incrementar el límite del descriptor de archivos.

• Cuando se destruye un destino, los consumidores se quedan sin referencia. ( Fallo 5060787)

  Los consumidores activos se quedan sin referencia cuando se destruye un destino. En ese caso, dejan de recibir mensajes (aunque se vuelva a crear el destino).

• Cuando un cliente JMS que utiliza servicio de conexión HTTP finaliza de forma abrupta (por ejemplo por el uso de Ctrl-C), el agente tarda aproximadamente un minuto en liberar la conexión del cliente y todos los recursos asociados.

  Si se inicia otra instancia del cliente dentro de este periodo de un minuto y si ésta intenta utilizar el mismo ClientID, la misma suscripción duradera o cola, es posible que se genere la excepción "ID de cliente ya en uso". No se trata de un problema real, es simplemente un efecto secundario del proceso de finalización descrito anteriormente. Si el cliente se inicia después de un retraso de aproximadamente un minuto, todo debería funcionar correctamente.

• Al utilizar la base de datos MySQL para un almacén de datos, los mensajes almacenados de más de 1 MB generarán una excepción SQL “El paquete de la consulta es demasiado grande...". (Fallo 6682815)

  Solución: Inicie el servidor MySQL con la opción --max_allowed_packet establecida en un valor mayor que 1 MB, el tamaño predeterminado. Por ejemplo, utilice el siguiente valor:

  --max_allowed_packet=60M

• Al utilizar la base de datos MySQL para un almacén de datos compartido de alta disponibilidad, se necesita un mecanismo para configurar el motor de almacenamiento MySQL como NDBCLUSTER . (Fallo 6691394)

  Solución: Añada la siguiente propiedad al archivo config.properties del agente (consulte la sección Enhanced Clusters: JDBC Configuration Properties de Sun GlassFish Message Queue 4.4 Administration Guide)

  imq.persist.jdbc.mysql.tableoption=EMGINE=NDBCLUSTER

• Si utiliza el controlador 9i de Oracle (JDBC 9.2.0.x), el agente genera la excepción "Fallo al definir propiedad como persistente...”. (Fallo 6626825)

  Solución: Utilice el controlador 10g de Oracle (JDBC 10.2.0.x), para el que el agente está optimizado.

  imq.persist.jdbc.derby.table.MYCONSTATE41.index.IDX2=CREATE INDEX &(index) ON $(name) (MESSAAGE_ID)

• Cuando utilice la base de datos Java DB para un almacén de datos, al almacenar un mensaje se generará la excepción SQL “no se ha podido obtener un bloqueo en el tiempo solicitado”. (Fallo 6691394)

  Solución: Añada el siguiente valor de propiedad al archivo config.properties del agente::

  imq.persist.jdbc.derby.table.MYCONSTATE41.index.IDX2=CREATE INDEX &(index) ON $(name) (MESSAAGE_ID)

• Al utilizar IBM JVM en AIX, el agente puede entrar en condición de memoria baja o RED sin motivo aparente (Error 6899526)

  Solución: utilice la versión más reciente de JVM IBM (Java Runtime 1.6.0 IBM Corporation o superior) y envíe la siguiente opción de IBM JVM GC a imqbrokerd:

  # imqbrokerd -vmargs -Xgcpolicy:gencon

Agrupaciones de agentes

Los siguientes problemas afectan a las agrupaciones de agentes.

• Agente de alta disponibilidad con almacén de datos MySQL Cluster no puede reiniciarse si se finalizó de manera inapropiada (Error 6896877)

  Solución: Este problema lo provoca un problema conocido de MySQL Cluster (http://bugs.mysql.com/bug.php?id=47955). Se ha aplicado una corrección de este problema a las versiones de MySQL 5.1.39-ndb-6.3.28 , 5.1.39-ndb-7.0.9 y 5.1.39-ndb-7.1.0.

• En esta versión, sólo se admiten agrupaciones de agentes totalmente conectadas. Esto significa que todos los agentes de una agrupación deben comunicarse directamente con todos los demás agentes de la agrupación. Si se conecta a agentes de una agrupación convencional mediante el argumento de línea de comandos imqbrokerd -cluster, asegúrese de que se incluyen todos los agentes del clúster.

• Si un cliente se conecta a un agente de una agrupación de agentes mejorada, el tiempo de ejecución del cliente intentará reconectar hasta que lo consiga (ignora el valor del atributo de fábrica de conexión imqAddressListIterations.)

• Un cliente sólo podrá examinar el contenido de las colas que estén ubicadas en su agente local. El cliente puede continuar enviando mensajes a cualquier cola o consumiendo mensajes desde una cola de cualquier agrupación; esta limitación sólo afecta a las funciones de exploración de colas.

• En una agrupación convencional que incluya agentes de la versión 4.3, todos los agentes deben ser de la versión 3.5 o posterior.

• Los agentes de Message Queue 4.3, 4.2 y 4.1 no pueden interoperar en una agrupación de forma predeterminada con agentes de Message Queue 3.7 o 3.6, dado que el valor predeterminado de imq.autocreate.queue.maxNumActiveConsumers se ha modificado entre estas versiones. (Fallo 6716400)

  Solución: Asegúrese de que todos los agentes tienen el mismo valor para la opción imq.autocreate.queue.maxNumActiveConsumers, normalmente, puede cambiar la configuración de Message Queue 4.3, 4.2 y 4.1 para que coincida con la que se usan los agentes de las versiones 3.7 y 3.6 (cambie el valor predeterminado -1 al valor de la versión anterior: 1).

• Para añadir un agente de Message Queue 4.3 (o 4.x) a una agrupación de agentes de Message Queue 3.x, el agente principal debe estar ejecutándose. (Fallo 6763796)

• Al convertir una agrupación convencional en una mejorada, puede usar la herramienta de administración de bases de datos de Message Queue (imqdbmgr ) para convertir un almacén de datos basado en JDBC independiente en un almacén de datos basado en JDBC compartido, como se explica en la sección Cluster Conversion: JDBC-Based Data Store de Sun GlassFish Message Queue 4.4 Administration Guide

• Un agente que utilice HADB no puede gestionar mensajes superiores a 10 MB. (Fallo 6531734)

• La conversión a un almacén HADB con el comando imqdbmgr upgrade hastore puede fallar y generar el mensaje "hay demasiados bloqueos establecidos" si el almacén contiene más de 10.000 mensajes. (Fallo 6588856)

  Solución: Utilice el siguiente comando para aumentar el número de bloqueos.

  hadbm set NumberOfLocks=<número>

  Para más información, consulte "Problemas de HADB" en la Guía de resolución de problemas de Sun Java System Application Server 9.1 Enterprise Edition.

• Si se confirman más de 500 mensajes remotos en una transacción, el agente podría devolver el error "HADB-E-12815: Espacio de memoria de tabla agotado.” (Fallo 6550483)

  Para más información, consulte "Problemas de HADB" en la Guía de resolución de problemas de Sun Java System Application Server 9.1 Enterprise Edition.

• En una agrupación de agentes, el agente coloca mensajes en la cola para una conexión remota que no se ha abierto. (Fallo 4951010)

  Solución: El consumidor recibirá los mensajes cuando se abra la conexión. Los mensajes se enviarán a otro consumidor si la conexión con el consumidor sigue cerrada.

• Al consumir más de un mensaje de un agente remoto en una transacción, es posible que se registre en el agente el siguiente mensaje de error. El mensaje es benigno y puede omitirse:

  [26/Jul/2007:13:18:27 PDT] WARNING [B2117]: 
  Message acknowledgement failed from 
  mq://129.145.130.95:7677/?instName=a&brokerSessionUID=3209681167602264320:
      ackStatus = NOT_FOUND(404)\
      Reason = Update remote transaction state to COMMITED(6): 
  transaction 3534784765719091968 not found, the transaction
  may have already been committed.
      AckType = MSG_CONSUMED
      MessageBrokerSession = 3209681167602264320
      TransactionID = 3534784765719091968
          SysMessageID = 8-129.145.130.95(95:fd:93:91:ec:a0)-33220-1185481094690
          ConsumerUID = 3534784765719133952\par
  
  [26/Jul/2007:13:18:27 PDT] WARNING Notify commit transaction 
  [8-129.145.130.95(95:fd:93:91:ec:a0)-33220-1185481094690, 
  [consumer:3534784765719133952, type=NONE]]
  TUID=3534784765719091968 got response: 
  com.sun.messaging.jmq.jmsserver.util.BrokerException:
   Update remote transaction state to COMMITED(6): 
    transaction 3534784765719091968 not found, the transaction may have already 
    been committed.:
  com.sun.messaging.jmq.jmsserver.util.BrokerException: Update remote transaction 
  state to COMMITED(6): transaction 3534784765719091968 not found, the transaction
   may have already been committed.r

  El mensaje se registra al notificar la confirmación al agente de inicio del mensaje para posteriores mensajes de la transacción cuando la propiedad imq.txn.reapLimit es baja comparada con el número de mensajes remotos de una transacción. (Fallo 6585449)

  Solución: Para evitar este mensaje, aumente el valor de la propiedad imq.txn.reapLimit.

Problemas con JMX

En la plataforma Windows, el método getTransactionInfo de Transaction Manager Monitor MBean devuelve información de la transacción con un tiempo de creación de transacción incorrecto. (Fallo 6393359)

Solución: Utilice el método getTransactionInfoByID de Transaction Manager Monitor MBean en su lugar.

Compatibilidad con SOAP

Es necesario que tenga en cuenta dos cuestiones relacionadas con la compatibilidad con SOAP

• A partir de la versión 4.0 de Message Queue, ya no se admiten objetos administrados por SOAP.

• El desarrollo de SOAP depende de varios archivos: SUNWjaf, SUNWjmail, SUNWxsrt y SUNWjaxp. En la versión 4.1 de Message Queue, estos archivos sólo están disponibles si ejecuta Message Queue con JDK versión 1.6.0 o posterior.

• Anteriormente, el archivo .jar de la implementación de SAAJ 1.2 hacía referencia directamente a mail.jar. En SAAJ 1.3 ya no existe esta referencia; por lo que los clientes de Message Queue deben poner mail.jar explícitamente en CLASSPATH .

Archivos redistribuibles

Sun GlassFish Message Queue 4.4 Update 1 contiene el siguiente conjunto de archivos que puede utilizar y distribuir libremente en formato binario:

Además, puede también redistribuir los archivos LICENSE y COPYRIGHT.

Funciones de accesibilidad para personas con discapacidad

Para utilizar funciones de accesibilidad que han aparecido desde la publicación de este software, consulte las evaluaciones de producto de la Sección 508 (se pueden pedir a Sun) para determinar qué versiones son las mejores para utilizar soluciones accesibles. Puede encontrar las versiones actualizadas de las aplicaciones en http://sun.com/software/javaenterprisesystem/get.html.

Para obtener información sobre el compromiso que tiene Sun con respecto a las funciones de accesibilidad, visite http://sun.com/access.

Cómo informar sobre problemas y enviar comentarios

Si experimenta problemas con Sun GlassFish Message Queue, póngase en contacto con el servicio de atención al cliente de Sun usando uno de estos procedimientos:

• Servicios de asistencia para software de Sun en línea: http://www.sun.com/service/sunone/software.

  Este sitio incluye vínculos con la base de datos de conocimiento, el centro de asistencia en línea (Online Support Center) y la herramienta ProductTracker, así como con programas de mantenimiento y números para ponerse en contacto con el personal de asistencia técnica.

• El número de teléfono del distribuidor asociado al contrato de mantenimiento.

Para poder ayudarle lo mejor posible a resolver problemas, tenga disponible la siguiente información cuando se ponga en contacto con el servicio de asistencia:

• Descripción del problema, incluida la situación en la que éste se produce y la forma en que afecta al funcionamiento.

• Tipo de equipo, versión del sistema operativo y versión del producto, incluida cualquier revisión del producto y otro software que pudiera influir en el problema.

• Pasos detallados de los métodos que haya usado para reproducir el problema.

• Cualquier registro de errores o volcados del núcleo.

Foro de Sun GlassFish

Puede consultar el foro de Sun GlassFish Message Queue en la ubicación siguiente:

http://swforum.sun.com/jive/forum.jspa?forumID=24

Apreciamos su participación.

Foro de tecnología Java

Los foros de tecnología Java incluyen un foro dedicado a JMS que puede interesarle.

http://forum.java.sun.com

Sun agradece sus comentarios

Sun tiene interés en mejorar la calidad de su documentación por lo que agradece sus comentarios y sugerencias.

Para enviar sus comentarios, acceda a http://docs.sun.com y haga clic en Send Comments (Enviar comentarios). En el formulario que aparece, especifique el título y el número de referencia del documento. El número de referencia es un número de siete o nueve dígitos que se encuentra en la portada del libro o en la parte superior del documento. Por ejemplo, el título de este libro es Notas de la versión, y el número de referencia 821-1512-10.

Recursos adicionales de Sun

Puede encontrar información útil de Sun GlassFish en las siguientes direcciones de Internet:

• Documentación

  http://docs.sun.com/prod/java.sys

• Servicios profesionales

  http://www.sun.com/service/sunps/sunone

• Productos de software y mantenimiento

  http://www.sun.com/software

• Servicios de asistencia de software

  http://www.sun.com/service/sunone/software

• Base de conocimientos y asistencia al cliente

  http://www.sun.com/service/support/software

• Servicios de asistencia y formación de Sun

  http://training.sun.com

• Servicios profesionales y de asesoría

  http://www.sun.com/service/sunps/sunone

• Información para programadores

  http://developers.sun.com

• Servicios de asistencia para programadores de Sun

  http://www.sun.com/developers/support

• Formación para el uso de software

  http://www.sun.com/software/training