Sun Java System Message Queue Notas de la versi�n

Sun Java™ System Message Queue Notas de la versi�n

Versi�n 3.5 SP1

N�mero de pieza 817-7199-10

Estas notas de la versi�n contienen informaci�n importante disponible en el momento del lanzamiento de la versi�n 3.5 SP1 de Sun Java™ System Message Queue (antes conocido como Sun™ ONE Message Queue). Este documento tambi�n incluye el contenido de las notas de la versi�n de Message Queue 3.5 para aquellos usuarios que deseen actualizar desde versiones anteriores a la 3.5. Aqu� se tratan nuevas funciones y mejoras, limitaciones y problemas conocidos, notas t�cnicas e informaci�n de otro tipo acerca de Message Queue 3.5.

La versi�n m�s actualizada de estas notas de la versi�n se encuentra en el sitio Web de documentaci�n de Sun Java System: http://docs.sun.com/coll/MessageQueue_35_SP1. 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

Tabla 1  Historial de revisiones

Fecha

Descripci�n de los cambios

12 de marzo de 2004

Actualizaci�n de la informaci�n sobre los errores. Actualizaci�n del apartado Limitaciones y problemas conocidos.

Adici�n del apartado Archivos que se pueden distribuir. Actualizaci�n del apartado Actualizaciones de la documentaci�n. Actualizaci�n del apartado Problemas de compatibilidad. Actualizaci�n del apartado Sun Java System Informaci�n.

9 de enero de 2004

Actualizaci�n de la informaci�n sobre la compatibilidad con PointBase 4.8; actualizaci�n de la informaci�n acerca de las funciones de las API escritas en C.

Acerca de Message Queue 3.5 SP1

Message Queue 3.5 SP1 es una actualizaci�n de Message Queue 3.5 que incluye todas las nuevas funciones de Message Queue 3.5. Adem�s, Message Queue 3.5 SP1 cuenta con algunos errores solucionados y con un nuevo nombre comercial. Este producto pertenece ahora a la familia de productos Sun Java™ System.

Se ha certificado que Message Queue 3.5 SP1 es compatible con la especificaci�n Java™ Message Service (JMS) 1.1: ha superado el Conjunto de pruebas de compatibilidad (Compatibility Test Suite, CTS) de JMS 1.1.

Este apartado describe los cambios efectuados en Message Queue 3.5 SP1 y aquellos que se realizaron en la versi�n anterior, Message Queue 3.5.

Message Queue 3.5 SP1

Message Queue 3.5 SP1 cuenta con errores solucionados y un nuevo nombre comercial para el producto y la documentaci�n.

Message Queue 3.5

Message Queue 3.5 inclu�a numerosas funciones nuevas:

Dichas funciones se describen en los subapartados siguientes.

Compatibilidad con clientes en C (Enterprise Edition)

Message Queue 3.5 incluye una interfaz de programaci�n de aplicaciones (API) escrita en C, as� como soporte durante el tiempo de ejecuci�n en C (en adelante, se hace referencia a esta funci�n como “cliente en C”). La funci�n de cliente en C se puede utilizar para integrar sistemas anteriores con el sistema de mensajer�a Message Queue. Se trata de una implementaci�n casi completa de la especificaci�n JMS. Admite todas las funciones JMS con excepci�n de: ciertos tipos de cuerpos (mapa, flujo y objeto), funciones de examinaci�n de colas y funciones de servidor de aplicaciones de J2EE (como las transacciones distribuidas y los objetos ConnectionConsumer).

El soporte de la funci�n de cliente en C lo proporciona un conjunto de bibliotecas que se instalan por separado y se habilita s�lo si se dispone de una licencia Enterprise Edition. En consecuencia, para actualizar de Platform Edition a Enterprise Edition, es necesario instalar el archivo de licencia de Enterprise Edition y las bibliotecas C.

Los usuarios de Platform Edition que activen el periodo de 90 d�as de prueba de la licencia de Enterprise Edition pueden usar la funci�n de cliente en C si se ponen en contacto con Sun usando el alias imq-feedback@sun.com para solicitar el kit de desarrollo de software (SDK) de la interfaz de programaci�n de aplicaciones (API) escrita en C. Los ingenieros son los encargados de responder a estas solicitudes y poner el SDK de la API escrita en C en el sitio FTP an�nimo. Una vez transcurridos los 90 d�as del periodo de prueba, la licencia caduca y los usuarios podr�n seguir creando clientes en C, pero no podr�n conectarlos a su agente de Platform Edition.

La funci�n de cliente en C requiere versiones espec�ficas del compilador en las diferentes plataformas de los sistemas operativos, lo que supone agregar nuevos requisitos a Enterprise Edition (consulte Message Queue Installation Guide para obtener m�s informaci�n). La funci�n de cliente en C tambi�n depende de las bibliotecas Netscape Portable Runtime (NSPR) y Network Security Service (NSS). (En Message Queue 3.5, la funci�n de cliente en C se prob� con �xito en Linux Red Hat Advanced Server 2.1. Las versiones de las bibliotecas NSPR y NSS en las que se prob� no se han certificado para esta edici�n de Linux.)

Actualmente, la API en C no admite el tipo de autenticaci�n b�sica. Si configura el agente para que use este tipo de autenticaci�n, fallar� la llamada a la funci�n MQCreateConnection y se mostrar� el resultado MQ_UNSUPPORTED_AUTH_TYPE.

La documentaci�n de la funci�n del cliente en C incluye material de referencia, informaci�n sobre la programaci�n y ejemplos de clientes API en C. Para obtener m�s informaci�n, consulte Message Queue C Client Developer’s Guide.

Recuperaci�n ante fallos de conexi�n con clientes Java (Enterprise Edition)

Message Queue 3.5 dispone de una funci�n de reconexi�n autom�tica mediante la cual se puede restablecer una conexi�n con un agente, ya sea el original u otro distinto (recuperaci�n ante fallos de conexi�n con clientes). La reconexi�n se realiza con el servicio de mensajer�a en lugar de con una instancia de agente espec�fica. Para que esta funci�n se pueda llevar a cabo, es necesario configurar el objeto administrado mediante la f�brica de conexiones (Message Queue 3.5 cuenta con un nuevo esquema de especificaci�n de direcciones para el servicio de mensajer�a). Para ello, debe especificar un conjunto de direcciones de agentes (imqAddressList). Cuando el tiempo de ejecuci�n del cliente debe establecer (o reestablecer) una conexi�n con un servicio de mensajer�a, intentar� conectarse a los agentes seg�n el orden de prioridad de la lista, hasta que encuentre uno que est� disponible o no encuentre ninguno. Puede especificar el n�mero de intentos de conexi�n (imqAddressListIterations) que se puede efectuar para conectarse a cada agente, as� como el intervalo de tiempo que debe transcurrir entre los intentos (imqAddressListInterval).

Si la reconexi�n autom�tica debe efectuarse a una instancia del agente que es distinta de la original, se pueden perder tanto los mensajes persistentes como las informaciones de estado que albergue el agente que ha fallado (o que se ha desconectado). Esto se debe a que las distintas instancias del agente presentes en un cl�ster no usan un almac�n persistente compartido con una alta disponibilidad. No obstante, la capacidad del tiempo de ejecuci�n del cliente para volver a conectarse autom�ticamente a una instancia del agente diferente le permite crear escenarios de recuperaci�n mediante los que un agente de respaldo o un cl�ster de agentes se pueden usar como sistema de protecci�n ante p�rdidas de datos (aunque no sea de forma completa).

Tambi�n, si la reconexi�n autom�tica est� habilitada, Message Queue 3.5 conservar� los destinos temporales cuando falle la conexi�n asociada, debido al hecho de que los clientes se pueden volver a conectar y acceder a ellos de nuevo. Los destinos temporales tendr�n el mismo tratamiento que otros destinos f�sicos, lo que puede requerir que analice regularmente los agentes de los destinos temporales que no se usen.

Para obtener m�s informaci�n, consulte Message Queue Java Client Developer’s Guide.

Message Queue dispon�a anteriormente de una funci�n de reconexi�n autom�tica mediante la cual el tiempo de ejecuci�n del cliente se pod�a reconectar a un agente si la conexi�n fallaba, excepto en situaciones en las que el estado del lado del cliente no se pod�a restablecer por completo en el agente al realizar la reconexi�n (por ejemplo, al usar sesiones de transacciones o destinos temporales, que existen s�lo mientras dura la conexi�n).

Control del flujo de mensajes mejorado en el agente

Se han introducido mejoras en el agente para optimizar el control del flujo de mensajes a los destinos y para evitar situaciones en las que la producci�n de mensajes es mucho mayor que la de su consumo. Adem�s, otras nuevas funciones de Message Queue 3.5 le pueden ayudar a eliminar los cuellos de botella en los flujos de mensajes fuera de los destinos. Consulte “Control del flujo mejorado del cliente Java” en la p�gina 6 y “Mejora de las pol�ticas de entrega para colas (Enterprise Edition)” en la p�gina 9.

Entre las mejoras del flujo de mensajes del agente se incluyen las siguientes:

Para obtener m�s informaci�n, consulte Message Queue Administration Guide.

Control del flujo mejorado del cliente Java

El tiempo de ejecuci�n del cliente Message Queue 3.5 gestiona el flujo de mensajes por consumidor y por conexi�n. Puede limitar el n�mero de mensajes que se almacena en la memoria b�fer por consumidor para evitar que un consumidor se vea saturado por otros consumidores. Esta funci�n supone tambi�n que, en el caso de que haya entregas para colas dirigidas a varios consumidores, se puede equilibrar mejor el env�o de mensajes a dichos usuarios. Esto tambi�n ayuda a gestionar los recursos de memoria en el tiempo de ejecuci�n del cliente Message Queue.

Un nuevo atributo de f�brica de conexiones, imqConsumerFlowLimit, permite limitar el n�mero de mensajes que se almacenan en la memoria b�fer por consumidor para todos los consumidores que comparten una conexi�n com�n. Cuando el n�mero de mensajes de la memoria b�fer de un consumidor es inferior al porcentaje definido (imqConsumerFlowThreshold) de imqConsumerFlowLimit, el agente puede enviar otro lote de mensajes al tiempo de ejecuci�n del cliente para uso de dicho consumidor. Si el n�mero total de mensajes almacenados en b�fer para todos los consumidores de una conexi�n excede el valor de imqConnectionFlowLimit, entonces la entrega de mensajes de la conexi�n cesar� hasta que el n�mero sea inferior al valor especificado.

La implementaci�n anterior del control del flujo del tiempo de ejecuci�n del cliente le permit�a limitar el n�mero de mensajes almacenados en b�fer en el tiempo de ejecuci�n del cliente en espera de ser consumidos (imqConnectionFlowLimit). El prop�sito de esta funci�n era limitar la cantidad de memoria usada por el cliente para almacenar en b�fer los mensajes de forma que los clientes que consum�an m�s despacio no se quedaran sin memoria. Esta funci�n se implement� en el nivel de conexi�n, lo que significa que si una conexi�n admite numerosos consumidores, una avalancha de mensajes procedentes de un consumidor podr�a evitar que otros consumidores recibieran mensajes.

Para obtener m�s informaci�n, consulte Message Queue Java Client Developer’s Guide.

Nuevas m�tricas de destino

Message Queue 3.5 incluye un sistema mejorado de seguimiento de mensajes y consumidores por destino, lo que permite una mejor supervisi�n y un mejor control de la memoria y el uso.

Las nuevas m�tricas aparecen como resultado del nuevo subcomando imqcmd metrics dst. Este comando muestra los totales acumulados (desde el inicio del muestreo), los valores actuales, los valores medios (calculados seg�n las muestras recogidas) y los valores de los picos (desde el inicio del muestreo) tanto para m�tricas de mensajes como de consumidores.

Por ejemplo, el comando imqcmd metrics dst -m ttl devuelve la siguiente informaci�n:

El comando imqcmd metrics dst -m con devuelve la siguiente informaci�n:

Para obtener m�s informaci�n, consulte Message Queue Administration Guide.

API de control remoto (Enterprise Edition)

Message Queue 3.5 proporciona una API basada en mensajes mediante la cual los clientes remotos JMS (o locales) pueden gestionar y analizar f�cilmente las m�tricas del agente. La API est� basada en la capacidad del agente para producir mensajes que contienen informaci�n sobre las m�tricas del agente, la m�quina virtual Java y los destinos individuales (consulte “Nuevas m�tricas de destino” en la p�gina 7). Los mensajes se env�an a destinos de temas espec�ficos, en funci�n de la entidad que se est� supervisando, cada vez que uno o varios consumidores se suscriben a los destinos. El cliente consumidor puede recuperar los mensajes, usar una propiedad de encabezado (type) para filtrarlos y, a continuaci�n, extraer la informaci�n sobre las m�tricas que contienen.

Para obtener m�s informaci�n, consulte Message Queue Administration Guide y Message Queue Java Client Developer’s Guide.

(Message Queue antes s�lo admit�a el inicio de sesi�n local de los datos de las m�tricas del agente y las consultas remotas de la informaci�n sobre las m�tricas usando las utilidades de administraci�n de Message Queue. Estas funciones, aunque proporcionaban datos de m�tricas importantes, no facilitaban el an�lisis de este tipo de datos.)

Adaptador de recursos de Message Queue para JMS (compatible con Application Server J2EE)

Message Queue 3.5 incluye un adaptador de recursos JMS para conectar el servicio de mensajer�a Message Queue JMS a cualquier servidor de aplicaciones compatible con J2EE.

Un adaptador de recursos es un modo est�ndar de agregar funciones adicionales a un servidor de aplicaciones J2EE (mediante la conexi�n a un EIS, un sistema de mensajer�a, etc.) ajust�ndose a la especificaci�n J2EE Connector Architecture (JCA 1.5). Esta arquitectura hace posible que cualquier servidor de aplicaciones J2EE admita, por ejemplo, un sistema de mensajer�a JMS con s�lo establecer una conexi�n con un proveedor JMS que incorpore la especificaci�n JCA 1.5: los componentes J2EE implementados y ejecutados en el entorno del servidor de aplicaciones pueden intercambiar mensajes JMS usando el proveedor JMS conectado (servidor y tiempo de ejecuci�n del cliente).

Para obtener m�s informaci�n, consulte Message Queue Administration Guide.

Confirmaci�n personalizada de los mensajes

Message Queue actualmente admite el modo de confirmaci�n del cliente JMS CLIENT_ACKNOWLEDGE mediante el cual un cliente JMS confirma expl�citamente el consumo de mensajes. En el modo CLIENT_ACKNOWLEDGE, el cliente ejecuta el m�todo acknowledge() de un objeto de mensaje, lo que provoca la confirmaci�n de todos los mensajes consumidos por la sesi�n desde la �ltima ejecuci�n del m�todo.

Message Queue 3.5 mejora este procedimiento al permitirle que sea usted quien confirme los mensajes individualmente. Es decir, puede confirmar s�lo un mensaje concreto, en lugar de confirmar por lotes todos los mensajes consumidos hasta ese momento. Esto se logra con la conversi�n del objeto de mensaje en un tipo de mensaje especial de Message Queue mediante el que se puede ejecutar un nuevo m�todo acknowledge(). Esto le permite desviarse del est�ndar JMS para gestionar necesidades espec�ficas de la aplicaci�n.

Para obtener m�s informaci�n, consulte Message Queue Java Client Developer’s Guide.

Mejora de las pol�ticas de entrega para colas (Enterprise Edition)

Se han realizado cambios en la implementaci�n de las entregas para colas dirigidas a varios consumidores, que antes estaba implementada como tres pol�ticas de entrega para colas distintas (colas de recepci�n individual, de conmutaci�n por error y de operaci�n por turnos). Message Queue 3.5 usa un enfoque m�s generalizado en el que las entregas se equilibran entre un n�mero de consumidores activos y de respaldo que se puede configurar. La implementaci�n de Message Queue 3.5 est� basada en los siguientes atributos de destino nuevos:

(Los nuevos consumidores ser�n rechazados si su n�mero supera la cantidad que resulta de la suma de estos dos atributos.)

Message Queue Platform Edition admite la entrega para colas con equilibrio de carga hasta para dos consumidores, mientras que Enterprise Edition admite un n�mero ilimitado de consumidores.

El nuevo mecanismo de equilibrado de carga tiene en cuenta la tasa de consumo de mensajes de los diferentes consumidores. Funciona de esta forma:

Para obtener m�s informaci�n, consulte Message Queue Administration Guide.

Mejora del rendimiento del cl�ster (Enterprise Edition)

En un entorno de cl�ster de agentes, los destinos se replican en todos los agentes y todos los mensajes entregados a dichos destinos se reenv�an a todos los agentes que tienen consumidores registrados en los destinos en cuesti�n, incluso si s�lo un peque�o porcentaje de los mensajes se va a entregar a un consumidor en concreto (por ejemplo, en el caso de un suscriptor duradero que usa criterios de selecci�n o un receptor de colas involucrado en una entrega para colas con equilibrio de carga). Este tr�fico de agente a agente puede causar avalanchas de mensajes, especialmente cuando un consumidor nuevo pasa a estar activo. Para reducir un tr�fico excesivo entre agentes en un cl�ster, Message Queue 3.5 incluye las siguientes mejoras:

Para obtener m�s informaci�n, consulte Message Queue Administration Guide.

Destinos locales (Enterprise Edition)

Un nuevo atributo de destino, isLocalOnly, le permite especificar un destino para que env�e mensajes s�lo a los consumidores locales (aquellos que est�n conectados al agente en el que se crea el destino) en contraposici�n a los consumidores conectados a otros agentes del cl�ster. Del mismo modo, se puede configurar para que s�lo reciba los mensajes enviados desde los productores locales. Puede usar esta propiedad para crear destinos independientes, destinos no interactivos con el mismo nombre en agentes diferentes de un cl�ster y para definir situaciones de recuperaci�n ante fallos mediante las cuales un mensaje se env�a a dos destinos, por si uno de ellos falla.

Para obtener m�s informaci�n, consulte Message Queue Administration Guide.

Cl�steres de agentes m�s seguros (Enterprise Edition)

En situaciones en la que la seguridad es un imperativo, la entrega de mensajes entre el cliente y el servidor de mensajes debe ser cifrada. Para ello, Message Queue 3.5 es compatible ahora con la entrega segura de mensajes entre los agentes de un cl�ster. Para conseguir una entrega de mensajes segura y cifrada en un cl�ster, es necesario configurar el servicio interno de conexi�n del cl�ster para que sea posible usar un protocolo de transporte basado en SSL.

Para obtener m�s informaci�n, consulte Message Queue Administration Guide.

Mejora del rendimiento del almacenamiento persistente

La implementaci�n del almac�n de datos de archivos sin formato de Message Queue y el almac�n de datos compatibles con JDBC se ha modificado en Message Queue 3.5 para mejorar el rendimiento. Dichas mejoras se describen en los dos apartados siguientes. Para obtener m�s informaci�n, consulte Message Queue Administration Guide.

Persistencia incorporada (almac�n de datos de archivos sin formato)

La mejora del rendimiento del almac�n de datos de archivos sin formato de Message Queue conlleva cambios internos en el formato de los datos que s�lo son evidentes al actualizar de Message Queue 3.01 (o anterior) a Message Queue 3.5.

La migraci�n del almac�n de archivos se gestiona autom�ticamente cuando se inicia por primera vez una instancia de agente de Message Queue 3.5 y hace referencia a una versi�n anterior del almac�n de archivos. Una copia del almac�n de archivos anterior se guarda en el directorio de instancias y deber� eliminarla manualmente una vez que la migraci�n se haya completado. Para eliminar autom�ticamente el almac�n de archivos anterior, en caso de que no haya espacio suficiente en disco para dos copias del almac�n, puede iniciar la versi�n 3.5 del agente con una opci�n agregada, tal y como se muestra en el siguiente comando:

imqbrokerd -upgrade-store-nobackup

(No hay espacios en upgrade-store-nobackup.)

La ra�z del nuevo almac�n de datos de archivos sin formato se cambia de:

…/instances/nombre_instancia/filestore/

a:

…/instances/nombre_instancia/fs350/.

Adem�s, la utilidad Command de Message Queue (imqcmd) tambi�n se ha perfeccionado para proporcionar m�tricas sobre el almac�n de archivos:

imqcmd metrics dst -n nombre_destino -t tipo -m dsk

Adem�s, imqcmd incluir� un nuevo comando para comprimir:

imqcmd compact dst -n nombre_destino -t tipo

Persistencia conectada (almac�n de datos compatible con JDBC™)

El almac�n de datos compatible con JDBC de Message Queue ha cambiado en Message Queue 3.5 para dar cabida a mejoras realizadas en la gesti�n de la memoria del agente (consulte “Control del flujo de mensajes mejorado en el agente” en la p�gina 5 y “Nuevas m�tricas de destino” en la p�gina 7) y para incluir una gama mayor de proveedores de bases de datos. Las modificaciones para hacer posible las mejoras de gesti�n de la memoria (categorizar los mensajes por destino) son cambios de esquema que se gestionan de forma transparente, pero el soporte de proveedores de bases de datos adicionales lleva consigo cambios en la forma de configurar la persistencia conectada.

La migraci�n del almac�n de archivos compatible con JDBC se gestiona autom�ticamente cuando se inicia por primera vez una instancia de agente de Message Queue 3.5 con una versi�n anterior del almac�n persistente. Sin embargo, las tablas antiguas se conservar�n intactas y ser� necesario eliminarlas manualmente con el nuevo comando imqdbmgr delete oldtbl una vez que la migraci�n se haya completado. Para eliminar las tablas antiguas de forma autom�tica, en el caso en que no disponga de espacio suficiente para dos copias del almac�n, puede iniciar el agente con la nueva opci�n: imqbrokerd -upgrade-store-nobackup.

Al igual que para el soporte de base de datos adicional, no se pod�an personalizar las instrucciones SQL de la base de datos compatible con JDBC que deseaba conectar (las instrucciones SQL se generaban internamente). Message Queue 3.5 incluye ahora nuevas propiedades de configuraci�n de instancias que le permiten personalizar el c�digo SQL que crea el esquema de base de datos de Message Queue. Existe una propiedad configurable para cada tabla de la base de datos: la propiedad es el c�digo SQL que crea la tabla. Dichas propiedades son necesarias para especificar correctamente los tipos de datos usados por la base de datos conectada. Se proporcionan ejemplos basados en la base de datos incorporada de PointBase, en lugar de en la base de datos anterior de Cloudscape.

Autenticaci�n y autorizaci�n espec�fica de la instancia

De forma predeterminada, con Message Queue 3.5, cada instancia tiene su propio repositorio de usuario basado en archivos y su propio archivo de control de acceso, ambos colocados en una ubicaci�n est�ndar: …/instances/nombre_instancia/etc/. Estos dos archivos se crear�n cuando la instancia del agente se inicie por primera vez. Si el agente encuentra estos archivos en la ubicaci�n antigua (lo que suele darse cuando se actualiza desde una versi�n anterior), copiar� los archivos en la ubicaci�n espec�fica de la instancia. Si el agente no los encuentra en la ubicaci�n antigua (que es el caso de las instalaciones nuevas), colocar� las versiones predeterminadas de los archivos en la ubicaci�n espec�fica de la instancia.

Para dar soporte a repositorios de usuario espec�ficos de la instancia, se ha agregado una opci�n -i nombre_instancia a la utilidad User Manager (imqusermgr) para determinar el repositorio de usuario espec�fico de la instancia al que se aplica cada comando imqusermgr.

Para obtener m�s informaci�n, consulte Message Queue Administration Guide.

Anteriormente, de forma predeterminada, todas las instancias del agente en un mismo ordenador compart�an el mismo repositorio de usuario basado en archivos y, en consecuencia, la misma contrase�a de inicio de sesi�n del cliente, y el mismo archivo de control de acceso. No obstante, se pod�a configurar cada instancia del agente para que usara una ubicaci�n del repositorio de usuario LDAP espec�fico o para que usara un archivo de control de acceso espec�fico (ambos especificados en el archivo de configuraci�n de la instancia).

Instalaciones Linux basadas en RPM

La instalaci�n de Message Queue 3.5 en Linux se realiza usando Red Hat Package Manager (RPM), un sistema de gesti�n de paquetes mediante la l�nea de comandos que puede instalar, desinstalar, verificar, consultar y actualizar paquetes de software (RPM).

Adem�s, la estructura de directorio instalada para Message Queue en Linux ha cambiado para ajustarse a las ubicaciones est�ndar usadas para los productos de Linux que no se distribuyen en paquetes. Las plataformas Solaris™ y Linux disponen de est�ndares que dependen de si el producto se distribuye o no en paquetes junto con el sistema operativo. En concreto, ya no existe un directorio de instalaci�n ra�z de Message Queue en Linux, al igual que ocurre con Solaris.

Para obtener m�s informaci�n, consulte Message Queue Installation Guide.

Soporte para el sistema operativo Solaris, X86 Platform Edition

En Solaris 9, Message Queue 3.5 es compatible con procesadores X86, adem�s de con los procesadores SPARC.

Requisitos de hardware y software

El hardware y el software requeridos para esta versi�n y los productos y plataformas admitidos se describen detalladamente en Message Queue Installation Guide.

Errores solucionados

Este apartado incluye breves descripciones de los errores solucionados:

Si desea acceder a listas anteriores de errores solucionados, consulte lo siguiente:

Para obtener informaci�n m�s detallada sobre los errores solucionados, puede consultar el informe completo en el sitio de Java Developer Connection:

Errores solucionados en Message Queue 3.5 SP1

La Tabla 2 describe los errores solucionados en Message Queue 3.5 SP1. (La Tabla 3 en la p�gina 16 describe los errores solucionados en Message Queue 3.5).

Tabla 2  Errores solucionados en Message Queue 3.5 SP1  

N�mero de error

Descripci�n

4942723

Puede que el agente se quede sin memoria al enviar mensajes extensos con la opci�n de grupo de subprocesos compartidos.

4944894

El agente puede generar ocasionalmente una excepci�n CancelledKeyException al usar grupos de subprocesos compartidos.

4947239

La creaci�n y el cierre repetido de los productores provocan una peque�a cantidad de crecimiento en la memoria del cliente.

4947993

No se puede destruir un destino o duraci�n con una suscripci�n duradera.

4948525

Se pueden mostrar n�meros negativos en el resultado de las m�tricas para los bytes de mensajes de entrada y salida. Esto ocurre cuando se env�an m�s de 2.143.510.810 bytes.

4948563

Conversi�n de paquetes: mensaje de informaci�n que se muestra cada vez que se env�a un mensaje 2.0 SP1 a un agente 3.5. Cada vez que un cliente 2.0 SP1 env�a un mensaje a un agente 3.5, se muestra el siguiente mensaje de informaci�n:

    [04/Nov/2003:10:34:16 PST] Internal Error: Unknown ProducerUID 0

4949781

Al iniciar el agente se muestra un mensaje acerca de la imposibilidad de usar el multidifusor del cl�ster.

4952332

Puede que los mensajes se env�en sin orden previa en caso de que el consumidor principal   falle durante una copia de respaldo del consumidor en la misma conexi�n.

4956748

No se puede usar un agente maestro con la base de datos de Oracle.

4964703

API en C: el encabezado MESSAGE_ID que devuelve la funci�n MQGetMEssageHeaders() no est� precedido de “ID:”.

4964712

API en C: el encabezado MESSAGE_ID definido por la funci�n MQSetMEssageHeaders() no se omite en el mensaje que se env�a.

4969583

API en C: la misma gesti�n del mensaje debe ser capaz de ejecutar MQAcknowledgeMessages() m�s de una vez.

4983150

El indicador JMSRedlivered no se define cuando un agente se reinicia y vuelve a enviar un mensaje.

4983699

El agente pierde las excepciones iniciadas por el almac�n cuando falla al persistir un mensaje.

Errores solucionados en Message Queue 3.5

La Tabla 3 describe los errores solucionados en Message Queue 3.5.

Tabla 3  Errores solucionados en Message Queue 3.5 

N�mero de error

Descripci�n

4449354

En casos poco frecuentes, si se llama a los m�todos Connection.stop, Connection.start y Connection.close al mismo tiempo que se llama a Session.recover y Session.rollback (en subprocesos independientes), se puede provocar una petici�n de reenv�o de mensajes inesperada.

4630183

La destrucci�n de un destino deja suscripciones duraderas en el agente.

4753010

Crecimiento ilimitado del segmento del mont�n nativo del proceso Java con VM de servidor.

4761626

La creaci�n y destrucci�n excesiva de consumidores con colas de creaci�n autom�tica pueden provocar la p�rdida de mensajes.

4855307

El agente no se puede autenticar en un repositorio LDAP porque la configuraci�n predeterminada usa un nombre de propiedad antigua (bindDN).

4883126

La funci�n de reconexi�n autom�tica no funciona correctamente.

4888270

La transmisi�n de nuevo de un mensaje enviado originalmente en una transacci�n provoca un error de agente.

4431924

imqadmin: los di�logos modales pueden provocar una situaci�n de interbloqueo.

La consola de administraci�n (imqadmin) utiliza di�logos modales para las aplicaciones. La mayor�a de estos di�logos aparecen de forma expl�cita al interactuar con la interfaz gr�fica de usuario; por ejemplo, si selecciona la opci�n de men� “Agregar agentes”. Sin embargo, algunos di�logos pueden aparecer tambi�n a causa de la p�rdida de la conexi�n de agente. Al abrirse varios di�logos, la consola de administraci�n se bloquea. No podr� cerrar los di�logos modales con el bot�n “Cerrar”.

4703406

QueueBrowser deber�a funcionar sin llamar primero a connection.start().

Se debe llamar a Connection.start() en una conexi�n antes de que QueueBrowser pueda examinar una cola. Si no puede llamar a Connection.start(), la enumeraci�n de QueueBrowser bloquear� nextElement() y acabar� devolviendo una excepci�n java.util. NoSuchElementException.

4866814

En Solaris, el agente no puede registrar mensajes de error ni advertencia usando syslog si �ste se ha iniciado con una JVM de 64 bits (el agente se inicia con ‘-vmargs -d64’). Esto ocurre porque la versi�n beta de Message Queue no contiene una versi�n de 64 bits de nuestra biblioteca, libimqutil.so.1.

4872121

El agente no se inicia en un sistema que no est� en red y que tenga una direcci�n IP distinta de 127.0.0.1.

4879902

Aumenta la ralentizaci�n de la memoria en el agente.

4881968

No se pueden crear nuevos clientes de supervisi�n si imq.autocreate.topic est� definido como falso.

4884827

Las pruebas CTS1.3 MDB/EJB CMT fallan con Message Queue 3.5 y con AppServer 7.0

4885654

Los productores pueden fallar si un nuevo mensaje se publica en un destino creado autom�ticamente en el mismo momento que el sistema est� cerrando el destino.

4887506

Durante la recuperaci�n ante fallos de un �nico cliente principal a un cliente de respaldo, los mensajes se pueden enviar sin orden previa.

4888939

Los clientes C y Java de un destino con una acci�n FLOW_CONTROL pueden dejar de recibir mensajes si el tama�o m�ximo del destino (maxNumMsgs) es muy peque�o (< 5 mensajes).

4889002

La propiedad imq.transaction.autorollback no se admite en la versi�n 3.5 beta.

4891874

El control del flujo basado en consumidores puede provocar que los mensajes dejen de enviarse a los consumidores. Este problema es m�s probable que se produzca con 4896133: Beans controlados mediante mensajes de ConnectionConsumers y Sun Java System Application Server 7.

4895262

Los clientes HTTPS fallan al conectarse al agente mediante HTTPSTunnelServlet

4897500

En un cl�ster, cuando un cliente ejecuta unsubscribe() para eliminar una suscripci�n duradera, �sta s�lo se elimina del agente al que est� conectado el cliente. Esto significa que los mensajes producidos para otros agentes continuar�n almacen�ndose para dicho suscriptor.

4898020

Los agentes de Message Queue 3.0.* y Message Queue 3.5 no se pueden usar juntos en un cl�ster. El inicio de un cl�ster mixto generar� un error en el agente 3.0.1:

discordancia de configuraci�n: anulando la conexi�n con el agente [...] ya que las siguientes propiedades de configuraci�n no coinciden: null imq.queue.deliverypolicy

4888983

imqcmd list dur no muestra suscriptores duraderos con el mismo nombre duradero.

Informaci�n importante

Este apartado incluye la �ltima informaci�n que contiene la documentaci�n principal del producto. En este apartado, se describen los siguientes temas:

Notas de la instalaci�n

Consulte Message Queue Installation Guide para obtener m�s informaci�n acerca de los requisitos de sistema; los productos y las plataformas de software; las instrucciones previas a la instalaci�n; los procedimientos de actualizaci�n; y otra informaci�n relevante para instalar Message Queue en las plataformas Solaris, Linux y Windows.

Problemas de compatibilidad

Este apartado trata sobre los problemas de compatibilidad existentes en Message Queue 3.5 SP1 y en Message Queue 3.5.

Problemas relacionados con la pr�xima versi�n principal de Message Queue

A continuaci�n, se muestran los cambios de incompatibilidades que se pueden provocar con la pr�xima versi�n principal de Message Queue. La informaci�n se proporciona ahora para que pueda adoptar las medidas necesarias ante dichos cambios.

Problemas de Message Queue 3.5

En l�neas generales, Message Queue 3.5 es compatible con Message Queue 3.0 (y las versiones posteriores 3.0.1, 3.0.1 Service Pack 1 y 3.0.1 Service Pack 2). No obstante, los cambios realizados en las propiedades, los objetos administrados, el esquema de persistencia, las ubicaciones de los archivos y las herramientas de administraci�n de los agentes pueden influir en la actualizaci�n de las versiones de Message Queue 3.0 a Message Queue 3.5.

La instalaci�n de Message Queue 3.5 no elimina ni sobrescribe el directorio IMQ_VARHOME de Message Queue 3.0. Este directorio contiene archivos de configuraci�n y de aspectos relacionados con la seguridad. La mayor parte de estos datos es compatible con Message Queue 3.5 y se pueden conservar usando las instrucciones que figuran en Message Queue Installation Guide.

Entre los problemas a los que puede enfrentarse a la hora de actualizar de Message Queue 3.0 a Message Queue 3.5, se incluyen los siguientes:

Para obtener informaci�n acerca de la compatibilidad con los objetos administrados, con los clientes y con las herramientas de administraci�n, consulte Message Queue Installation Guide.

Compatibilidad del agente

Un agente de Message Queue 3.5 funcionar� con un agente de Message Queue 3.0, a pesar de los cambios efectuados en las propiedades y el esquema de almacenamiento persistente del agente. Algunos de los datos de Message Queue 3.0 siguen siendo compatibles con Message Queue 3.5. Para obtener m�s informaci�n, consulte Message Queue Installation Guide.

Cambios en las propiedades y los atributos

Este apartado contiene un resumen de los cambios realizados en las propiedades, los atributos de destino y los atributos de la f�brica de conexiones del agente en Message Queue 3.5.

Propiedades del agente     En las siguientes tablas se enumeran las propiedades nuevas, las obsoletas y los cambios de nombre de propiedades que se han llevado a cabo en Message Queue 3.5. Para obtener m�s informaci�n, consulte el cap�tulo 2 de Message Queue Administration Guide.

Tabla 4  Nuevas propiedades del agente de Message Queue 3.5 

Nombre de propiedad

Referencia a la funci�n

imq.persist.file.message.max_record.size

“Mejora del rendimiento del almacenamiento persistente” en la p�gina 11

imq.persist.file.destination.message.
filepool.limit

“Mejora del rendimiento del almacenamiento persistente” en la p�gina 11

imq.metrics.topic.enabled

“API de control remoto (Enterprise Edition)” en la p�gina 8

imq.metrics.topic.interval

“API de control remoto (Enterprise Edition)” en la p�gina 8

imq.metrics.topic.persist

“API de control remoto (Enterprise Edition)” en la p�gina 8

imq.metrics.topic.timetolive

“API de control remoto (Enterprise Edition)” en la p�gina 8

imq.autocreate.destination.maxNumMsgs

“Control del flujo de mensajes mejorado en el agente” en la p�gina 5

imq.autocreate.destination.maxTotalMsgBytes

“Control del flujo de mensajes mejorado en el agente” en la p�gina 5

imq.autocreate.destination.maxBytesPerMsg

“Control del flujo de mensajes mejorado en el agente” en la p�gina 5

imq.autocreate.destination.maxNumProducers

“Control del flujo de mensajes mejorado en el agente” en la p�gina 5

imq.autocreate.queue.maxNumActiveConsumers

“Mejora de las pol�ticas de entrega para colas (Enterprise Edition)” en la p�gina 9

imq.autocreate.queue.maxNumBackupConsumers

“Mejora de las pol�ticas de entrega para colas (Enterprise Edition)” en la p�gina 9

imq.autocreate.queue.consumerFlowLimit

“Control del flujo mejorado del cliente Java” en la p�gina 6 y “Mejora de las pol�ticas de entrega para colas (Enterprise Edition)” en la p�gina 9

imq.autocreate.topic.consumerFlowLimit

“Control del flujo mejorado del cliente Java” en la p�gina 6

imq.autocreate.queue.localDeliveryPreferred

“Mejora del rendimiento del cl�ster (Enterprise Edition)” en la p�gina 10

imq.autocreate.destination.isLocalOnly

“Destinos locales (Enterprise Edition)” en la p�gina 11

Tabla 5  Funciones obsoletas del agente de Message Queue 3.5  

Nombre de propiedad

imq.persist.file.message.fdpool.limit

imq.persist.file.message.filepool.limit

imq.redelivered.optimization

imq.queue.deliverypolicy

En la siguiente tabla aparecen los atributos de funci�n nuevos y obsoletos de Message Queue 3.5. Para obtener m�s informaci�n, consulte el cap�tulo 6 de Message Queue Administration Guide.

Tabla 6  Nuevos atributos de destino de Message Queue 3.5 

Tipo de destino

Nombre de atributo

Referencia a la funci�n

Cola y tema

maxNumMsgs

“Control del flujo de mensajes mejorado en el agente” en la p�gina 5

Cola y tema

maxTotalMsgBytes

“Control del flujo de mensajes mejorado en el agente” en la p�gina 5

Cola y tema

limitBehavior

“Control del flujo de mensajes mejorado en el agente” en la p�gina 5

Cola y tema

maxBytesPerMsg

“Control del flujo de mensajes mejorado en el agente” en la p�gina 5

Cola y tema

maxNumProducers

“Control del flujo de mensajes mejorado en el agente” en la p�gina 5

Cola s�lo

maxNumActiveConsumers

“Mejora de las pol�ticas de entrega para colas (Enterprise Edition)” en la p�gina 9

Cola s�lo

maxNumBackupConsumers

“Mejora de las pol�ticas de entrega para colas (Enterprise Edition)” en la p�gina 9

Cola y tema

consumerFlowLimit

“Control del flujo mejorado del cliente Java” en la p�gina 6 y “Mejora de las pol�ticas de entrega para colas (Enterprise Edition)” en la p�gina 9

Cola s�lo

localDeliveryPreferred

“Mejora del rendimiento del cl�ster (Enterprise Edition)” en la p�gina 10

Cola y tema

isLocalOnly

“Destinos locales (Enterprise Edition)” en la p�gina 11

Tabla 7  Atributos de destino obsoletos de Message Queue 3.5  

Tipo de destino

Nombre de atributo

Cola

QueueDeliveryPolicy

Atributos de la f�brica de conexiones     En la siguiente tabla aparecen los atributos de f�brica de conexiones nuevos de Message Queue 3.5. Para obtener m�s informaci�n, consulte el cap�tulo 4 de Message Queue Java Client Developer’s Guide. Tenga en cuenta que los atributos de f�brica de conexiones de Message Queue 3.0 siguen siendo compatibles con Message Queue 3.5 y se seguir�n usando hasta la pr�xima versi�n principal del producto Message Queue.

Tabla 8  Nuevos atributos de f�brica de conexiones de Message Queue 3.5 

Nombre de atributo

Referencia a la funci�n

imqAddressList

“Recuperaci�n ante fallos de conexi�n con clientes Java (Enterprise Edition)” en la p�gina 4

imqAddressListBehavior

“Recuperaci�n ante fallos de conexi�n con clientes Java (Enterprise Edition)” en la p�gina 4

imqAddressListIterations

“Recuperaci�n ante fallos de conexi�n con clientes Java (Enterprise Edition)” en la p�gina 4

imqReconnectEnabled

“Recuperaci�n ante fallos de conexi�n con clientes Java (Enterprise Edition)” en la p�gina 4

imqReconnectAttempts

“Recuperaci�n ante fallos de conexi�n con clientes Java (Enterprise Edition)” en la p�gina 4

imqReconnectInterval

“Recuperaci�n ante fallos de conexi�n con clientes Java (Enterprise Edition)” en la p�gina 4

imqConsumerFlowLimit

“Control del flujo mejorado del cliente Java” en la p�gina 6

imqConsumerFlowThreshold

“Control del flujo mejorado del cliente Java” en la p�gina 6

Tabla 9  Atributos de la f�brica de conexiones con cambio de nombre 

Nombre anterior

Nombre en Message Queue 3.5

imqFlowControlCount

imqConnectionFlowCount

imqFlowControlIsLimited

imqConnectionFlowLimitEnabled

imqFlowControlLimit

imqConnectionFlowLimit

Ubicaci�n de los archivos p�blicos .jar

En la plataforma Solaris, la ubicaci�n de los archivos p�blicos .jar se ha modificado en Message Queue 3.0.1 con respecto a la ubicaci�n que ten�an en Message Queue 3.0 (/usr/share/lib/imq/). La ubicaci�n nueva es: /usr/share/lib/. Se han eliminado los enlaces simb�licos que se introdujeron en Message Queue 3.0.1 en /usr/share/lib/imq/ para los archivos .jar que se hab�an desplazado.

Esto se aplica a los siguientes archivos .jar:

Actualizaciones de la documentaci�n

Este apartado describe los cambios efectuados en la documentaci�n de Message Queue en las versiones 3.5 SP1 y 3.5.

Cambios en la versi�n 3.5 SP1

Los siguientes documentos de Message Queue 3.5 SP1 se han actualizado desde la versi�n 3.5 del producto:

Gu�a de instalaci�n

Message Queue Installation Guide se ha actualizado para reflejar la informaci�n sobre los cambios de marca y de compatibilidad con la plataforma.

Gu�a de administraci�n

Message Queue Administration Guide se ha cambiado de nombre (antes se llamaba Message Queue Administrator’s Guide) para reflejar los cambios en la marca. Este documento tambi�n contiene un cap�tulo ampliado y actualizado donde se describe la supervisi�n del rendimiento.

Gu�a del desarrollador del cliente Java

Message Queue Java Client Developer’s Guide se ha actualizado para reflejar los cambios de marca.

Gu�a del desarrollador del cliente C

Message Queue C Client Developer’s Guide se ha actualizado para reflejar los cambios de marca.

Cambios en la versi�n 3.5

Los siguientes documentos de Message Queue 3.5 se han actualizado de la versi�n 3.0.1 del producto. Estos documentos actualizados se encuentran en el sitio Web de documentaci�n de Message Queue 3.5: http://docs.sun.com/coll/S1_MessageQueue_35.

Gu�a de instalaci�n

El producto Message Queue 3.5 incluye una actualizaci�n de Message Queue Installation Guide. En dicha gu�a se describen los nuevos requisitos de software, los cambios en las instrucciones de instalaci�n de Solaris, el nuevo procedimiento de instalaci�n en Linux usando Red Hat Package Manager (RPM) y la estructura de directorio instalada, as� como otros cambios menores relacionados con la instalaci�n en Windows.

Correcci�n: con respecto al soporte de la persistencia conectada, la tabla 1-2 especifica que Message Queue admite la versi�n 4.5 de PointBase. En realidad, la versi�n admitida de PointBase es la 4.8.

Gu�a del administrador

Message Queue Administration Guide se ha actualizado para incluir los cambios realizados en Message Queue 3.5 (consulte “Este apartado describe los cambios efectuados en Message Queue 3.5 SP1 y aquellos que se realizaron en la versi�n anterior, Message Queue 3.5.” en la p�gina 2).

Gu�a del desarrollador del cliente Java

Message Queue Java Client Developer’s Guide contiene la mayor parte del contenido de la gu�a anterior, Message Queue Developer’s Guide, y se ha actualizado para incluir los cambios de Message Queue 3.5 (consulte “Este apartado describe los cambios efectuados en Message Queue 3.5 SP1 y aquellos que se realizaron en la versi�n anterior, Message Queue 3.5.” en la p�gina 2).

Gu�a del desarrollador del cliente C

Message Queue C Client Developer’s Guide es un documento nuevo que se ha agregado a la documentaci�n de Message Queue en el que se describe la forma de crear aplicaciones de Message Queue con clientes en C.

Limitaciones y problemas conocidos

Este apartado describe las limitaciones y los problemas conocidos, as� como los errores de Message Queue 3.5 SP1 Message Queue 3.5. Dado que la versi�n 3.5 SP1 es �nicamente una versi�n en la que se incluyeron el cambio de marca de Message Queue 3.5, la informaci�n que aqu� se presenta es aplicable a ambas versiones.

Para obtener una lista de los errores actuales, su estado y las soluciones, los miembros de Java Developer Connection™ deben consultar la p�gina “Bug Parade” en el sitio Web de Java Developer Connection. Compruebe la p�gina antes de informar de un nuevo error. No encontrar� aqu� todos los errores de Message Queue, se trata simplemente de un buen punto de partida para saber si se ha notificado un error.

La p�gina en cuesti�n es:

Para informar de un nuevo error o enviar una solicitud de funci�n, env�e un mensaje de correo electr�nico a imq-feedback@sun.com.

Problemas conocidos

En este apartado se describen los errores conocidos de Message Queue 3.5 SP1. Algunos de estos errores se introdujeron con la versi�n Message Queue 3.5. Las limitaciones que se muestran en este apartado est�n agrupadas seg�n hagan referencia a Enterprise Edition y a Platform Edition de Message Queue o s�lo a Enterprise Edition.

En Enterprise Edition y Platform Edition

S�lo en Enterprise Edition

Errores conocidos

En la Tabla 10 se enumeran los errores m�s importantes de Message Queue 3.5 SP1.

Tabla 10   Errores conocidos de Message Queue 3.5 

N�mero de error

Detalles

4683029

La opci�n -javahome de todas las secuencias de comandos de Solaris/Win no funciona si el valor incluye un espacio en blanco.

Los comandos y utilidades de Message Queue utilizan la opci�n -javahome para especificar un tiempo de ejecuci�n alternativo, compatible con Java 2. Sin embargo, la ruta al tiempo de ejecuci�n Java alternativo no debe contener espacios en blanco.

Ejemplos de rutas que contienen espacios en blanco:

      Windows:

      C:\jdk 1.4 (En Windows, la ruta puede contener espacios en blanco si se usan comillas, como por ejemplo, “C:\jdk 1.4”)

      Solaris:

      /work/java 1.4

Soluci�n del problema: instale el tiempo de ejecuci�n Java en una ubicaci�n o ruta que no contenga espacios en blanco.

4939923

El agente puede generar una excepci�n NullPointerException cuando se usa un grupo de subprocesos compartidos y la JVM del agente se est� ejecutando con poca memoria.

  Soluci�n del problema: ninguna. Este error est� solucionado en J2SE 1.4.2_03.

4941058

Los destinos en los que est� activado el control de flujo puede que no alcancen el l�mite m�ximo. Hay situaciones en las que a los productores se les impide que env�en mensajes a un destino antes de que dicho destino alcance el l�mite m�ximo configurado.

  Soluci�n del problema: ninguna.

4941066

Los destinos pueden superar levemente el l�mite de bytes asignado.

  Soluci�n del problema: ninguna.

4941127

El destino no se cargar� por completo si el mensaje supera el l�mite del tama�o del mensaje individual. Si el l�mite de tama�o de los mensajes permitidos en un destino se cambia despu�s de almacenar un mensaje grande, el destino no se cargar� correctamente.

  Soluci�n del problema: aumente el l�mite de tama�o de los mensajes hasta que se consuma el mensaje grande y, a continuaci�n, establezca un l�mite inferior. Se podr�a pausar la producci�n del destino durante este tiempo para impedir que se acepten otros mensajes grandes.

4946531

La excepci�n inofensiva NullPointerException se puede producir en raras ocasiones al crear mensajes.

  Soluci�n del problema:   ninguna. La excepci�n de puntero nulo se puede omitir sin problemas.

4949398

imqcmd query dst registra valores incorrectos en cuanto al n�mero de mensajes y al total de bytes del mensaje cuando se carga el destino correspondiente. Los valores registrados son correctos antes de cargar el destino y despu�s de hacerlo.

Soluci�n del problema: el problema s�lo se produce mientras se carga el destino. Una vez que est� cargado el destino, los valores que se devuelven son correctos.

4950166

Errores aleatorios en el agente cuando se ejecuta en sistemas jdk1.4.2_02 y x86. Para obtener m�s informaci�n, consulte J2SE, error n�mero 4947404.

  Soluci�n del problema: inicie el agente con -XX:UseSSE=0, por ejemplo

imqbrokerd -tty -vmargs -XX:UseSSE=0

4950601

imqcmd metrics dst genera un error interno del agente cuando se usa el almac�n persistente JDBC.

La informaci�n sobre las m�tricas de uso del espacio se aplica s�lo al almac�n de archivos. No obstante, cuando se recupera la informaci�n sobre las m�tricas, el agente intentar� obtener la informaci�n sobre el uso del disco, independientemente del tipo de almac�n. Si se usa una base de datos en lugar de un almac�n de archivos, el agente mostrar� el siguiente mensaje de error:

  06/Nov/2003:22:57:36 PST] ERROR [B3100]: Unexpected Broker Internal

  Error : [unable to disk usage for destinationT:topic1] :

  com.sun.messaging.jmq.jmsserver.util.BrokerException:
  La operaci�n no se aplica al almac�n persistente conectado.

  Soluci�n del problema: ninguna.

4951010

En un cl�ster de agentes, un agente puede poner en cola mensajes para una conexi�n remota que es posible que no est� iniciada.

  Soluci�n del problema: el consumidor recibir� los mensajes una vez que se inicie la conexi�n. Los mensajes se enviar�n a otro usuario si la conexi�n del consumidor est� cerrada.

4953348

En ocasiones, HTTPS createQueueConnection genera excepciones en Windows 2000.

  Soluci�n del problema: intente establecer una nueva conexi�n.

4953354

El agente pasa a estar inaccesible cuando un almac�n persistente abre demasiados destinos.

Soluci�n del problema: este hecho est� provocado por el agente que alcanza el l�mite del descriptor de archivos abiertos del sistema. En Solaris y en Linux use el comando ulimit para aumentar el l�mite del descriptor de archivos.

4954974

La instalaci�n no se inicia autom�ticamente al usar el CD de soporte en Windows XP.

  Soluci�n del problema: en el explorador de Windows, haga doble clic en la carpeta del CD y, despu�s, vuelva a hacer clic en el archivo imq3_5-ent-win.exe para ejecutar el instalador.

4983525

En Linux Red Hat Advanced Server 3.0, es posible que falle la creaci�n de un productor de mensajes para un destino creado autom�ticamente.

  Soluci�n del problema: vuelva a crear el productor. Puede que al segundo intento, lo logre. De lo contrario, use un destino creado administrativamente.

4986318

El cliente puede generar de forma inesperada un mensaje ACKNOWLEDGE_REPLY:

******** Packet: ACKNOWLEDGE_REPLY(25):26-192.18.86.227-42976-1075458056557

Magic/Version: 469754818/301  Size: 97 Type: ACKNOWLEDGE_REPLY(25)

Expiration: 0   Timestamp: 1075458056557

Source IP: 192.18.86.227   Source Port: 42976  Sequence: 26

Soluci�n del problema: ninguna. Se trata de una condici�n de temporizaci�n extra�a en el agente que provoca la generaci�n de este error por parte del cliente. Este error se puede omitir. No se perder� ning�n mensaje.  

4991257

El env�o de mensajes persistentes extensos a suscriptores duraderos de un cl�ster de agentes en los que el almac�n persistente est� basado en JDBC puede provocar que el agente se bloquee o que genere errores.

 

  Soluci�n del problema: aumente el tiempo de espera del protocolo de bloqueo del agente mediante la siguiente propiedad:

imq.cluster.timeout=<tiempo_espera_en_segundos>

El valor predeterminado es 60. Si los mensajes persistentes extensos son lentos, puede que deba ajustar la base de datos del almac�n persistente o cambiar a otro almac�n distinto.

5006686

El ejemplo ARGS de imqbrokerd.conf no es correcto.

  Soluci�n del problema: los valores no se deben utilizar tal y como aparecen en el ejemplo:

ARGS=”-name newbroker -port 8888”

Los valores deben ser:

ARGS=-name newbroker -port 8888

Archivos que se pueden distribuir

Sun Java System Message Queue 3.5 SP1 contiene el siguiente grupo de archivos que usted puede distribuir en formato binario:

jms.jar
imq.jar
imqxm.jar
fscontext.jar
providerutil.jar
jndi.jar
ldap.jar
ldapbpjar
jaas.jar
jsse.jar
jnet.jar
jcert.jar

Adem�s, tambi�n puede distribuir los archivos de LICENCIA y COPYRIGHT.

Informaci�n sobre problemas y respuestas de los clientes

Para informar de un problema, env�e un mensaje de correo electr�nico a imq-feedback@sun.com.

Si dispone de un contrato de asistencia t�cnica y tiene problemas con Message Queue, p�ngase en contacto con el servicio de asistencia al cliente utilizando uno de los siguientes sistemas:

Para que podamos ayudarle de forma �ptima en la resoluci�n de problemas, tenga a mano la siguiente informaci�n cuando se ponga en contacto con el servicio de asistencia:

Sun valora sus comentarios

Sun tiene inter�s en mejorar su documentaci�n y valora sus comentarios y sugerencias. Para enviar sus comentarios a Sun, use el formulario basado en Web que aparece en:

Ind�quenos el t�tulo completo de la documentaci�n y el n�mero de pieza en los campos pertinentes. Puede hallar el n�mero de pieza en la p�gina del t�tulo del libro o en la parte superior del documento. Normalmente, es un n�mero que consta de siete o nueve d�gitos. Por ejemplo, el n�mero de pieza de este documento, Message Queue 3.5 SP1 Notas de la versi�n, es 817-7199-10.

Recursos adicionales de Sun

Adem�s de la documentaci�n de Message Queue, puede encontrar informaci�n adicional tal y como se indica a continuaci�n.

Foros de discusi�n

Sun Java System Foros sobre software

Puede encontrar un foro de Sun Java System Message Queue en la siguiente direcci�n:

Le agradecemos su participaci�n.

Foro de tecnolog�a de Java

Existe un foro de JMS en los foros de tecnolog�a de Java que puede interesarle.

Base de datos de soluciones de SunSolve

Hay disponible informaci�n en l�nea acerca de Sun Java System Message Queue en la base de datos de soluciones de SunSolve, que est� ubicada en:

Seleccione el enlace que le permite acceder a la documentaci�n gratuita: se trata de “All Free Collections”. Despu�s debe buscar “Message Queue”.

Sun Java System Informaci�n

Puede encontrar informaci�n �til de Sun Java System en las siguientes direcciones de Internet:

Copyright � 2004 Sun Microsystems, Inc. Todos los derechos reservados.

Derechos del gobierno de Estados Unidos: Software comercial. Los usuarios gubernamentales est�n sujetos al acuerdo de licencia est�ndar de Sun Microsystems, Inc. y a las disposiciones aplicables de la regulaci�n FAR y sus suplementos. El uso est� sujeto a las condiciones de la licencia. Esta distribuci�n puede incluir materiales desarrollados por terceras partes.

Sun, Sun Microsystems, el logotipo de Sun, Java, Solaris y Sun[tm] ONE son marcas comerciales o marcas comerciales registradas de Sun Microsystems, Inc. en Estados Unidos y otros pa�ses.

Todas las marcas comerciales de SPARC se utilizan bajo licencia y son marcas comerciales o marcas registradas de SPARC International, Inc. en EE.UU. y en otros pa�ses.

UNIX es una marca comercial registrada en EE.UU. y en otros pa�ses, cuya licencia se otorga exclusivamente a trav�s de X/Open Company, Ltd.