test

Notas de la version de Sun Java System Message Queue 4.2

Actualizaciones de documentación de Información de resolución de problemas de 4.2

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

Problemas de compatibilidad

En esta sección se tratan los problemas de compatibilidad de Información de resolución de problemas de 4.2.

Estabilidad de interfaz

Sun Java System Información de resolución de problemas de utiliza muchas interfaces que pueden cambiar con el tiempo. El Apéndice B, Stability of Message Queue Interfaces de Sun Java System Message Queue 4.2 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 Información de resolución de problemas de

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

Cambios en el conjunto de documentación de Información de resolución de problemas de 4.2

El conjunto de documentación de Información de resolución de problemas de 4.2 incluye actualizaciones al conjunto de documentación de Message Queue 4.1 tal y como se describe a continuación:

Descripción general técnica

La Sun Java System Message Queue 4.2 Installation Guide se ha actualizado para reflejar nuevas funciones de Message Queue 4.2 y una estructura actualizada para obtener clústeres de agente de alta disponibilidad.

Guía de administración

La Guía de administración se ha actualizado para reflejar nuevas funciones de Información de resolución de problemas de 4.2.

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

La Sun Java System Message Queue 4.2 Installation Guide no se ha actualizado para reflejar nuevas funciones de Información de resolución de problemas de 4.2, específicamente la nueva funcionalidad de registro de Sun Connect del instalador. Esta información se incluye en estas Notas de la versión de Message Queue

Guía del desarrollador para clientes Java

La Guía del desarrollador para clientes Java no se ha actualizado para reflejar nuevas funciones de Información de resolución de problemas de 4.2. Esta información se incluye en estas Notas de la versión de Message Queue

Guía del desarrollador para clientes C

La Guía del desarrollador para clientes C no se ha actualizado para reflejar nuevas funciones de Información de resolución de problemas de 4.2. Esta información se incluye en estas Notas de la versión de Message Queue

La Guía del desarrollador para el cliente JMX

no se ha actualizado para reflejar nuevas funciones de Información de resolución de problemas de 4.2. Esta información se incluye en estas Notas de la versión de Message Queue

Nuevo método de medición de destino

Información de resolución de problemas de 4.2 incluye nuevos métodos de medición de destino que pueden resultar útiles a la hora de controlar destinos en un clúster de agente. En un clúster de agente, los destinos se propagan a todos los agentes del clúster. Sin embargo, un mensaje, cuando se produce, se guarda en el destino del agente de inicio del productor del mensaje, y se envía al destino correspondiente en otro agente del clúster sólo si existe un consumidor activo para dicho destino. Como resultado, los mensajes guardados en un destino específico dependen del agente del clúster en el que reside el destino.

Dicho de otra manera, en un clúster de agente, los mensajes guardados en un destino dado en un determinado agente del clúster, constan de mensajes producidos directamente en el destino y mensajes enviados al destino desde los agentes remotos del clúster. Al analizar el enrutamiento y la entrega de mensajes en un clúster de agente, a veces resulta útil saber cuántos mensajes de un destino son locales (se han producido localmente) y cuántos son remotos (se han producido de forma remota).

La siguiente tabla muestra dos nuevas cantidades de medición de destino físico que se incluyen en Información de resolución de problemas de 4.2. Las nuevas cantidades de medición están disponibles a través de los comandos imqcmd list dst y imqcmd query dst y a través de los atributos JMX (consulte MBean de control de destinos.

Tabla 1–10 Método de medición de destinos físicos

Cantidad de medición 

Descripción 

¿Archivo de registro? 

Tipo de medición metrics dst

Tema de medición 

Número de mensajes remotos 

Número actual de mensajes guardados en la memoria y en el almacén persistente que se produjeron para un agente remoto en un clúster. Este número no incluye los mensajes incluidos en las transacciones. 

No 

No disponible [Disponible con el comando imqcmd query dst]

No disponible 

Bytes totales de los mensajes remotos 

Tamaño total actual en bytes de los mensajes guardados en la memoria y en el almacén persistente que se produjeron para un agente remoto en un clúster. Este valor no incluye los mensajes incluidos en las transacciones. 

No 

No disponible

No disponible 

Inicio automático del agente en SO Solaris 10

Esta sección describe cómo configurar el inicio automático del agente en los sistemas operativos Solaris 10. En lugar de utilizar un archivo rc para implementar el inicio automático del agente cuando se reinicia un equipo, el siguiente procedimiento hace uso de la facilidad de gestión de servicios (SMF) de Solaris 10.

Para obtener más información sobre cómo utilizar la facilidad de gestión de servicios, consulte la documentación de Solaris 10.

ProcedurePara implementar el inicio automático del agente en el SO Solaris 10

  1. Importe el servicio mqbroker en el almacén de SMF.

    # svccfg import /var/svc/manifest/application/sun/mq/mqbroker.xml

  2. Compruebe que la importación se ha realizado correctamente comprobando el estado del servicio mqbroker.

    # svcs mqbroker

    La salida de datos tiene un aspecto similar al siguiente.


    STATE STIME FMRI
disabled 16:22:50 svc:/application/sun/mq/mqbroker:default

    Inicialmente, el servicio se muestra como desactivado.

  3. Active el servicio mqbroker.

    # svcadm enable svc:/application/sun/mq/mqbroker:default

    Al activar el servicio mqbroker se iniciará el proceso imqbrokerd. A continuación, se reiniciará el agente.

  4. Configure el servicio mqbroker para pasar los argumentos que desee al comando imqbrokerd.

    La propiedad options/server_args se utiliza para pasar argumentos aimqbrokerd. Por ejemplo, para añadir -loglevel DEBUGHIGH, siga los siguientes pasos:


    # svccfg
svc:> select svc:/application/sun/mq/mqbroker
svc:/application/sun/mq/mqbroker> setprop options/server_args=\"-loglevel DEBUGHIGH\"
svc:/application/sun/mq/mqbroker> exit

Cambios en la API JMX

Información de resolución de problemas de es compatible con la API Java Management Extensions (JMX) para configurar y controlar las funciones del agente mediante el programa desde una aplicación de cliente Información de resolución de problemas de. Información de resolución de problemas de 4.2 incluye extensiones de la API JMX para dar soporte a las nuevas funciones y funcionalidades de la versión. Los nuevos atributos JMX, operaciones y/o claves de búsqueda se definen para los siguientes Mbeans:

MBean de control de consumidor/administrador

Los atributos, operaciones y claves de búsqueda de las siguientes tablas son compatibles con la función descrita en Varios destinos para un editor o suscriptor.

El nombre de los siguientes atributos se define como constantes estáticas en la clase de utilidad com.sun.messaging.jms.management.server.ConsumerAttributes .

Tabla 1–11 Atributos de control de consumidor/administrador

Nombre 

Tipo 

¿Se puede configurar? 

Descripción 

NumWildcardConsumers

Integer

No 

Número de consumidores de mensajes comodín relacionados con el agente 

Los nombres de las siguientes operaciones se definen como constantes estáticas en la clase de utilidad com.sun.messaging.jms.management.server.ConsumerOperations .

Tabla 1–12 Operaciones de control de consumidor/administrador

Nombre 

Parámetros 

Tipo de resultado 

Descripción 

getConsumerWildcards

none 

String[]

Cadenas comodín utilizadas por los consumidores actuales relacionadas con el agente 

getNumWildcardConsumers

Cadena comodín 

Integer

Número de consumidores actuales relacionados con el agente que están utilizando la cadena comodín especificada 

Las siguientes claves de búsqueda se definen como constantes estáticas en la clase de utilidad com.sun.messaging.jms.management.server.ConsumerInfo.

Tabla 1–13 Claves de búsqueda para la información del consumidor de mensajes

Nombre 

Tipo de valor 

Descripción 

DestinationNames

String[]

Nombres de destinos que coinciden con comodines utilizados por los consumidores de comodines 

Sólo para destinos de temas. 

Wildcard

Boolean

¿Consumidor de comodines? 

Sólo para destinos de temas. 

MBean de configuración de destinos

Los atributos de la siguiente tabla son compatibles con la función que de describe en Validación de esquemas de mensajes de datos útiles XML.

Los nombres de los siguientes atributos se definen como comandos estáticos en la clase de utilidad com.sun.messaging.jms.management.server.DestinationAttributes .

Tabla 1–14 Atributos de configuración de destinos

Nombre 

Tipo 

¿Se puede configurar? 

Descripción 

ValidateXMLSchemaEnabled

Boolean

Sí 

¿Se ha activado la validación de esquemas XML? 

Si está configurada en false o no está configurada, la validación de esquemas XML no se activará para el destino.

XMLSchemaURIList

String

Sí 

Lista separada por espacios de cadenas URI de documentos de esquemas XML (XSD)  

Los URI señalan la ubicación de uno o más XSD que se van a utilizar para realizar la validación de esquemas XML, si está activada.  

Utilice comillas dobles en este valor si se especifican varios URI. 

Ejemplo: 

“http://foo/flap.xsd http://test.com/test.xsd”

Si esta propiedad no está configurada o es nula y se ha activado la validación XML, la validación XML se realizará mediante un DTD especificado en el documento XML. 

ReloadXMLSchemaOnFailure

Boolean

Sí 

¿Se ha activado la recarga del esquema XML en caso de error? 

Si está configurado en falso o no está configurada, el esquema no se recargará si la validación no se realiza correctamente. 

MBean de configuración del administrador de destinos

Los nuevos atributos del MBean de configuración de destinos, que se mencionan anteriormente y que son compatibles con la nueva función, Validación de esquemas de mensajes de datos útiles XML, se pueden utilizar para crear un destino mediante la operación create del MBean de configuración del administrador de destinos.

MBean de control de destinos

El primer conjunto de atributos de la siguiente tabla es compatible con la función que se describe en Varios destinos para un editor o suscriptor y el segundo conjunto de atributos es compatible con la mejora que se describe en Nuevo método de medición de destino.

Los nombres de los siguientes atributos se definen como comandos estáticos en la clase de utilidad com.sun.messaging.jms.management.server.DestinationAttributes .

Tabla 1–15 Atributos de control de destinos

Nombre 

Tipo 

¿Se puede configurar? 

Descripción 

NumWildcards

Integer

No 

Número actual de productores de mensajes comodín y consumidores de mensajes comodín relacionados con el destino 

Sólo para destinos de temas. 

NumWildcardProducers

Integer

No 

Número actual de productores de mensajes comodín relacionados con el destino  

Sólo para destinos de temas. 

NumWildcardConsumers

Integer

No 

Número actual de consumidores de mensajes comodín relacionados con el destino  

Sólo para destinos de temas. 

NumMsgsRemote

Long

No 

Número actual de mensajes guardados en la memoria y en el almacén persistente que se produjeron para un agente remoto en un clúster. Este número no incluye los mensajes incluidos en las transacciones. 

TotalMsgBytesRemote

Long

No 

Tamaño total en bytes de los mensajes guardados en la memoria y en el almacén persistente que se produjeron para un agente remoto en un clúster. Este valor no incluye los mensajes incluidos en las transacciones. 

Las operaciones de la siguiente tabla son compatibles con la función descrita en Varios destinos para un editor o suscriptor.

Los nombres de las siguientes operaciones se definen como constantes estáticas en la clase de utilidad com.sun.messaging.jms.management.server.DestinationOperations .

Tabla 1–16 Operaciones de control de destinos

Nombre 

Parámetros 

Tipo de resultado 

Descripción 

getWildcards

none 

String[]

Cadenas comodín utilizadas por los consumidores y productores actuales relacionados con el destino 

Sólo para destinos de temas. 

getConsumerWildcards

none 

String[]

Cadenas comodín utilizadas por los consumidores actuales relacionados con el destino 

Sólo para destinos de temas. 

getProducerWildcards

none 

String[]

Cadenas comodín utilizadas por los productores actuales relacionados con el destino 

Sólo para destinos de temas. 

getNumWildcardConsumers

Cadena comodín 

Integer

Número de consumidores actuales relacionados con el destino que están utilizando la cadena comodín especificada 

Sólo para destinos de temas. 

getNumWildcardProducers

Cadena comodín 

Integer

Número de productores actuales relacionados con el destino que están utilizando la cadena comodín especificada 

Sólo para destinos de temas. 

MBean de control de productor/administrador

Los atributos, operaciones y claves de búsqueda de las siguientes tablas son compatibles con la función descrita en Varios destinos para un editor o suscriptor.

El nombre de los siguientes atributos se define como constantes estáticas en la clase de utilidad com.sun.messaging.jms.management.server.ProducerAttributes .

Tabla 1–17 Atributos de control de productor/administrador

Nombre 

Tipo 

¿Se puede configurar? 

Descripción 

NumWildcardProducers

Integer

No 

Número de productores de mensajes comodín relacionados con el agente 

Los nombres de las siguientes operaciones se definen como constantes estáticas en la clase de utilidad com.sun.messaging.jms.management.server.ProducerOperations .

Tabla 1–18 Operaciones de control de productor/administrador

Nombre 

Parámetros 

Tipo de resultado 

Descripción 

getProducerWildcards

none 

String[]

Cadenas comodín utilizadas por los productores actuales relacionadas con el agente 

getNumWildcardProducers

Cadena comodín 

Integer

Número de productores actuales relacionados con el agente que están utilizando la cadena comodín especificada 

Las siguientes claves de búsqueda se definen como constantes estáticas en la clase de utilidad com.sun.messaging.jms.management.server.ProducerInfo.

Tabla 1–19 Claves de búsqueda para la información del productor de mensajes

Nombre 

Tipo de valor 

Descripción 

DestinationNames

String[]

Nombres de destinos que coinciden con comodines utilizados por los productores de comodines 

Sólo para destinos de temas. 

Wildcard

Boolean

¿Productor de comodines? 

Sólo para destinos de temas. 

Compatibilidad con formato de nombre de usuario DN para la autenticación del cliente

Información de resolución de problemas de 4.2 es compatible con el formato de nombre de usuario DN en la autenticación de conexión del cliente contra un almacén de usuario LDAP. La compatibilidad incluye la siguiente nueva propiedad de agente (y el valor):

imq.user_repository.ldap.usrformat=dn

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

imq.user_repository.ldap.uidattr

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

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

Mejora de la autenticación JAAS

La autenticación JAAS de Información de resolución de problemas de 4.2 es compatible con la autenticación mediante dirección IP, así como mediante nombre de usuario.