Nuevas funciones de Información de resolución de problemas de 4.0

Información de resolución de problemas de 4.0 fue una versión menor que se limitaba a ser compatible con Application Server 9 PE. Incluía algunas nuevas funciones, algunas mejoras relacionadas con las funciones y soluciones a fallos. Esta sección incluye una descripción de las nuevas funciones de esta versión:

• Compatibilidad con el API de administración JMX

• Registro del tiempo de ejecución del cliente

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

• Mejoras en la administración del agente

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

• Compatibilidad con el proveedor de JDBC

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

• Propiedades de mensajes adicionales

• Compatibilidad con SSL

Uno de los cambios más insignificantes que incorporaba la versión 4.0, pero que puede provocar interrupciones, era la desaprobación de la opción command-line 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 desaprobada, o introducirlas cuando se le soliciten.

Compatibilidad con el API de administración JMX

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

Para obtener más información consulte la Sun Java System Message Queue 4.2 Developer’s Guide for JMX Clients.

Registro del tiempo de ejecución del cliente

Información de resolución de problemas de 4.0 incluyó la 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 en relación al registro del tiempo de ejecución del cliente y a cómo configurarlo, consulte la pág. 137 de la Guía de Java Dev.

API de notificación de sucesos de conexión

Información de resolución de problemas de 4.0 incluyó una API de notificación de sucesos que permite que el tiempo de ejecución de cliente informe a una aplicación sobre los cambios en el estado de 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 proceder 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ág. 96 de la Guía de Java Dev.

Mejoras en la administración del agente

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

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

  imqcmd quiesce bkr -b Wolfgang:1756

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

  imqcmd shutdown bkr -b Hastings:1066 -time 90

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

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

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

  • Seguirá aceptando las conexiones jms administrativas.

  • No aceptará nuevas conexiones jms.

  • Las conexiones jms existentes continuarán funcionando.

  • El agente no podrá sustituir a ningún otro agente de un clúster de agente de alta disponibilidad.

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

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

  imqcmd destroy cxn -n 2691475382197166336

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

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

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

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

Información sobre el almacén de datos basado en JDBC

En Información de resolución de problemas de 4.0 se añadió un nuevo subcomando query a la utilidad Administrador de bases de datos, 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] Utilizando el almacén persistente conectado:
        versión=400
        Iddebroker=Mozart1756
        url de la conexión de la base de datos=jdbc:oracle:thin:@Xhome:1521:mqdb
        usuario de la base de datos=scott
Ejecutándose en modo individual.
Ya se han creado las tablas de la base de datos.

Compatibilidad con el proveedor de JDBC

En Información de resolución de problemas de 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.

Información de resolución de problemas de 4.0 introdujo cambios en el almacén de datos basado en JDBC para obtener optimización y para dar soporte a futuras mejoras. Por esta razón el formato del almacén de datos basado en JDBC aumentó 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 permanece en 370 dado que no se han realizado cambios. .

Propiedades de mensajes adicionales

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

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

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

Compatibilidad con SSL

Desde la versión Información de resolución de problemas de 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 a 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 verdadera (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