Sun Java System Message Queue 3 2005Q4 Notas de la versi�n |
Sun Java System Message Queue Notas de la versi�n
Versi�n 3 2005Q4 (3.6 SP3)
N�mero de referencia 819-3559
Estas notas de la versi�n contienen informaci�n importante disponible en el momento de la publicaci�n de Sun Java System Message Queue 3 2005Q4 (3.6 SP3). Asimismo, este documento incluye el contenido de las notas de la versi�n de Sun Java System Message Queue 3 2005Q1 (3.6) para los clientes que actualicen desde versiones anteriores a Message Queue 3 2005Q1. Aqu� se tratan nuevas funciones y mejoras, limitaciones y problemas conocidos e informaci�n de otro tipo. Lea este documento antes de empezar a utilizar Message Queue.
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 Message Queue: http://docs.sun.com/coll/1307.1. 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 las siguientes secciones:
Se hace referencia a las direcciones URL de terceras partes para proporcionar informaci�n adicional relacionada.
Historial de revisiones de las notas de la versi�n
Tabla 1 Historial de revisiones
Fecha
Descripci�n de los cambios
26 de agosto, 2005
- Actualizaci�n de Acerca de Message Queue 3 2005Q4 (3.6 SP3).
- Actualizaci�n de Requisitos de hardware y software para Message Queue 2005Q4 (3.6 SP3).
- Adici�n de errores solucionados en Message Queue 3 2005Q4 (3.6 SP3) a Errores solucionados en esta versi�n.
28 de junio, 2005
- Adici�n de errores solucionados en Message Queue 3 2005Q1 (3.6 SP1) y Message Queue 32005Q4 (3.6 SP2) a Errores solucionados en esta versi�n.
1 de mayo, 2005
- Actualizaci�n del apartado Problemas relacionados con la siguiente versi�n principal de Message Queue con nueva informaci�n.
- Se agrega una declaraci�n de Estabilidad de interfaz al apartado Compatibilidad.
24 de enero, 2005
Actualizaci�n en relaci�n con el lanzamiento de las versiones comerciales de Sun Java System Message Queue 3 2005Q1 y Java Enterprise System 2005Q1.
8 de noviembre, 2004
Versi�n inicial de Sun Java System Notas de la versi�n de Message Queue.
Acerca de Message Queue 3 2005Q4 (3.6 SP3)Message Queue 3 2005Q4 (3.6 SP3) es una actualizaci�n que soluciona errores de Message Queue 3 2005Q1 (3.6). Contiene todas las soluciones ya incluidas en las versiones 3.6 SP2 y 3.6 SP1, adem�s de nuevas actualizaciones de la documentaci�n.
Message Queue 3 2005Q1 (3.6)
Sun Java System Message Queue es un completo servicio de mensajer�a con caracter�sticas fiables y as�ncronas que se ajustan a las especificaciones de la versi�n 1.1 de Java Messaging Specification (JMS). Adem�s, Message Queue ofrece una amplia variedad de funciones adicionales no incluidas en la especificaci�n JMS para satisfacer las necesidades de las implementaciones empresariales a gran escala.
Esta secci�n incluye:
Novedades de esta versi�n
Entre las nuevas funciones de Message Queue 3 2005Q1 (3.6), se incluyen:
�stas se describen en los siguientes subapartados.
Mensajes inactivos de Message Queue
Message Queue crea autom�ticamente un destino especializado durante el inicio de agente que permite almacenar mensajes inactivos para tareas de diagn�stico. Un mensaje inactivo es el que se elimina del sistema por motivos distintos a una acci�n normal de procesamiento o expl�cita del administrador. Un mensaje se considera inactivo cuando ha caducado, cuando se elimina de un destino al desbordarse el l�mite de memoria o cuando se producen intentos de entrega fallidos.
Un administrador puede configurar destinos para descartar mensajes inactivos o enviarlos a la cola de mensajes inactivos. En este �ltimo caso, se agrega al mensaje informaci�n de propiedad adicional para indicar al administrador la causa de su inactividad. Asimismo, al crear un mensaje, un desarrollador de cliente puede tambi�n establecer un valor de propiedad que determine si �ste debe colocarse en la cola de mensajes al convertirse en inactivo.
Para obtener m�s informaci�n, consulte la Message Queue Administration Guide.
No Acknowledge Mode (Modo sin acuse de recibo)
El modo de acuse de recibo NO_ACKNOWLEDGE es una extensi�n de la API JMS. El agente suele esperar un acuse de recibo del cliente. Cuando el cliente ha especificado CLIENT_ACKNOWLEDGE, dicho acuse de recibo debe realizarse mediante programaci�n o, si ha especificado AUTO_ACKNOWLEDGE o DUPS_OK, autom�ticamente en la sesi�n. Si un cliente consumidor especifica el modo NO_ACKNOWLEDGE, el agente descarta el mensaje en cuanto se env�a al cliente consumidor. Aunque esta funci�n est� destinada especialmente a suscriptores no duraderos que consumen mensajes no persistentes, puede tambi�n utilizarla cualquier consumidor.
Esta funci�n permite mejorar el rendimiento, ya que reduce el tr�fico de protocolos y las tareas de agente implicadas en el acuse de recibo de un mensaje. Asimismo, mejora el rendimiento de los agentes que se ocupan de los clientes con un comportamiento inadecuado que no confirman la recepci�n de mensajes y acaparan innecesariamente recursos de memoria del agente. Este modo no afecta a los productores.
El modo NO_ACKNOWLEDGE no es compatible en los clientes C. Para obtener m�s informaci�n, consulte la Message Queue Developer’s Guide for Java Clients.
Compresi�n del cuerpo del mensaje del cliente
El desarrollador puede especificar que se comprima el cuerpo de un mensaje. De la compresi�n y descompresi�n del mensaje se ocupa el tiempo de ejecuci�n del cliente, por lo que no afecta al agente. Por tanto, las aplicaciones pueden utilizar esta funci�n con una versi�n anterior del agente, pero deben utilizar la versi�n 3 2005Q1 (3.6) de la biblioteca de tiempo de ejecuci�n de cliente de Message Queue.
Ventajas y limitaciones de la compresi�n Aunque la compresi�n de mensajes se ha agregado para mejorar el rendimiento, esta ventaja no est� garantizada. Los beneficios dependen del tama�o y formato de los mensajes, el n�mero de consumidores, el ancho de banda de la red y el rendimiento de la CPU. Por ejemplo, el coste de la compresi�n y descompresi�n puede superar el tiempo que se ahorra en enviar y recibir un mensaje comprimido. �ste es el caso especialmente si se env�an mensajes peque�os en una red de alta velocidad. Sin embargo, las aplicaciones que publican mensajes grandes a muchos clientes o que lo hacen en un entorno de red lento, pueden mejorar el rendimiento del sistema mediante la compresi�n de mensajes.
Los consumidores de mensajes implementados con las bibliotecas de tiempo de ejecuci�n de cliente anteriores a la versi�n 3 2005Q1 (3.6) no pueden procesar mensajes comprimidos. Los clientes configurados para enviar mensajes comprimidos deben asegurarse de que los consumidores sean compatibles. Actualmente, los clientes C no pueden consumir mensajes comprimidos.
Para obtener m�s informaci�n, consulte la Message Queue Developer’s Guide for Java Clients.
Detecci�n de errores de conexi�n (ping de tiempo de ejecuci�n de cliente)
Message Queue 3 2005Q1 incorpora un nuevo atributo ConnectionFactory llamado imqPingInterval. El atributo imqPingInterval especifica la frecuencia de una operaci�n de ping desde el tiempo de ejecuci�n de cliente al agente. Mediante una comprobaci�n peri�dica de la conexi�n, el tiempo de ejecuci�n de cliente puede detectar de forma preventiva un error de conexi�n. Si la operaci�n de ping no se realiza correctamente, el tiempo de ejecuci�n de cliente muestra una excepci�n en el objeto de escucha de excepciones de la aplicaci�n cliente. Si la aplicaci�n no dispone de una escucha de excepciones, cuando la aplicaci�n intente de nuevo utilizar la conexi�n se producir� un error.
Para obtener m�s informaci�n, consulte la Message Queue Administration Guide.
Administraci�n de certificados: Herramientas NSS de C-API
C-API utiliza bibliotecas NSS (Servicios de seguridad de redes, Network Security Services) para la compatibilidad con SSL. Estas bibliotecas proporcionan API y utilidades para el desarrollo de aplicaciones seguras. Entre dichas utilidades se incluyen herramientas para la administraci�n de claves y bases de datos de certificados. En Message Queue 3.5, recomend�bamos a los desarrolladores que utilizaran Mozilla para administrar claves y certificados NSS. En Message Queue 3 2005Q1, los administradores pueden utilizar la herramienta NSS certutil para generar las claves y los certificados necesarios.
Para obtener m�s informaci�n, consulte la Message Queue Developer’s Guide for C Clients.
Compatibilidad con la autenticaci�n b�sica de C-API
Message Queue La C-API de 3 2005Q1 admite el tipo de autenticaci�n basic. Versiones anteriores de Message Queue no admit�an el tipo de autenticaci�n basic.
Compatibilidad con C-API de 64 bits
Ahora, Message Queue es compatible con C-API de 64 bits en plataformas Solaris/SPARC. Para obtener m�s informaci�n acerca de c�mo habilitar la compatibilidad con C-API de 64 bits, consulte la Message Queue Developer’s Guide for C Clients.
Requisitos de hardware y software
Este apartado especifica o describe el hardware y software necesario para esta versi�n de Message Queue. La Tabla 2 muestra los requisitos de hardware y software para sistemas operativos Solaris SPARC.
La Tabla 3 muestra los requisitos de hardware y software para sistemas operativos Solaris x86.
La Tabla 4 muestra los requisitos de hardware y software para sistemas operativos Linux.
Message Queue 3 2005Q1 utiliza tambi�n otras tecnolog�as, tal como se indica en la Tabla 5. Asimismo, pueden utilizarse versiones distintas o implementaciones de otros proveedores, pero Sun Microsystems no las ha probado y, por tanto, no garantiza su compatibilidad.
La Tabla 5 muestra y describe los componentes b�sicos que deben instalarse para poder desarrollar y ejecutar clientes de Message Queue.
La Tabla 6 muestra y describe los componentes que pueden instalarse para obtener compatibilidad adicional para un cliente de Message Queue. Puede que s�lo necesite algunos de los componentes de la lista. Por ejemplo, si no escribe un cliente C para Message Queue, no tendr� que instalar ninguno de los componentes necesarios para la compatibilidad con clientes C.
Errores solucionados en esta versi�nLa Tabla 7 describe los errores solucionados en Message Queue 3 2005Q1 (3.6):
La Tabla 8 describe los errores solucionados en Message Queue 3 2005Q1 (3.6 SP1):
La Tabla 9 describe los errores solucionados en Message Queue 3 2005Q4 (3.6 SP2):
La Tabla 10 describe los errores solucionados en Message Queue 3 2005Q4 (3.6 SP3):
Informaci�n importanteEste apartado contiene la informaci�n m�s reciente no incluida en la documentaci�n principal del producto. En este apartado se describen los temas siguientes:
Notas de la instalaci�n
Consulte la Message Queue Installation Guide para obtener informaci�n acerca de instrucciones previas a la instalaci�n, procedimientos de actualizaci�n y cualquier otra informaci�n relevante para instalar Message Queue, Platform Edition en plataformas Solaris, Linux y Windows.
Consulte la Gu�a de instalaci�n de Sun Java Enterprise System para obtener informaci�n acerca de instrucciones previas a la instalaci�n y cualquier otra informaci�n relevante para instalar Message Queue, Enterprise Edition en plataformas Solaris y Linux.
Consulte la Gu�a de actualizaci�n y migraci�n de Sun Java Enterprise System para obtener informaci�n acerca de instrucciones de actualizaci�n y migraci�n relevantes para actualizar a Message Queue 3 2005Q1 (3.6) en plataformas Solaris y Linux.
Instalaci�n de paquetes Solaris que faltan (Message Queue 3 2005Q1 Enterprise Edition, s�lo distribuci�n (subconjunto de distribuci�n) con programa de instalaci�n de Java Enterprise System)
La distribuci�n de Message Queue 3 2005Q1 Enterprise Edition para Solaris no incluye los paquetes SUNWtlsu (Network Security Services Utilities) y SUNWtlsux (s�lo SPARC de 64 bits para Network Security Services Utilities).
Estos paquetes s�lo son necesarios para compatibilidad con clientes C SSL. En su sistema puede estar ya instalada una versi�n anterior de estos paquetes, pero debe actualizarlos a la versi�n incluida en Java Enterprise System 2005Q1.
Soluci�n del problema
En el sitio Web de Sun Java System, puede obtener la versi�n de SUNWtlsu y SUNWtlsux que acompa�a a Java Enterprise System 2005Q1 de los paquetes de Message Queue 3 2005Q1 Platform Edition. Despu�s de descargar los archivos de Message Queue, siga las instrucciones de la secci�n “Installing Message Queue” del Cap�tulo 2, “Solaris Installation”, de la Message Queue Installation Guide. En el paso 8, responda n (no) y contin�e con el paso 9 para instalar s�lo los paquetes SUNWtlsu y SUNWtlsux en su sistema.Problemas de compatibilidad
Esta secci�n aborda los problemas de compatibilidad de Message Queue 3 2005Q1 (3.6).
Problemas de Message Queue 3 2005Q1 (3.6)
Los apartados siguientes describen problemas que afectan a: todas las plataformas, plataformas Solaris y Linux, y s�lo plataformas Linux.
Todas las plataformas
Estabilidad de interfaz Sun Java System Message Queue utiliza distintas interfaces que pueden ayudar a los administradores a automatizar tareas. El Ap�ndice B de la Message Queue Administration Guide clasifica las interfaces seg�n su estabilidad. Cuanto m�s estable sea una interfaz, menores ser�n los posibles cambios en versiones posteriores del producto.
Opciones de contrase�a obsoletas Por motivos de seguridad, se han dejado de utilizar las siguientes opciones:
Cuando en un comando se especifica una contrase�a del tipo:
imqcmd query bkr -u admin -p adminpassword
un usuario puede ver la contrase�a del administrador al mostrar o consultar los procesos de un equipo (por ejemplo, mientras se utiliza ps en Solaris).
Utilice en su lugar la opci�n -passfile. La opci�n passfile se explica en el cap�tulo acerca de la seguridad de la Message Queue Administration Guide.
Plataformas Solaris y Linux
Compatibilidad con clientes JDK 1.3 Los siguientes paquetes contienen archivos jar utilizados para admitir JNDI y JSSE en tareas de desarrollo e implementaci�n de clientes en JDK 1.3. Estos paquetes se incluyen s�lo en Message Queue, Platform Edition, pero no se proporcionar�n en versiones posteriores. Estos paquetes no se instalan de forma predeterminada:
Para obtener m�s informaci�n acerca de la instalaci�n de paquetes de forma independiente, consulte la Message Queue Installation Guide.
Plataformas Linux
Este apartado describe los cambios que afectan a los paquetes y a las ubicaciones de instalaci�n en una plataforma Linux.
Nuevas ubicaciones de instalaci�n en Linux La ubicaci�n de los directorios de instalaci�n de Message Queue en Linux ha cambiado.
Nota
No se han realizado cambios en la ubicaci�n de los directorios de instalaci�n entre Message Queue 3 2005Q1 (3.6) y Message Queue 3 2005Q4 (3.6 SP3).
La Tabla 11 muestra los directorios de instalaci�n predeterminados de RPM de Message Queue en Linux
Para obtener m�s informaci�n, consulte el Ap�ndice A, “Operating System-Specific Locations of Message Queue Data”, en la Message Queue Administration Guide.
Nombres de paquetes RPM de Linux modificados Los nombres de los archivos de paquetes RPM de Message Queue para Linux han cambiado.
Nota
No se han realizado cambios en los nombres de los paquetes RPM de Message Queue para Linux entre las versiones Message Queue 3 2005Q1 y Message Queue 3 2005Q4.
La Tabla 12 muestra los nuevos nombres de los paquetes RPM de Message Queue 3 2005Q1 para Linux.
Tabla 12 Paquetes RPM de sistemas Linux
RPM
Descripci�n
Notas
sun-mq-config
Archivos /etc
sun-mq-var
Archivos /var
sun-mq
Archivos /opt
Depende de sun-javahelp, sun-mq-jmsclient, sun-mq-config y sun-mq-var.
sun-mq-ent
Archivo de licencia de Enterprise Edition.
Este RPM s�lo se incluye en Message Queue, Enterprise Edition, disponible con Java Enterprise System.
sun-mq-jaxm
JAXM (Java API for XML Messaging) de Message Queue: API
Depende de sun-saaj.
sun-mq-jmsclient
JMS: API y tiempo de ejecuci�n
Sin dependencias
sun-mq-xmlclient
Cliente XML
Depende de sun-jmsclient y sun-saaj.
sun-mq-capi
C-API
Depende de sun-nspr y sun-nss.
sun-mq-compat
Symlinks a ubicaciones 3.5.
Depende de sun-mq.
Este RPM no se instala de forma predeterminada.
Nota: este paquete s�lo es necesario si los clientes disponibles dependen de ubicaciones de archivo de Message Queue 3.5.
sun-mq-sup
Necesario para compatibilidad con JDK 1.3.
Depende de sun-mq.
Este RPM no se instala de forma predeterminada.
Nota: este paquete se incluye s�lo en Message Queue, Platform Edition.
sun-mq-[locale]
Archivos L10N
sun-javahelp1
JavaHelp: API y tiempo de ejecuci�n
Compatible con el visor de JavaHelp para la ayuda de la consola de administraci�n
sun-nss1
Bibliotecas Network Security Services (NSS).
Necesarias para compatibilidad con clientes en lenguaje C.
sun-nspr1
Bibliotecas Netscape Portable Runtime (NSPR)
Necesarias para compatibilidad con clientes C.
sun-saaj1
SAAJ (SOAP with Attachments API for Java): API y tiempo de ejecuci�n
Necesario para compatibilidad con clientes Java que utilizan API SOAP/JAXM.
sun-jaxp1
Message QueueJAXP (Java API for XML Processing): API y tiempo de ejecuci�n
Necesario para compatibilidad con clientes Java que utilizan API SOAP/JAXM.
sun-javamail1
JavaMail: API y tiempo de ejecuci�n
Necesario para compatibilidad con clientes Java que utilizan API SOAP/JAXM.
sun-jaf1
JavaBeans Activation Framework: API y tiempo de ejecuci�n
Necesario para compatibilidad con clientes Java que utilizan API SOAP/JAXM.
1Distintos productos de Sun Java System comparten este paquete RPM. Se suministra con la distribuci�n de Message Queue, Platform Edition, pero no con Message Queue, Enterprise Edition.
Paquete de symlinks para clientes 3.5 Las ubicaciones de los archivos espec�ficos que se instalan con Message Queue en Linux han cambiado. Esto puede provocar errores en el funcionamiento de aplicaciones que dependan de la ubicaci�n anterior de algunos archivos de Message Queue. Por ejemplo, si los clientes utilizan secuencias de comandos para buscar archivos jar instalados con Message Queue 3.5, ya no podr�n encontrar dichos archivos.
Para solucionar este problema, se incluye en esta versi�n el paquete de Linux sun-mq-compat. Este paquete instala symlinks de ubicaciones de archivo de Message Queue 3.5 en las ubicaciones de archivo de Message Queue 3 2005Q1 (3.6) instaladas. Puede que este paquete no se proporcione en futuras versiones. Debe corregir las secuencias de comandos que apunten a ubicaciones de archivo anteriores de Message Queue.
El paquete sun-mq-compat se encuentra en las siguientes ubicaciones.
Para instalar el paquete sun-mq-compat
Problemas relacionados con la siguiente versi�n principal de Message Queue
La siguiente versi�n principal de Message Queue puede incluir cambios que impidan la compatibilidad con sus clientes actuales. Esta informaci�n se proporciona ahora para permitirle anticipar dichos cambios.
- �sta es la �ltima versi�n de Sun Java System Message Queue que ser� compatible con versiones anteriores de Sun One Message Queue 3.0.1. En concreto, las futuras versiones de Sun Java System Message Queue no admitir�n:
- Conexi�n de clientes 3.0.1 a agentes de la versi�n m�s reciente
- Actualizaci�n de un almac�n persistente 3.0.1 a la versi�n m�s reciente
- Agrupaci�n en cl�steres de agentes de 3.0.1 con agentes de la versi�n m�s reciente
- Uso de archivos de propiedades, almacenes de usuarios, listas de control de acceso, etc. de 3.0.1 con agentes de la versi�n m�s reciente
- �sta es la �ltima versi�n de Sun Java System Message Queue que admitir� la integraci�n como “System JMS Messaging Provider” para Sun Java System Application Server 7.X. Las futuras versiones de Sun Java System Message Queue s�lo ser�n compatibles con Sun Java System Application Server 8.0 y superior.
- �sta es la �ltima versi�n de Sun Java System Message Queue que incluir� el tiempo de ejecuci�n SOAP y ser� compatible con objetos administrados SOAP de Message Queue.
- Las futuras versiones s�lo admitir�n SOAP junto a una versi�n de Java 2 Standard Edition Platform compatible con SOAP.
- Sun Java System Dejar� de ofrecerse compatibilidad con clientes de Message Queue para todas las versiones de Java 2 Standard Edition 1.3. Java 2 Standard Edition 1.4 continuar� siendo compatible.
- Podr�an cambiar las ubicaciones de archivos espec�ficos instalados con Sun Java System Message Queue. Esto puede provocar que no funcionen aplicaciones existentes que dependan de la ubicaci�n actual de algunos archivos de Message Queue.
- Sun Java System Los clientes de Message Queue que utilicen una versi�n de Message Queue anterior a la siguiente versi�n principal puede que no tengan acceso a las nuevas funciones incluidas en dicha versi�n del producto.
Actualizaciones de la documentaci�n de Message Queue
Las siguientes secciones describen las actualizaciones de la documentaci�n de Message Queue 3 2005Q1 (3.6) y Message Queue 3 2005Q4 (3.6 SP3).
Actualizaciones de la documentaci�n de Message Queue 3 2005Q1 (3.6)
Se han actualizado los siguientes documentos de Message Queue de la versi�n 3.5 del producto:
Gu�a de instalaci�n
La Message Queue Installation Guide se ha actualizado para que incluya los cambios en la denominaci�n de productos e informaci�n espec�fica de las plataformas. Ahora, este documento contiene informaci�n de instalaci�n relevante para Message Queue, Platform Edition.
La informaci�n de instalaci�n de Message Queue Enterprise Edition ha pasado a la Gu�a de instalaci�n de Sun Java System.
Para obtener informaci�n acerca de la actualizaci�n y migraci�n a Message Queue 3 2005Q1 (3.6), Enterprise Edition, consulte la Gu�a de actualizaci�n y migraci�n de Sun Java System.
Visi�n general t�cnica
La Message Queue Technical Overview es un documento nuevo que se incluy� por primera vez en la versi�n Message Queue 3 2005Q1 (3.6) y se ha vuelto a redactar para la versi�n Message Queue 3 2005Q4 (3.6 SP3). Describe las funciones, arquitectura, tecnolog�a y terminolog�a del producto Message Queue. Este nuevo manual contiene informaci�n general incluida previamente en otros documentos y destinada a los usuarios de Message Queue, tanto a administradores como a desarrolladores, adem�s de a posibles usuarios.
Gu�a de administraci�n
La Message Queue Administration Guide se ha actualizado para que incluya los cambios en la denominaci�n de productos y las nuevas funciones. Tambi�n se ha reorganizado este documento para facilitar su uso a los administradores de Message Queue. La informaci�n general contenida anteriormente en este documento ha pasado a la Message Queue Technical Overview.
Message Queue Developer’s Guide for Java Clients
La Gu�a del desarrollador para clientes Java se ha actualizado para que incluya los cambios en la denominaci�n de productos y las nuevas funciones. Tambi�n se ha cambiado el nombre del documento por Message Queue Developer’s Guide for Java Clients.
Se ha reorganizado la Message Queue Developer’s Guide for Java Clients para facilitar su uso por parte de desarrolladores de clientes Java de Message Queue. La informaci�n general contenida anteriormente en este documento ha pasado a la Message Queue Technical Overview.
Gu�a del desarrollador para clientes C
La Gu�a del desarrollador para clientes C se ha actualizado para que incluya los cambios en la denominaci�n de productos y las nuevas funciones. Tambi�n se ha cambiado el nombre del documento por Message Queue Developer’s Guide for C Clients.
Se ha reorganizado la Message Queue Developer’s Guide for C Clients para facilitar su uso por parte de desarrolladores de clientes C de Message Queue. La informaci�n general contenida anteriormente en este documento ha pasado a la Message Queue Technical Overview.
Actualizaciones de la documentaci�n de Message Queue 3 2005Q4 (3.6 SP3)
Se han actualizado los siguientes documentos de Message Queue de la versi�n 3 2005Q1 (3.6) del producto:
Gu�a de instalaci�n
Se ha actualizado la Message Queue Installation Guide para que incluya los cambios realizados en la instalaci�n del producto desde la versi�n Message Queue 3 2005Q1 (3.6).
Visi�n general t�cnica
La Message Queue Technical Overview es un documento nuevo que se incluy� por primera vez en la versi�n Message Queue 3 2005Q1 (3.6) y se ha vuelto a redactar para la versi�n Message Queue 3 2005Q4 (3.6 SP3). Describe las funciones, arquitectura, tecnolog�a y terminolog�a del producto Message Queue. Este nuevo manual contiene informaci�n general incluida previamente en otros documentos y destinada a los usuarios de Message Queue, tanto a administradores como a desarrolladores, adem�s de a posibles usuarios.
Gu�a de administraci�n
Se ha reorganizado la Message Queue Administration Guide para facilitar su uso por parte de los administradores de Message Queue. La informaci�n general contenida anteriormente en este documento ha pasado a la Message Queue Technical Overview.
Message Queue Developer’s Guide for Java Clients
La Message Queue Developer’s Guide for Java Clients incluye un cap�tulo nuevo, “Using the Java API”.
Limitaciones y problemas conocidosEsta secci�n contiene una lista de los problemas conocidos de Message Queue 3 2005Q1 (3.6). Se describen las siguientes �reas:
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 generales
Esta secci�n aborda problemas generales de Message Queue 3 2005Q1 (3.6). Algunos ya se trataron en versiones anteriores de Message Queue. En este apartado se agrupan los problemas 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
- En Message Queue 3 2005Q1, el ejemplo de configuraci�n de agente para utilizar un servidor ldap como repositorio de usuarios se incluye en el �rea de delimitadores del archivo config.properties y el ejemplo de repositorio de usuarios ldap del archivo default.properties se ha marcado mediante un delimitador.
Si anteriormente utilizaba alg�n valor de propiedad del ejemplo de configuraci�n de propiedades de repositorio de usuarios ldap del archivo default.properties, el cliente de aplicaciones JMS recibir� una excepci�n de seguridad al intentar crear una conexi�n JMS. Esto se producir� despu�s de actualizar a Message Queue 3 2005Q1.
Cuando el cliente JMS intenta establecer conexi�n con el agente de Message Queue 3 2005Q1, se obtendr� un error en el registro del agente y el cliente JMS recibir� la siguiente excepci�n:
- Un error de RedHat Linux 2.1 (Error de NSS n�mero 5078380) puede provocar el bloqueo de los m�todos C-API de Message Queue MQCreateConnection (biblioteca C-API de Message Queue 3 2005Q1) o MQInitializeSSL (biblioteca C-API de Message Queue 3 2005Q1 o 3.5) si se crea un subproceso en la aplicaci�n C-API de Message Queue antes de que se realice una llamada a estos dos m�todos.
Soluci�n del problema
Al utilizar la biblioteca C-API de Message Queue 3 2005Q1, existen cuatro opciones para evitar este problema:
- Actualizar a RedHat Linux 3.0.
- Establecer la variable de entorno MQ_NSS_5078380_WORKAROUND antes de ejecutar la aplicaci�n del cliente C de Message Queue y establecer la propiedad de agente de Message Queue en imq.authentication.type=basic.
- Llamar a MQInistializeSSL(<cert-db-path>) antes de iniciar cualquier subproceso en la aplicaci�n de cliente C de Message Queue. Puede recurrir a la utilidad certutil para crear los archivos de base de datos de certificados.
- Crear una conexi�n con el agente de Message Queue llamando a MQCreateConnection antes de iniciar cualquier subproceso. No puede editar un archivo de configuraci�n de la instancia del agente sin haber iniciado la instancia del agente al menos una vez. Esto se debe a que el archivo config.properties no existe hasta que se inicia por primera vez la instancia del agente. Si desea configurar un agente para que utilice la persistencia de conexi�n o para definir otras propiedades de configuraci�n, inicie el agente una vez (con el nombre de instancia que se debe utilizar para crear el agente) para crear el archivo config.properties:
S�lo en Enterprise Edition
- S�lo se admiten en esta versi�n los cl�steres de agentes totalmente conectados. Esto significa que todos los agentes de un cl�ster deben establecer comunicaci�n directamente con todos los dem�s agentes del cl�ster. Si conecta agentes mediante el argumento de l�nea de comandos imqbrokerd -cluster, aseg�rese de incluir todos los agentes del cl�ster.
- Actualmente, un cliente conectado a un agente que forma parte de un cl�ster no puede utilizar QueueBrowser para examinar colas ubicadas en agentes remotos de dicho cl�ster. El cliente s�lo puede examinar el contenido de las colas que se encuentran en el agente al que est� directamente conectado. El cliente puede continuar enviando mensajes a cualquier cola o consumiendo mensajes desde una cola de cualquier agente del cl�ster; esta limitaci�n s�lo afecta a las funciones de exploraci�n.
- Si no se utiliza un agente maestro en un cl�ster, la informaci�n persistente almacenada por un agente que se ha a�adido al cl�ster no se distribuir� a los dem�s agentes del cl�ster.
- El servicio de conexi�n mediante SSL s�lo admite actualmente certificados de servidor firmados autom�ticamente, es decir, en el modo de host de confianza.
- Cuando un cliente JMS con transporte HTTP finaliza repentinamente (por ejemplo, mediante Ctrl-C), el agente espera aproximadamente un minuto antes de liberar la conexi�n de cliente y todos los recursos asociados.
Si se inicia otra instancia de cliente durante ese per�odo de un minuto y si �sta intenta utilizar el mismo ClientID, la misma suscripci�n duradera o la misma cola, recibir� una excepci�n “ID de cliente ya en uso”. No se trata de un problema real, es simplemente un efecto secundario del proceso de finalizaci�n descrito anteriormente. Si el cliente se inicia despu�s de un retraso de aproximadamente un minuto, todo deber�a funcionar correctamente.
Problemas de administraci�n y configuraci�n
Las utilidades imqadmin e imqobjmgr muestran un error cuando la ruta de clase (CLASSPATH) contiene comillas dobles en equipos Windows (ID de error 5060769).
Soluci�n del problema
Puede hacer caso omiso de este mensaje de error; el agente responde correctamente e informa a los consumidores de cualquier error. Este error no afecta a la fiabilidad del sistema.La opci�n -javahome de todas las secuencias de comandos de Solaris/Win no funciona si el valor incluye un espacio en blanco (ID de error 4683029).
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.
�stos son ejemplos de rutas que contienen espacios:
Windows:
C:\jdk 1.4Solaris:
/work/java 1.4Soluci�n del problema
Instale el tiempo de ejecuci�n Java en una ubicaci�n o ruta que no contenga espacios en blanco.Message Queue env�a mensajes residuales al registro del sistema en configuraciones regionales que no son C (ID de error 6193884).
Message Queue enviar� datos residuales al registro del sistema cuando el agente se ejecuta en una configuraci�n regional distinta a C.
Soluci�n del problema
Ejecute el agente en un una configuraci�n regional C.Problemas de agentes
En un cl�ster de agentes, el agente env�a los mensajes a la cola de una conexi�n remota que no puede iniciarse (ID de error 4951010).
Soluci�n del problema
El consumidor recibir� los mensajes cuando se inicie la conexi�n. Los mensajes se reenviar�n a otro consumidor si la conexi�n del consumidor est� cerrada.El comando HTTPS createQueueConnection muestra ocasionalmente una excepci�n en Windows 2000 (ID de error 4953348).
Soluci�n del problema
Vuelva a establecer la conexi�n.Al utilizar Ctrl-C para cerrar el agente, puede que se limpien las transacciones una vez cerrado el almac�n (ID de error 4934446).
Puede que el agente muestre errores con el siguiente motivo “Acceso al m�todo de almac�n cuando el almac�n est� cerrado.” (“Store method accessed after the store is closed.”) si el agente se cierra mientras se procesan mensajes o transacciones.
Soluci�n del problema
Puede hacer caso omiso de este mensaje de error; el agente responde correctamente e informa a los consumidores de cualquier error. Este error no afecta a la fiabilidad del sistema.No se puede tener acceso al agente cuando un almac�n persistente abre demasiados destinos (ID de error 4953354).
Soluci�n del problema
Esta situaci�n se produce cuando el agente alcanza el l�mite de descriptor de archivos abiertos del sistema. En Solaris y Linux, utilice el comando ulimit para aumentar el l�mite de descriptor de archivos.Cuando se destruye un destino, los consumidores se quedan sin referencia (ID de error 5060787).
Los consumidores activos se quedan sin referencia cuando se destruye un destino. En ese caso, dejan de recibir mensajes (aunque se vuelva a crear el destino).
Soluci�n del problema
No hay soluci�n para este problema.No funciona la selecci�n de mensajes al utilizar JMSMessageID (ID de error 6196233).
No funciona la selecci�n de mensajes al utilizar el selector “JMSMessageID = '<message_id>'”.
Soluci�n del problema
Cambie el selector:JMSMessageID = "ID:message-id-string"
por:
JMSMessageID IN ('ID:message-id-string', 'message-id-string')
Message Queue QueueBrowser muestra tambi�n mensajes sin confirmar (ID de error 6264003).
Al explorar el contenido de una cola, los mensajes producidos en una transacci�n pero que todav�a no est�n confirmados pueden aparecer en la enumeraci�n de QueueBrowser.
Soluci�n del problema
No hay soluci�n para este problema.
Archivos que se pueden distribuirSun Java System Message Queue 3 2005Q1 (3.6) contiene el siguiente conjunto de archivos que puede utilizar y distribuir libremente en formato binario:
Funciones de accesibilidad para usuarios con discapacidadSi desea disfrutar de las funciones de accesibilidad que se han comercializado tras la publicaci�n de este soporte, consulte las valoraciones de productos de la Secci�n 508, que se pueden obtener de Sun previa solicitud, para determinar las versiones m�s adecuadas para implementar soluciones accesibles. Puede encontrar versiones actualizadas de las aplicaciones en: http://sun.com/software/javaenterprisesystem/get.html.
Para obtener informaci�n sobre el compromiso de Sun con respecto a la accesibilidad, visite http://sun.com/access.
Informaci�n sobre problemas y respuestas de los clientesSi experimenta problemas con Sun Java System Message Queue, p�ngase en contacto con el servicio de asistencia t�cnica de Sun usando uno de estos procedimientos:
- Servicios de asistencia t�cnica en l�nea para el software de Sun en:
http://www.sun.com/service/sunone/softwarePara 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 t�cnica:
- Descripci�n del problema, incluida la situaci�n en la que �ste se produce y la forma en que afecta al funcionamiento
- Tipo de equipo, versi�n del sistema operativo y versi�n del producto, incluida cualquier revisi�n del producto y otro software que pudiera influir en el problema
- Pasos detallados de los m�todos que haya usado para reproducir el problema
- Cualquier registro de errores o volcados del n�cleo
Foro de software de Sun Java System
Puede encontrar un foro de Sun Java System Message Queue en la siguiente direcci�n:
Apreciamos 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.
Sun valora sus comentariosSun tiene inter�s en mejorar su documentaci�n y valora sus comentarios y sugerencias.
Para publicar sus comentarios, acceda a http://docs.sun.com y haga clic en “Send Comments” (Enviar comentarios). Se mostrar� un formulario en l�nea en el que deber� indicar el t�tulo del documento y el n�mero de referencia. El n�mero de referencia consta de siete o de nueve d�gitos y se encuentra en la p�gina que contiene el t�tulo de la gu�a o al principio del documento. Por ejemplo, el t�tulo de este libro es Sun Java System Message Queue 3 2005Q4 Notas de la versi�n y el n�mero de referencia, 819-3559.
Recursos adicionales de SunPuede encontrar informaci�n �til de Sun Java System en las siguientes direcciones de Internet:
- Documentaci�n para Message Queue
http://docs.sun.com/coll/1307.1- Documentaci�n de Sun Java System
http://docs.sun.com/prod/java.sys- Servicios profesionales de Sun Java System
http://www.sun.com/service/sunps/sunone- Servicio y productos de software de Sun Java System
http://www.sun.com/software- Servicios de asistencia al cliente de software de Sun Java System
http://www.sun.com/service/sunone/software- Base de datos de soluciones y asistencia al cliente de Sun Java System
http://www.sun.com/service/support/software- Servicios de formaci�n y asistencia al cliente de Sun
http://training.sun.com- Servicios profesionales y de consultor�a de Sun Java System
http://www.sun.com/service/sunps/sunone- Informaci�n de desarrolladores de Sun Java System
http://developers.sun.com- Servicios de asistencia para programadores de Sun
http://www.sun.com/developers/support- Formaci�n sobre el software de Sun Java System
http://www.sun.com/software/training- Hojas de datos de software de Sun
http://wwws.sun.com/software
Copyright � 2005 Sun Microsystems, Inc. Reservados todos los derechos.
Sun Microsystems, Inc. tiene derechos de propiedad intelectual relacionados con la tecnolog�a del producto que se describe en este documento. Especialmente, aunque sin limitarse a ello, estos derechos de propiedad intelectual pueden incluir una o varias patentes en Estados Unidos, las cuales figuran en http://www.sun.com/patents, as� como una o varias patentes adicionales (o patentes pendientes de adjudicaci�n) en Estados Unidos y en otros pa�ses.
PROPIEDAD/CONFIDENCIAL DE SUN
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 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.