Sun GlassFish Message Queue 4.4 Notas de la versión

Capítulo 1 Notas de la versión

Versión 4.4

Número de referencia 821-0890-05

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. 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 lea este documento.

Estas notas de la versión también contienen información sobre las versiones 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:

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.

Tabla 1–1 Historial de revisiones

Fecha 

Descripción de los cambios 

Octubre de 2009 

Versión de este documento para Message Queue 4.4. Incluye nuevas funciones de esta versión.  

Mayo de 2009 

Versión inicial de este documento para Message Queue 4.4 Beta. Incluye nuevas funciones de esta versión. 

Diciembre de 2008 

Versión de este documento para Message Queue 4.3. Incluye nuevas funciones de esta versión.  

Agosto de 2008 

Versión de este documento para Message Queue 4.2. Incluye nuevas funciones de esta versión.  

Septiembre de 2007 

Tercera versión de este documento para Message Queue 4.1. Incluye la descripción de la compatibilidad con Java Enterprise System Monitoring Framework, puertos C fijos, errores corregidos y otras funciones. 

Abril de 2007 

Segunda versión de este documento para Message Queue 4.1 Beta. Incorpora la función de alta disponibilidad. 

Enero de 2007 

Versión inicial de este documento para Message Queue 4.1 Beta. Incorpora la descripción de la compatibilidad con JAAS. 

Mayo de 2006 

Versión inicial de este documento para Message Queue 4.0. 

Acerca de Message Queue 4.4

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 es una versión secundaria creada para incluirse en la versión 2.1.1 de Sun GlassFish Application Server. Por tanto, Message Queue &Release no está disponible para su descarga e instalación por separado.

Plataformas y componentes compatibles con Message Queue 4.4

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

Sistemas operativos compatibles

Message Queue 4.4 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 GlassFish Message Queue 4.4 Installation Guide

Tabla 1–2 Versiones de sistemas operativos compatibles

Plataforma 

Versiones compatibles 

Solaris 

Solaris 9 (SunOS 5.9), todas las actualizaciones (SPARC, x86)

Solaris 10 (SunOS 5.10), todas las actualizaciones (SPARC, x86, x64)

Linux 

Red Hat Enterprise Linux Advanced Server 3.0, 4.0, 5.0, todas las actualizaciones, versiones de 32 y 64 bits (x86, x64)

Red Hat Enterprise Linux Enterprise Server 3.0, 4.0, 5.0, todas las actualizaciones, versiones de 32 y 64 bits (x86, x64)

AIX 

AIX 6.1 

Windows 

Windows Vista 

Windows XP Professional, SP2 ( x86) [No es compatible con Home, Tablet PC ni Media Center Edition]

Windows 2000 Advanced Server, SP4 (x86) [No es compatible con Professional ni Server Edition]

Windows Server 2003 Standard Edition y Enterprise Edition, SP2, versiones de 32 y 64 bits (x86, x64) [No es compatible con Web ni Small Business Server Edition]

Windows Server 2008 Standard Edition y Enterprise Edition, SP2, versiones de 32 y 64 bits (x86, x64)

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 las plataformas, Message Queue 4.4 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.


Nota –

El instalador de Message Queue para Solaris, Linux y Windows permite seleccionar un JDK/JRE ya instalado o instalar el kit JDK versión 1.5.0_15.


Tabla 1–3 Componentes necesarios

Componente 

Admite 

Versiones compatibles [Sólo versiones de producción de Sun Microsystems]

Java Runtime Environment (JRE)

Herramientas para agentes y administración de Message Queue 

Entorno de tiempo de ejecución J2SETM 1.5.0_15 o posterior

Entorno de tiempo de ejecución JavaTM SE 1.6.0_10

Java Software Development Kit (JDK), Standard Edition

Desarrollo e implementación de clientes Java 

Kit de desarrollo J2SE 1.5.0_15 o posterior 

Kit de desarrollo Java SE 1.6.0_10

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.

Tabla 1–4 Componentes de compatibilidad opcionales

Componente 

Admite 

Versiones compatibles 

Servidor de aplicaciones 

HTTP/HTTPS

Sun GlassFish Application Server Enterprise Edition, Versión 9.1 .1 (GlassFish Enterprise Server 2.1) 

Servidor web 

HTTP/HTTPS

Sun GlassFish Web Server Enterprise Edition, Versión 7.0, Update 3 

Base de datos 

Almacén de datos basado en JDBC 

HADB, Versión 4.4.3–6

Java DB (Apache Derby), Versión 10.4

MySQL Community/Enterprise Edition, Versión 5.0 

Oracle 9i, 10g y 11g 

postgreSQL, Versión 8.1 


Nota –

La base de datos PointBase ya no es compatible.


Base de datos de alta disponibilidad 

Clústeres de agente de alta disponibilidad 

HADB, Versión 4.4.3–6

MySQL Cluster Edition, Versión 5.0 

Oracle 10g y 11g 

Servidor de directorios Lightweight Directory Access Protocol (LDAP)

Objetos administrados y almacén del usuario de Message Queue 

Sun GlassFish Directory Server, Versión 6.0 

Interfaz de directorios y nombres Java (JNDI)

Compatibilidad con objetos administrados y almacén del usuario LDAP

JNDI Versión 1.2.1

LDAP Service Provider, Versión 1.2.2

File System Service Provider, Versión 1.2 Beta 3 [Sólo compatible con objetos administrados; permite desarrollar y comprobar el código, pero no implementar aplicaciones en un entorno de producción]

Compilador C y biblioteca de tiempo de ejecución C++ compatible 

Clientes C de Message Queue 

Solaris: Sun Studio, Versión 11 o posterior, compilador C++ con modo estándar y compilador C

Linux: gcc/g++, Versión 3.2.3

Windows: Microsoft Windows Visual C++, Versión 6.0 SP3

Netscape Portable Runtime (NSPR)

Clientes C de Message Queue 

Versión 4.7 [Integrado como paquete compartido en el paquete de descarga]

Network Security Services (NSS)

Clientes C de Message Queue 

Versión 3.11.9

Nuevas funciones de Message Queue 4.4 y versiones recientes

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

Nuevas funciones de Message Queue 4.4

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

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:

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:

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:

Mejoras adicionales

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

Nuevas funciones UMS (Universal Message Service)

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

Para ver una descripción general de UMS, consulte Universal Message Service (UMS). 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.

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.

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)

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

Ilustración que muestra el servicio UMS como puerta de enlace entre clientes no JMS y un proveedor JMS.

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.

Tabla 1–5 Ubicación del archivo imqums.war

Plataforma 

Ubicación de imqums.war

Solaris 

/usr/share/lib/imq

Linux 

/opt/sun/mq/share/lib

AIX 

IMQ_HOME/lib

Windows 

IMQ_HOME\lib

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:

Contenedores web compatibles

Actualmente, los siguientes contenedores web admiten UMS:

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:

Si necesita instrucciones de instalación, consulte el Capítulo 4, AIX Installation de Sun GlassFish Message Queue 4.4 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, Platform-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:

Mejoras adicionales

Message Queue 4.3 incluye las siguientes mejoras adicionales:

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 ordenador 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:

Tabla 1–6 Propiedades de envío y enrutamiento de agente

Propiedad 

Tipo 

Valor predeterminado 

Descripción 

imq.transaction.producer.maxNumMsgs

Entero 

1000

El número máximo de mensajes que un productor puede procesar en una única transacción. Se recomienda que el valor sea inferior a 5000 para evitar que se agoten los recursos.  

imq.transaction.consumer.maxNumMsgs

Entero 

100

El número máximo de mensajes que un consumidor puede procesar en una única transacción. Se recomienda que el valor sea inferior a 1000 para evitar que se agoten los recursos.  

imq.persist.jdbc.connection.limit

Entero 

5

El número máximo de conexiones que pueden estar abiertas en la base de datos. 

Mejoras de la API de administración JMX

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

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:

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.)


Nota –

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.)

Si necesita información sobre el uso de estas funciones, consulte Validación del esquema de mensajes de carga de datos XML.

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.


Nota –

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 detalles sobre el registro Message Queue con Sun Connection, consulte Sun GlassFish Message Queue 4.4 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:

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:

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:

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:


Nota –

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:


Precaución – Precaución –

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).

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.

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:

Errores solucionados en Message Queue 4.4 y versiones recientes

Message Queue 4.4 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

En la siguiente tabla se muestran los errores solucionados en Message Queue

Tabla 1–7 Errores solucionados en Message Queue 4.4

Error 

Descripción 

6242247 

Agrupación MQ con inicio de agente maestro (masterbroker) y se bloquea si ambos agentes se encuentran en el mismo sistema y tienen el mismo nombre 

6760937 

El agente no vuelve a conectarse con la base de datos si se reinicia 

6765410 

Cuando el agente maestro (masterbroker) envía intereses locales dos veces provoca una excepción de subordinado "Durable subscription already active" (la suscripción duradera ya está activa) 

6796506 

El mensaje remoto PREPARED no se envía tras deshacer si se agota el tiempo de espera de la respuesta PREPARE remota 

6821639 

NPE de rollback/commitTransaction durante recuperación AS para modo MQRA-DIRECT 

6836364 

El suscriptor de comodín no recibe el mensaje remoto si el tema se crea antes que el suscriptor 

6836749 

HA(JCAPS):ack existe en excepción de almacén de receptor después de 1 de deshacer duraderos y después confirma un mensaje 

6858905 

ConcurrentModificationException en Consumer.destroyConsumer 

Errores solucionados en Message Queue 4.3

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

Tabla 1–8 Errores solucionados en Message Queue 4. 3

Error 

Descripción 

6634033 

El protocolo de la agrupación no propaga el valor de imqConsumerFlowLimit a los agentes remotos cuando se crea un cliente.

6713012 

La destrucción de un consumidor en un agente de una agrupación al mismo tiempo que el agente remoto se está reiniciando puede provocar que no se reciban algunos mensajes. 

6727555 

En el mensaje de registro de agente "Max bytes per msg exceeded" aparecen el tamaño del mensaje y el valor de max bytes per message intercambiados.

6737404 

Las mediciones JMX deben proporcionar cantidades de mensajes enviados desde destinos (temas y colas) pero que todavía no han recibido los consumidores. 

6740568 

El agente genera una excepción cuando se consumen demasiados mensajes en una única transacción. 

6758524 

El comando para obtener una lista suscripciones duraderas (imqcmd lista dur -d " foo.*") no acepta caracteres comodines en el nombre del destino.

6758952 

Si se define la opción imq.portmapper.hostname=localhost, los agentes no pueden conectarse a una agrupación.

6758817 

Si se define la opción imq.cluster.hostname=localhost (no recomendado) los agentes de diferentes ordenadores no pueden conectarse a una agrupación.

Errores solucionados en Message Queue 4.2

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

Tabla 1–9 Errores solucionados en Message Queue 4.2

Error 

Descripción 

6581592 

Cuando el instalador o el desinstalador se ejecutan en modo texto (installer –t ), la pantalla Resumen muestra el directorio que contiene los archivos de registro y de resumen pero no enumera los nombres de estos archivos.

6585911 

La pantalla Selección de JDK del instalador incluye incorrectamente el JRE que se incluye con el instalador y que se utiliza para ejecutar el instalador. 

6587112 

La pantalla de resumen del instalador muestra elementos no utilizados en las configuraciones regionales de varios bytes. 

6587127 

Al ejecutar el instalador haciendo referencia a un archivo de respuesta (installer -a nombrearchivo -s), si el archivo de respuesta no existe, los mensajes de error serán incoherentes y confusos.

6590969 

Permite el formato de nombre de usuario DN en la autenticación de conexión del cliente. 

6594381 

La instalación de los RPM de localización de Message Queue 4.1 (que aparece si se selecciona la casilla de verificación “Instalar paquetes multilingües de Message Queue” en la pantalla Paquetes multilingües) no se realizará correctamente si ya existen en su sistema RPM de localización de Message Queue. 

6599144 

Cuando desinstale Message Queue 4.2, la pantalla de presentación y las pantallas y los márgenes del desinstalador aparecerán vacíos y grises en la versión Java SE 6, pero funcionarán en Java SE 5.  

6615741 

El mensaje entregado en una sesión de consumidor enviada que se ha deshecho no se volverá a enviar si el consumidor original se cerró antes de deshacerla. 

6629922 

El controlador de transacciones distribuidas no vuelve a enviar los mensajes a un consumidor inactivo en el orden correcto. 

6635130 

El agente no informa correctamente al productor sobre mensajes no persistentes para reanudar la producción tras haber realizado una pausa porque el destino ha alcanzado el límite de mensajes o memoria. 

6641117 

El mensaje enviado en una sesión de consumidor transaccionada que se ha deshecho no se volverá a entregar si el consumidor original se cerró después de deshacerla. 

6683897 

La pantalla de resumen del instalador de Message Queue informa sobre un error de configuración aunque parezca que se haya realizado correctamente: el instalador no puede escribir en /dev/sterr en algunos ordenadores.

6684069 

En la agrupación de agentes en la que se envía un gran número de mensajes al cliente remoto en las transacciones de consumidor, la transacción de confirmación no se realiza correctamente. 

6688935 

El valor predeterminado del tiempo de espera de lectura de Portmapper es demasiado pequeño. 

6695238 

Las aplicaciones de cliente C no se pueden conectar a un agente instalado en una ubicación que tenga espacios en la ruta. 

6710168 

El consumidor ya no consume mensajes si se realizan dos pausas en el destino sin reanudar el proceso entre las pausas. 

6710169 

El funcionamiento de JMX ConsumerManagerMonitor.getConsumerInfo siempre devuelve SESSION_TRANSACTED en el modo de confirmación.

Errores solucionados en Message Queue 4.1

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

Tabla 1–10 Errores solucionados en Message Queue 4.1

Error 

Descripción 

6381703 

Los mensajes remotos tramitados pueden confirmarse dos veces si se reinicia el agente que lo ha originado. 

6388049 

No es posible deshacer una transacción distribuido incompleta 

6401169 

Las opciones "confirmar" y "deshacer" de imqcmd no muestran un mensaje de confirmación. 

6473052 

El valor predeterminado de las colas autocreadas debería ser "round robin" (operación por turnos). (MaxNumberConsumers = -1).

6474990 

El registro del agente muestra ConcurrentModificationException para el comando imqcmd list dst.

6487413 

Se produce una pérdida de memoria cuando el comportamiento límite es REMOVE_OLDEST o REMOVE_LOWER_PRIORITY.

6488340 

El agente hace un "giro" y el cliente espera a que se atienda la respuesta. 

6502744 

El agente no cumple el límite predeterminado de 1000 mensajes de la cola de mensajes inactivos. 

6517341 

El tiempo de ejecución del cliente tiene que mejorar la lógica de reconexión cuando el cliente está conectado a una agrupación de agentes mejorada y permitir al cliente volver a conectarse al margen de cuál sea el valor de la propiedad imqReconnectEnabled.

6528736 

El servicio de inicio automático de Windows (imqbrokersvc) se bloquea durante el inicio.

6561494 

Los mensajes se envían al consumidor equivocado cuando ambos comparten una sesión. 

6567439 

Los mensajes generados en una transacción PREPARED se envían sin orden si se confirman después de que se reinicie el agente.

Errores solucionados en Message Queue 4.0

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

Tabla 1–11 Errores solucionados en Message Queue 4.0

Número de error 

Descripción 

4986481 

En Message Queue 3.5, la invocación de Session.recover podría bloquearse en el modo de conexión automática.

4987325 

El indicador de nueva entrega se establecía en false para mensajes enviados de nuevo después de invocar a Session.recover.

6157073 

Cambiado el mensaje de nueva conexión para que incluya el número de conexiones que se encuentran en el servicio además del número total de conexiones. 

6193884 

Message Queue genera un mensaje basura en syslog en configuraciones regionales que utilizan caracteres no ASCII en los mensajes. 

6196233 

No funciona la selección de mensajes con JMSMessageID.

6251450 

ConcurrentModificationException en connectList durante cierre de agrupación.

6252763 

java.nio.BufferOverflowException en java.nio.HeapByteBuffer.putLong/Int .

6260076 

El primer mensaje publicado tras el inicio es lento cuando se utiliza almacenamiento Oracle.  

6260814 

El procesamiento del Selector en JMSXUserID siempre evalúa como falso.

6264003 

El explorador de colas muestra mensajes que son parte de transacciones no confirmadas. 

6271876 

El control de flujo de la conexión no funciona correctamente cuando se cierra un consumidor que tiene mensajes no consumidos. 

6279833 

Message Queue no debería permitir que dos agentes utilicen las mismas tablas jdbc. 

6293053 

El agente maestro no se inicia correctamente cuando cambia la dirección IP del sistema, a menos que se borre el almacén (con —reset store.)

6294767 

El agente de Message Queue tiene que establecer SO_REUSEADDR en los sockets de la red que abra.

6304949 

No es posible configurar la propiedad ClientID de TopicConnectionFactory.

6307056 

El registro txn genera un cuello de botella en el rendimiento.

6320138 

La API C de Message Queue no tiene la capacidad de determinar el nombre de una cola de una cabecera de respuesta.  

6320325 

El agente a veces utiliza JDK 1.4 en vez de JDK 1.5 en Solaris, incluso si ambas versiones se encuentran instaladas.  

6321117 

Al iniciar agrupaciones de varios agentes se genera la excepción java.lang.NullPointerException .

6330053 

El cliente de jms devuelve java.lang.NoClassDefFoundError al confirmar una transacción desde el suscriptor.

6340250 

La API C admite el tipo MESSAGE.

6351293 

Se incluye compatibilidad con la base de datos Apache Derby.  

Actualizaciones de documentación de Message Queue 4.4

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

Problemas de compatibilidad

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

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.

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

El conjunto de documentación de Message Queue 4.4 incluye actualizaciones del conjunto de documentación de Message Queue 4.3 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 Message Queue 4.4.

Información de instalación y de actualización

La Sun GlassFish Message Queue 4.4 Installation Guide incluye información sobre la instalación de Message Queue en la plataforma AIX.

Guía de administración

La Sun GlassFish Message Queue 4.4 Administration Guide incluye una lista de errores corregidos, información sobre compatibilidad con la plataforma AIX y procedimientos revisados para administrar agrupaciones de agentes y convertir agentes convencionales en mejorados.

Guía del desarrollador para clientes Java

La Sun GlassFish Message Queue 4.4 Developer’s Guide for Java Clients incluye los nuevos números de versión, pero no tiene ningún otro cambio.

Guía del desarrollador para clientes C

La Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients incluye información sobre la generación de aplicaciones cliente C en la plataforma AIX.

La Guía del desarrollador para el cliente JMX

La Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients incluye mejoras en la API de JMX.

Limitaciones y problemas conocidos

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

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


Nota –

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.

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.

Instalación en todas las plataformas

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

Instalación en Windows

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

Instalación en Solaris

Instalación en Linux

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

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.

Tabla 1–12 Traducción de la cadena de versiones

Versión que muestra el instalador en el SO Solaris 

Versión de Message Queue correspondiente 

4.3.0.0 

4.3 

4.2.0.0 

4.2 

4.1.0.2 

4.1 Patch 2 

4.1.0.1 

4.1 Patch 1 

4.1.0.0 

4.1 

3.7.2.1 

3.7 UR2 Patch 1 

3.7.0.2 

3.7 UR2 

3.7.0.1 

3.7 UR1 

3.6.0.0 

3.6 

3.6.0.4 

3.6 SP4 

3.6.0.3 

3.6 SP3 

3.6.0.2 

3.6 SP2 

3.6.0.1 

3.6 SP1 


Nota –

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.

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.

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.

Problemas de administración y configuración

Los siguientes problemas están relacionados con la administración y la configuración de Message Queue

Problemas de agentes

Los problemas siguientes afectan al agente de Message Queue.

Agrupaciones de agentes

Los siguientes problemas afectan a las agrupaciones de agentes.

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

Archivos redistribuibles

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

fscontext.jar

jaas.jar

imq.jar

jms.jar

imqjmx.jar

libmqcrt.so (HPUX)

imqxm.jar

libmqcrt.so (UNIX)

imqums.war

mqcrt1.dll (Windows)

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:

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:

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-0890-05.

Recursos adicionales de Sun

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