Chapitre 1 Notes de version

Version 4.4

Numéro de référence 821-0891-05

Ces notes de version contiennent des informations importantes, disponibles au moment de la commercialisation de Sun GlassFish Message Queue 4.4. Vous y trouverez une description des nouvelles fonctions et des améliorations, des problèmes connus et des limites, ainsi que d’autres informations sur cette version. Lisez attentivement ce document avant de commencer à utiliser Message Queue 4.4.

Ces notes de version contiennent également des informations sur les versions 4.0, 4.1, 4.2 et 4.3 de Message Queue. Par exemple, reportez-vous aux sections Nouvelles fonctions de Message Queue 4.2, Nouvelles fonctions de Message Queue 4.1 et Nouvelles fonctions de Message Queue 4.0, respectivement, pour obtenir des informations sur les nouvelles fonctions de ces versions.

Vous trouverez la dernière édition de ces notes de version sur le site Web de documentation de Sun GlassFish Message Queue, à l'adresse http://docs.sun.com/coll/1307.7. Consultez ce site Web avant d'installer et de configurer votre logiciel, puis consultez-le régulièrement pour vous procurer la documentation concernant le produit et les notes de mise à jour les plus récentes.

Ces notes de version se composent des sections suivantes :

• Historique de révision des notes de mise à jour

• À propos de Message Queue 4.4

• Plates-formes et composants pris en charge par Message Queue 4.4

• Nouvelles fonctions de Message Queue 4.4 et versions récentes

• Fonctions qui seront désapprouvées dans les versions futures

• Bogues résolus dans Message Queue 4.4 et ses versions récentes

• Mises à jour de la documentation relative à Message Queue 4.4

• Problèmes connus et restrictions

• Fichiers redistribuables

• Accessibilité des personnes handicapées

• Comment signaler des problèmes et apporter des commentaires

• Vos commentaires sont les bienvenus

• Ressources Sun supplémentaires

Des URL de sites tiers, qui renvoient à des informations complémentaires connexes, sont référencés dans ce document.

Sun ne saurait être tenu responsable de la disponibilité des sites Web tiers mentionnés dans ce manuel. Sun décline toute responsabilité quant au contenu, à la publicité, aux produits ou tout autre matériel disponibles dans ou par l’intermédiaire de ces sites ou ressources. Sun ne pourra en aucun cas être tenu responsable, directement ou indirectement, de tous dommages ou pertes, réels ou invoqués, causés par ou liés à l’utilisation des contenus, biens ou services disponibles dans ou par l’intermédiaire de ces sites ou ressources.

Historique de révision des notes de mise à jour

Le tableau suivant répertorie les dates correspondant à toutes les versions 4.x du produit Message Queue et décrit, pour chaque version, les modifications apportées à ce document.

À propos de Message Queue 4.4

Sun GlassFish Message Queue est un service de messagerie complet qui offre des fonctions de messagerie asynchrones et fiables conformes à la spécification de messagerie Java (JMS) 1.1. En outre, Message Queue propose des fonctions supplémentaires par rapport à la spécification JMS pour répondre aux besoins de déploiement des entreprises à grande échelle.

Message Queue 4.4 est une version mineure créée pour être intégrée à la version 2.1.1 de Sun GlassFish Application Server. Par conséquent, aucune version téléchargeable et installable, séparée, de Message Queue 4.4 n'est disponible.

Plates-formes et composants pris en charge par Message Queue 4.4

Cette section couvre les sujets suivants liés aux conditions requises du système Message Queue 4.4 :

• Prise en charge de la plate-forme du système d'exploitation

• Prise en charge de la virtualisation du système

• Dépendances entre composants

Prise en charge de la plate-forme du système d'exploitation

Message Queue 4.4 est pris en charge par les plates-formes des systèmes d'exploitation Solaris, Linux, Windows et AIX. Le Tableau 1–2 présente les versions prises en charge pour chaque plate-forme. Pour les configurations matérielles requises de chaque plate-forme, reportez-vous au Sun GlassFish Message Queue 4.4 Installation Guide

Prise en charge de la virtualisation du système

La virtualisation du système est une technologie permettant l'exécution indépendante de plusieurs instances du système d'exploitation sur un matériel partagé. Le logiciel déployé sur un système d'exploitation hébergé dans un environnement virtualisé ne détecte généralement pas que la plate-forme a été virtualisée. Sun teste ses produits Sun Java System sur des combinaisons de virtualisation de système et de systèmes d'exploitation afin de s'assurer qu'ils fonctionnent aussi bien dans des environnements virtualisés correctement dimensionnés et configurés que dans des environnements non virtualisés. Pour plus d'informations sur la prise en charge des produits Sun Java System dans les environnements virtualisés, reportez-vous à la page http://download.oracle.com/820-4651.

Dépendances entre composants

Outre des configurations requises spécifiques à la plate-forme, Message Queue 4.4 dépend également de certains composants de base à installer pour développer et exécuter les clients Message Queue. Le Tableau 1–3 décrit ces composants. Vous pouvez également utiliser d'autres versions ou implémentations d'autres fournisseurs mais ces dernières n'ont pas fait l'objet de tests par Sun Microsystems et ne sont, par conséquent, pas prises en charge officiellement.

Le programme d'installation de Message Queue pour les plates-formes Solaris, Linux et Windows vous permet de sélectionner un JDK/JRE ou d'installer la dernière version de JDK (1.5.0_15).

Le Tableau 1–4 présente les composants supplémentaires que vous pouvez installer pour fournir une plus grande prise en charge des clients de Message Queue. Vous n'avez pas forcément besoin de tous les composants répertoriés : par exemple, si vous n'écrivez pas de client C, vous n'aurez pas besoin du compilateur C, de la bibliothèque runtime C++, de NSPR ni de NSS.

Nouvelles fonctions de Message Queue 4.4 et versions récentes

Les nouvelles fonctions de Message Queue 4.4 et des versions précédentes de la gamme Message Queue 4.x sont décrites dans les sections suivantes :

• Nouvelles fonctions de Message Queue 4.4

• Nouvelles fonctions de Message Queue 4.3

• Nouvelles fonctions de Message Queue 4.2

• Nouvelles fonctions de Message Queue 4.1

• Nouvelles fonctions de Message Queue 4.0

Nouvelles fonctions de Message Queue 4.4

Message Queue 4.4 est une version mineure apportant un certain nombre d'améliorations de fonctions et de corrections de bogues. Cette section décrit les nouvelles fonctions de cette version :

• Service de pont JMS

• Service de pont STOMP

• Améliorations supplémentaires

Service de pont JMS

La spécification JMS ne définissant pas un protocole câblé pour la communication entre les courtiers et les clients, chaque fournisseur JMS (y compris ceux de Message Queue) a défini et utilise son propre protocole propriétaire. Cette situation a mené à une non-interopérabilité entre les fournisseurs JMS.

Le service de pont JMS dans Message Queue 4.4 met fin à cette désynchronisation en activant un courtier Message Queue destiné à mapper ses destinations à celles de fournisseurs JMS externes. Concrètement, ce mappage permet au courtier de Message Queue de communiquer avec des clients du fournisseur JMS externe.

Le service de pont JMS prend en charge les destinations de mappage des fournisseurs JMS externes :

• Compatibles JMS1.1

• Prenant en charge les objets administratifs JNDI

• Utilisant des fabriques de connexion de type javax.jms.ConnectionFactory ou javax.jms.XAConnectionFactory

• Dans le cadre d'un mappage transactionnel, prenant en charge les interfaces XA comme un gestionnaire de ressources

De nombreux fournisseurs JMS open source et commerciaux répondent à ces exigences, de sorte que le service de pont JMS permet d'intégrer efficacement Message Queue dans un environnement de messagerie existant qui utilise d'autres fournisseurs JMS.

Pour plus d'informations sur le service de pont JMS, voir :

• Pour plus d'informations sur l'architecture, les sous-composants et les capacités du service de pont JMS, reportez-vous à la section JMS Bridge Service du Sun GlassFish Message Queue 4.4 Technical Overview

• Pour plus d'informations sur la configuration et la gestion des ponts JMS dans un courtier, reportez-vous à la section Configuring and Managing JMS Bridge Services du Sun GlassFish Message Queue 4.4 Administration Guide

Service de pont STOMP

Comme indiqué précédemment, la spécification JMS ne définit pas de protocole câblé pour la communication entre les courtiers et les clients. Le projet open source STOMP (Streaming Text Oriented Messaging Protocol), disponible à la page http://stomp.codehaus.org, définit un protocole câblé simple que les clients écrits dans n'importe quel langage peuvent utiliser pour communiquer avec un fournisseur de messagerie prenant en charge le protocole STOMP.

Message Queue 4.4 prend en charge le protocole STOMP via le service de pont STOMP. Ce service permet à un courtier Message Queue de communiquer avec les clients STOMP.

Pour plus d'informations sur le service de pont STOMP :

• Pour plus d'informations sur l'architecture et les capacités du service de pont STOMP, reportez-vous à la section STOMP Bridge Service du Sun GlassFish Message Queue 4.4 Technical Overview.

• Pour plus d'informations sur la configuration et la gestion d'un pont STOMP dans un courtier, reportez-vous à la section Configuring and Managing STOMP Bridge Services du Sun GlassFish Message Queue 4.4 Administration Guide.

Améliorations supplémentaires

Les améliorations supplémentaires suivantes sont également disponibles dans Message Queue 4.4 :

• Nouvelles fonctions UMS (Universal Message Service)

• Package IPS pris en charge

Nouvelles fonctions UMS (Universal Message Service)

Le service UMS fournit maintenant des fonctions qui utilisent HTTP GET pour offrir plusieurs services :

• ssend : envoyer un message texte simple.

• sreceive : recevoir un message texte simple.

• getbrokerinfo: récupérer des informations sur le courtier.

• getconfiguration : récupérer les informations relatives à la configuration UMS.

• debug : activer ou désactiver l'enregistrement de débogage sur le serveur UMS.

• ping : communiquer avec le courtier pour confirmer qu'il est en cours d'exécution.

Pour une présentation des UMS, reportez-vous à la section Universal Message Service (UMS). Pour la documentation de l'API UMS, consultez le site https://mq.dev.java.net/4.3-content/ums/protocol.html. Pour obtenir des exemples de programmation dans plusieurs langages, consultez la page https://mq.dev.java.net/4.3-content/ums/examples/README.html.

Package IPS pris en charge

Message Queue est désormais fourni pour distribution avec le système IPS (Image Packaging System, système de conditionnement d'image) open source, également appelé système pkg(5). Cette méthode de conditionnement a été ajoutée afin que Message Queue puisse être intégré à Sun GlassFish Enterprise Server 2.1.1.

Nouvelles fonctions de Message Queue 4.3

Message Queue 4.3 était une version mineure apportant un certain nombre d'améliorations de fonctions et des corrections de bogues. Cette section décrit les nouvelles fonctions incluses dans cette version :

• Universal Message Service (UMS)

• Prise en charge de la plate-forme AIX

• Nouveau programme d'installation à partir de zip

• Prise en charge d'une plate-forme étendue

Universal Message Service (UMS)

Message Queue 4.3 introduit un nouveau service UMS (Universal Messaging Service, service de messagerie universelle) et une API de messagerie qui permet d'accéder à Message Queue à partir de n'importe appareil compatible http. Par conséquent, la plupart des applications peuvent communiquer avec toute autre application et profiter de la fiabilité et de l'envoi garanti de messages JMS. En outre, le service UMS offre une évolutivité améliorée pour la messagerie JMS, permettant d'augmenter le nombre de clients de messagerie à l'échelle d'Internet.

Architecture

La figure suivante illustre l'architecture UMS de base :

Figure 1–1 Architecture UMS

Le service UMS, qui s'exécute sur un serveur Web, est un langage neutre et indépendant de la plate-forme. Le service UMS sert de pont entre une application cliente non JMS et un fournisseur JMS. Il reçoit les messages envoyés via l'API UMS, les transforme en messages JMS, puis les envoie aux différentes destinations dans le fournisseur JMS par le biais du protocole natif du fournisseur. De même, il extrait les messages des destinations du fournisseur JMS, les transforme en texte ou en messages SOAP, puis envoie les messages aux clients non JMS comme demandé par les clients via l'API UMS.

L'API UMS, basée sur un protocole simple, non dépendant d'un langage, prend en charge les applications basées sur le Web et non basées sur le Web, et peut être utilisée avec les langages de script et de programmation. L'API est proposée dans deux styles : une API de messagerie simple qui utilise un protocole de type REST (Representational State Transfer) et une API de messagerie XML qui incorpore le protocole dans les en-têtes de messages SOAP. Dans les deux cas, cependant, l'API ne requiert qu'une seule requête http pour envoyer ou recevoir un message.

La simplicité et la flexibilité de l'API UMS signifie que AJAX, .NET, Python, C, Java et bien d'autres applications peuvent envoyer un message texte et/ou des messages SOAP (avec pièce jointe) aux destinations JMS ou recevoir de messages de destinations JMS. Par exemple, les applications Python peuvent communiquer avec les applications .NET, les applications iPhone avec les applications Java, etc.

Pour Message Queue 4.3, le service UMS prend uniquement en charge Message Queue en tant que fournisseur JMS.

Autres fonctions

Le service UMS est plus que le simple pont décrit ci-dessus. Il prend en charge les sessions client avec ou sans état. Si le client le demande, le service UMS conservera l'état de la session pour l'application client sur plusieurs requêtes de service. Le service UMS peut utiliser l'authentification par conteneur, être configuré pour authentifier les clients à l'aide du courtier Message Queue, ou les deux. Le service UMS prend également en charge les transactions, permettant ainsi aux applications clientes de valider ou répéter plusieurs requêtes de service comme une seule unité atomique.

Le service UMS pouvant prendre en charge un grand nombre de clients sur une connexion unique avec le courtier Message Queue, il facilite la charge des services de connexion du courtier, pour une évolutivité optimale. En outre, la capacité UMS peut être augmentée par mise à l'échelle horizontale, ce qui permet des charges de messagerie de niveau Internet.

Côté client, en raison de la simplicité de l'API UMS basée sur protocole, aucun client de bibliothèque n'est requis. Par conséquent, l'API peut être étendue à l'avenir pour mettre en œuvre des fonctions JMS sans mettre à niveau les applications clientes.

Utilisation du service UMS

Pour utiliser le service UMS, vous devez le déployer dans un conteneur Web prenant en charge les spécifications Servlet 2.4 ou version ultérieure, démarrer le courtier Message Queue, créer les destinations appropriées et écrire une application de messagerie qui utilise l'API UMS pour envoyer ou recevoir des messages.

Le fichier UMS imqums.war, contenu dans la distribution de Message Queue 4.3, est installé à l'emplacement suivant, en fonction de la plate-forme :

Vous pouvez renommer le fichier .war.

Après avoir déployé le fichier imqums.war dans un conteneur Web à localhost:port, vous pouvez trouver la documentation UMS disponible à l'adresse suivante :

http://localhost:port/imqums

Sinon, vous pouvez trouver la documentation UMS comme suit :

• Pour plus d'informations sur la configuration du service UMS, reportez-vous à la page https://mq.dev.java.net/4.3-content/ums/config.html.

• Pour la documentation de l'API UMS, consultez la page https://mq.dev.java.net/4.3-content/ums/protocol.html.

• Pour obtenir des exemples de programmation dans plusieurs langages, reportez-vous à la page https://mq.dev.java.net/4.3-content/ums/examples/README.html.

Conteneurs Web pris en charge

Le service UMS est actuellement pris en charge sur les conteneurs Web suivants :

• Sun GlassFish Enterprise Server, Version 2.1 et Version 3 Prelude

• Tomcat, Versions 5.5 et 6.0

Prise en charge de la plate-forme AIX

Message Queue 4.3 fournit des packages pour la plate-forme AIX et un programme d'installation pour les installer.

L'implémentation AIX de Message Queue prend en charge les logiciels suivants :

• AIX v 6.1 ou version supérieure (les versions précédentes de AIX sont prises en charge via l'ensemble Unix/Java uniquement)

• Prise en charge de DB2

• IBM XL C/C++ V9.0

• JDK 1.5 ou supérieur

Pour obtenir des instructions sur la procédure d'installation, reportez-vous au Chapitre 4, AIX Installation du Sun GlassFish Message Queue 4.4 Installation Guide.

Sur la plate-forme AIX, les fichiers Message Queue sont installés sous un répertoire de base Message Queue unique, IMQ_HOME. IMQ_HOME indique le répertoire mqInstallHome/mq, où mqInstallHome est le répertoire d'installation de base que vous avez spécifié lors de l'installation du produit (par défaut, home-directory /MessageQueue).

La structure du répertoire de Message Queue qui en résulte est identique à celle de la plate-forme Windows (reportez-vous à la section Windows de l'Annexe A, Platform-Specific Locations of Message Queue Data du Sun GlassFish Message Queue 4.4 Administration Guide).

La prise en charge de Message Queue pour la plate-forme AIX comprend la prise en charge de la C-API de Message Queue. Pour obtenir des instructions sur la création et la compilation d'applications C sur la plate-forme AIX, reportez-vous à XREF.

Nouveau programme d'installation à partir de zip

Message Queue 4.3 introduit un nouveau programme d'installation pour les distributions basées sur des zips, par opposition aux distributions de packages natifs. Le programme d'installation permet d'installer les nouvelles distributions .zip de Message Queue pour la plate-forme AIX.

Le nouveau programme d'installation extrait les fichiers .zip de Message Queue vers tout répertoire pour lequel vous disposez de droits d'accès en écriture (il n'est pas nécessaire de disposer de droits d'accès de superutilisateur), et il vous permet également d'enregistrer votre installation de Message Queue avec Sun Connection.

Pour réduire la taille de téléchargement des bundles, Java Runtime n'est plus inclus dans le zip de la distribution (la plupart des sites en sont déjà équipés). Par conséquent, la commande installer nécessite de spécifier un JDK ou un JRE, soit à l'aide de la variable d'environnement JAVA_HOME, soit à l'aide de l'option -j de la ligne de commande, comme suit :

$ installer -j JDK/JRE-path

où JDK/JRE-path correspond au chemin d'accès au JDK ou JRE spécifié.

Prise en charge d'une plate-forme étendue

La prise en charge de la plate-forme mise à jour suivante sera certifiée pour Message Queue 4.3 :

• Oracle 11g

• Windows Server 2008

Améliorations supplémentaires

Les améliorations supplémentaires suivantes sont incluses dans Message Queue 4.3 :

• Nouvelle structure de répertoires sur les plates-formes Windows

• Nouvelles propriétés de courtier

• Améliorations de l'API d'administration JMX

• Liste des abonnements durables pour les abonnés de messages génériques

Nouvelle structure de répertoires sur les plates-formes Windows

La structure de répertoires installée pour Message Queue sur la plate-forme Windows a été modifiée par rapport aux versions précédentes pour la rendre identique à celle de la plate-forme AIX. Cette structure de répertoires sera également appliquée aux plates-formes Solaris et Linux dans le futur, afin de faciliter les installations multiples sur seul ordinateur et la mise à jour automatique de Message Queue via Sun Connection, un service hébergé par Sun qui vous aide à suivre, organiser et entretenir le matériel et les logiciels Sun (reportez-vous à la section Prise en charge du programme d'installation pour l'enregistrement à Sun Connection).

Nouvelles propriétés de courtier

Les nouvelles propriétés suivantes sont disponibles pour la configuration d'un courtier :

Améliorations de l'API d'administration JMX

Un nouvel attribut et des clés de données composites ont été ajoutés à l'API JMX, comme suit :

• Un attribut NextMessageID a été ajouté au MBean de contrôle de destination afin de fournir l'ID de message JMS du prochain message envoyé à un consommateur.

• Une clé NextMessageID pour date composite a été ajoutée au MBean de contrôle du gestionnaire de consommateurs pour fournir l'ID de message JMS du prochain message envoyé au consommateur.

• Une clé NumMsgsPending pour date composite a été ajoutée au MBean de contrôle du gestionnaire de consommateurs pour fournir le nombre de messages distribués au consommateur.

Pour de plus amples informations, reportez-vous au Chapitre 3, Message Queue MBean Reference du Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients.

Liste des abonnements durables pour les abonnés de messages génériques

La commande permettant de dresser une liste des abonnements durables :

list dur [-d topicName]

a été améliorée afin que la spécification du nom de la rubrique soit facultative. Si la rubrique n'est pas spécifiée, la commande crée une liste de l'ensemble des abonnements durables pour toutes les rubriques (y compris ceux comportant des conventions d'attribution de noms avec des caractères génériques)

Nouvelles fonctions de Message Queue 4.2

Message Queue 4.2 était une version mineure apportant un certain nombre d'améliorations de fonctions et des corrections de bogues. Cette section décrit les nouvelles fonctions de la version 4.2 et fournit de plus amples références destinées à votre usage :

• Destinations multiples pour un éditeur ou un abonné

• Validation des schémas des messages de charge utile XML

• Prise en charge de C-API pour les transactions distribuées

• Prise en charge du programme d'installation pour l'enregistrement à Sun Connection

• Prise en charge de la base de données MySQL

• Améliorations supplémentaires

Pour de plus amples informations sur les fonctions introduites dans Message Queue 4.1 et 4.0, reportez-vous respectivement aux sections Nouvelles fonctions de Message Queue 4.1 et Nouvelles fonctions de Message Queue 4.0.

Destinations multiples pour un éditeur ou un abonné

Dans Message Queue 4.2, un éditeur peut publier des messages vers de multiples destinations de sujet et un abonné peut recevoir des messages provenant de multiples destinations de sujet. Cette capacité est obtenue en utilisant un nom de destination de sujet incluant des caractères génériques, permettant ainsi de multiples destinations. L'utilisation de noms symboliques de ce type permet aux administrateurs de créer des destinations de sujet supplémentaires, selon le cas, de façon cohérente avec le schéma de nommage générique. Les éditeurs et les abonnés publient et consomment automatiquement à partir des destinations ajoutées. (Les abonnés de sujet générique sont plus courants que les éditeurs.)

Cette fonction ne s'applique pas aux destinations de files d'attente.

Le format des noms de destination de sujet symboliques et d'autres exemples de leur utilisation sont décrits à la section Supported Topic Destination Names du Sun GlassFish Message Queue 4.4 Administration Guide.

Validation des schémas des messages de charge utile XML

Cette fonctionnalité, introduite dans Message Queue 4.2, permet de valider le contenu d'un message XML texte (pas objet) par rapport à un schéma XML au moment où le message est envoyé au courtier. L'emplacement du schéma XML (XSD, XML Schema Directory) est spécifié comme une propriété d'une destination de Message Queue. Si aucun emplacement XSD n'est spécifié, la déclaration DTD du document XML est utilisée pour exécuter une validation DTD. (La validation XSD, qui comprend la validation du type de données et de la fourchette de valeurs, est plus rigoureuse que la validation DTD.)

Pour plus d'informations concernant l'utilisation de cette fonctionnalité, consultez la section Validation des schémas des messages de charge utile XML.

Prise en charge de C-API pour les transactions distribuées

Selon le modèle de transaction distribuée X/Open, la prise en charge pour les transactions distribuées dépend d'un gestionnaire de transactions distribuées qui suit et gère les opérations exécutées par un ou plusieurs gestionnaires de ressources. Dans Message Queue 4.2, la C-API de Message Queue prend désormais en charge l'interface XA (entre un gestionnaire de transactions distribuées et Message Queue en tant que gestionnaire de ressources conforme à XA), permettant aux clients de la C-API de Message Queue s'exécutant dans un environnement de traitement des transactions distribuées (comme BEA Tuxedo) de participer aux transactions distribuées.

Cette prise en charge des transactions distribuées se compose des nouvelles fonctions C-API suivantes (et de nouveaux paramètres et codes d'erreur) utilisées pour implémenter la spécification de l'inferface XA :

MQGetXAConnection()
MQCreateXASession()

Si une application client C doit être utilisée dans le contexte d'une transaction distribuée, alors elle doit obtenir une connexion à l'aide de MQGetXAConnection() et créer une session pour produire et consommer des messages à l'aide de MQCreateXASession(). Le lancement, la validation et la répétition de toute transaction distribuée sont gérés via des API fournies par le gestionnaire de transactions distribuées.

Pour plus de détails sur l'utilisation des fonctions de transaction distribuée, reportez-vous à la section Working With Distributed Transactions du Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients.

Message Queue  4.2 fournit des exemples de programmation sur la base du gestionnaire de transactions Tuxedo. Pour plus d'informations sur l'utilisation de ces programmes échantillons, reportez-vous à la section Distributed Transaction Sample Programs du Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients.

La fonctionnalité de transaction distribuée est prise en charge sous Solaris, Linux et Windows. Cependant, à ce jour, elle a uniquement été certifiée sur la plate-forme Solaris.

Prise en charge du programme d'installation pour l'enregistrement à Sun Connection

Le programme d'installation de Message Queue a été amélioré pour permettre l'enregistrement de Message Queue avec Sun Connection, un service hébergé par Sun qui vous aide à suivre, organiser et mettre à jour votre matériel et vos logiciels Sun.

Dans le cadre de l'installation de Message Queue, vous pouvez choisir d'enregistrer Message Queue avec Sun Connection. Les informations concernant le programme Message Queue installé, comme la version, le nom d'hôte, le système d'exploitation, la date d'installation et d'autres informations de base du même type, sont transmises de façon sécurisée à la base de données de Sun Connection. Le service d'inventaire de Sun Connection peut vous aider à organiser vos logiciels et votre matériel Sun, tandis que le service de mise à jour peut vous informer des dernières corrections de sécurité disponibles, des mises à jour recommandées et des améliorations de fonctions.

Pour plus d'informations sur l'enregistrement de Message Queue avec Sun Connection, reportez-vous au Sun GlassFish Message Queue 4.4 Installation Guide.

Prise en charge de la base de données MySQL

Message Queue 4.2 a introduit la prise en charge de la base de données MySQL en tant que magasin de données basé sur JDBC. MySQL Cluster Edition peut être utilisé comme base de données JDBC pour un courtier autonome et comme magasin de données partagées hautement disponible nécessaire à un cluster de courtier amélioré. Pour de plus amples informations sur la configuration de Message Queue pour utiliser MySQL, reportez-vous aux sections Configuring a JDBC-Based Data Store du Sun GlassFish Message Queue 4.4 Administration Guide du Enhanced Broker Cluster Properties du Sun GlassFish Message Queue 4.4 Administration Guide.

Améliorations supplémentaires

En plus des fonctions décrites ci-dessus, Message Queue 4.2 inclut les améliorations suivantes :

• Métriques de messages produites à distance

  Message Queue 4.2 comprend de nouvelles métriques de destination pouvant être utiles lors de la surveillance des destinations dans un cluster de courtiers. Dans un cluster de courtiers, les messages stockés dans une destination donnée sur un courtier donné du cluster se composent de messages produits directement vers la destination et de messages envoyés à la destination à partir de courtiers distants dans le cluster. L'analyse de l'acheminement et de la livraison des messages dans un cluster de courtiers est parfois utile pour savoir, dans une destination, combien de messages sont locaux (produits localement) et distants (produits à distance).

  Deux nouvelles quantités métriques de destination physique sont incluses dans Message Queue 4.2 : Nb de messages à distance et Nbre total d'octets de message à distance. Les nouvelles quantités métriques sont disponibles via les commandes imqcmd list dst et imqcmd query dst (voir la section Viewing Physical Destination Information du Sun GlassFish Message Queue 4.4 Administration Guide) et via de nouveaux attributs JMX (voir la section Destination Monitor du Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients).

• Informations relatives aux producteurs et consommateurs de messages génériques

  Des informations relatives à la prise en charge de l'utilisation de caractères génériques dans les noms de destination (voir la section Destinations multiples pour un éditeur ou un abonné) sont fournies par le biais de nouvelles données de contrôle. Par exemple, le nombre de producteurs ou consommateurs de messages génériques associé à une destination est accessible via la commande imqcmd query dst (voir la section Viewing Physical Destination Information du Sun GlassFish Message Queue 4.4 Administration Guide) et via de nouveaux attributs JMX (voir la section Destination Monitor du Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients). Les informations relatives aux messages génériques sont également disponibles via les MBeans de contrôle du gestionnaire de consommateurs et de contrôle du gestionnaire des producteurs.

• Prise en charge du format de nom d'utilisateur dynamique pour l'authentification client

  Message Queue 4.2 a introduit la prise en charge du format de nom d'utilisateur dynamique dans l'authentification de connexion client par rapport au répertoire utilisateur LDAP. La prise en charge implique la nouvelle propriété suivante de courtier (et sa valeur) :

  imq.user_repository.ldap.usrformat=dn

  Cette propriété permet au courtier d'authentifier un utilisateur client par rapport à une entrée dans un répertoire utilisateur LDAP en extrayant du format du nom d'utilisateur dynamique la valeur de l'attribut spécifiée par la propriété suivante :

  imq.user_repository.ldap.uidattr

  Le courtier utilise la valeur de l'attribut ci-dessus comme nom de l'utilisateur dans les opérations de contrôle d'accès.

  Par exemple, si imq.user_repository.ldap.uidattr=udi et un nom d'utilisateur dynamique d'authentification client est au format udi=mquser,ou=People,dc=red,dc=sun,dc=com , alors “mquser” doit être extrait pour effectuer un contrôle d'accès.

• Amélioration de l'authentification JAAS

  Message Queue 4.2 a introduit l'authentification JAAS par adresse IP ainsi que par nom d'utilisateur.

Nouvelles fonctions de Message Queue 4.1

Message Queue 4.1 était une version mineure apportant un certain nombre de nouvelles fonctions, des améliorations de fonctions et des corrections de bogues. Cette section décrit les nouvelles fonctions de la version 4.1 et fournit de plus amples références destinées à votre usage :

• Clusters de courtiers haute disponibilité

• Prise en charge de JAAS

• Modification du format du magasin de données persistant

• Configuration de l'environnement du courtier

• Prise en charge de Java ES Monitoring Framework

• Gestion améliorée des transactions

• Ports fixes pour les connexions de clients C

Pour obtenir des informations sur les nouvelles fonctions de Message Queue 4.0, reportez-vous à la section Nouvelles fonctions de Message Queue 4.0.

Clusters de courtiers haute disponibilité

Message Queue 4.1 a introduit un nouveau cluster de courtiers amélioré. Comparés aux clusters de courtiers traditionnels assurant la disponibilité du service de messagerie (si un courtier échoue, un autre courtier est disponible pour fournir un service de messagerie), les clusters de courtiers améliorés assurent eux la disponibilité des données (si un courtier échoue, ses messages persistants et données d'état sont disponibles pour qu'un autre courtier puisse le relayer et délivrer les messages).

L'implémentation de haute disponibilité introduite dans Message Queue 4.1 utilise un magasin de données basé sur JDBC partagé : plutôt que tous les courtiers d'un cluster de courtiers disposent de leur propre magasin de données persistantes, tous les courtiers du cluster partagent la même base de données compatible JDBC. Si un courtier particulier échoue, un autre courtier du cluster prend sa relève pour acheminer et livrer ses messages. Le courtier de basculement utilise alors les données et les informations d'état du magasin de données partagées. Les clients du courtier défaillant ayant émis les messages se reconnectent au courtier de basculement, et le service de messagerie est ininterrompu.

Le magasin partagé basé sur JDBC utilisé dans l'implémentation haute disponibilité de Message Queue 4.1 doit être lui-même hautement disponible. Si vous ne possédez pas de base de données hautement disponible ou si la livraison ininterrompue de messages n'est pas importante pour vous, vous pouvez continuer à utiliser les clusters traditionnels qui fournissent une disponibilité de service sans disponibilité de données.

Pour configurer un cluster de courtiers amélioré pour Message Queue 4.1, vous devez spécifier les propriétés de courtier suivantes pour chaque courtier du cluster :

• Propriétés d'appartenance au cluster : spécifient l'appartenance du courtier à un cluster de courtiers amélioré, l'ID de ce cluster et l'ID du courtier dans le cluster.

• Propriétés de base de données hautement disponible : spécifient le modèle de données persistantes (JDBC), le nom du fournisseur et les propriétés de configuration spécifiques au fournisseur.

• Propriétés de détection d'échecs et de basculement : spécifient comment un échec de courtier est détecté et géré à l'aide d'un courtier de substitution.

L'implémentation de clusters de courtiers améliorés se fait selon les étapes suivantes :

1. Installez une base de données hautement disponible.

2. Installez le fichier .jar du pilote JDBC.

3. Créez le schéma de base de données pour le magasin de données persistant hautement disponible.

4. Paramétrez des propriétés haute disponibilité pour chaque courtier du cluster.

5. Démarrez chaque courtier du cluster.

Si vous souhaitez consulter une discussion conceptuelle sur les clusters de courtiers améliorés et obtenir une comparaison de ceux-ci par rapport aux clusters conventionnels, reportez-vous au Chapitre 4, Broker Clusters du Sun GlassFish Message Queue 4.4 Technical Overview. Pour obtenir des informations procédurales et référentielles sur les clusters de courtiers améliorés, reportez-vous au Chapitre 10, Configuring and Managing Broker Clusters du Sun GlassFish Message Queue 4.4 Administration Guide et à la section Cluster Configuration Properties du Sun GlassFish Message Queue 4.4 Administration Guide.

Si vous avez utilisé une base de données hautement disponible avec Message Queue 4.0 et si vous souhaitez passer à un cluster de courtiers amélioré, vous pouvez utiliser l'utilitaire Gestionnaire de base de données (imqdbmgr) pour une conversion vers un magasin de données persistant partagé. Reportez-vous également à Clusters de courtiers pour plus de problèmes et restrictions connus.

Prise en charge de JAAS

En plus des mécanismes d'authentification intégrés basés sur les fichiers et le LDAP, Message Queue introduit également la prise en charge de JAAS (Java Authentication and Authorization Service), qui vous permet de connecter un mécanisme d'authentification au courtier pour authentifier les clients Message Queue.

Pour obtenir une description des informations qu'un courtier met à disposition d'un service d'authentification conforme à JAAS et une explication sur la façon de configurer le courtier pour utiliser un tel service, reportez-vous à la section Using JAAS-Based Authentication du Sun GlassFish Message Queue 4.4 Administration Guide.

Modification du format du magasin de données persistant

Message Queue 4.1 a modifié le magasin de données basé sur JDBC pour prendre en charge des clusters de courtiers améliorés. Pour cette raison, le format du magasin de données basé sur JDBC est passé à la version 410. Les versions aux formats 350, 370 et 400 sont automatiquement migrées vers la version 410.

Veuillez noter que le format du magasin de données persistant basé sur les fichiers reste à la version 370 car aucun changement n'a été apporté à cette version.

Configuration de l'environnement du courtier

La propriété IMQ_DEFAULT_EXT_JARS a été ajoutée au fichier de configuration de l'environnement Message Queue 4.1 imqenv.conf. Vous pouvez définir cette propriété pour spécifier les noms de chemin des fichiers .jar externes à inclure dans CLASSPATH au démarrage du courtier. Si vous utilisez cette propriété pour spécifier l'emplacement des fichiers .jar externes, il ne vous sera plus nécessaire de copier ces fichiers dans le répertoire lib/ext. Ces fichiers .jar externes peuvent faire référence aux pilotes JDBC ou aux modules de connexion JAAS. L'exemple de propriété suivant spécifie l'emplacement des pilotes JDBC.

IMQ_DEFAULT_EXT_JARS=/opt/SUNWhadb4/lib/hadbjdbc4.jar:/opt/SUNWjavadb/derby.jar

Prise en charge de Java ES Monitoring Framework

Message Queue 4.1 a introduit la prise en charge de Sun Java Enterprise System (Java ES) Monitoring Framework, qui permet de surveiller les composants Java ES à l'aide d'une interface graphique commune. Cette interface est implémentée par une console basée sur le Web, Sun Java System Monitoring Console. Les administrateurs peuvent utiliser la console pour visualiser les statistiques de performance, créer des règles de surveillance automatique et accuser réception des alarmes. Si vous exécutez Message Queue en même temps que d'autres composants Java ES, vous trouverez peut-être plus pratique d'utiliser une seule interface pour tous les gérer.

Pour obtenir des informations sur l'utilisation de Java ES Monitoring Framework pour surveiller Message Queue, reportez-vous à XREF.

Gestion améliorée des transactions

Auparavant, seules les transactions à l'état PREPARED pouvaient être annulées administrativement. Par exemple, lorsqu'une session, faisant partie d'une transaction distribuée, ne s'arrêtait pas normalement, la transaction était conservée à un état qui ne pouvait pas être nettoyé par un administrateur. Dans Message Queue 4.1, vous pouvez désormais utiliser l'utilitaire Commande (imqcmd) pour nettoyer (annuler) des transactions dont l'état est l'un des suivants : STARTED, FAILED, INCOMPLETE, COMPLETE et PREPARED.

Pour vous aider à déterminer si une transaction particulière peut être annulée ou pas (en particulier son état n'est pas PREPARED), l'utilitaire Commande fournit des données supplémentaires dans la sortie imqcmd query txn : il fournit l'ID de connexion pour la connexion à l'origine de la transaction et indique l'heure à laquelle la transaction a été créée. À l'aide de ces informations, un administrateur peut alors décider d'annuler ou non la transaction. En règle générale, il est préférable que l'administrateur évite d'annuler une transaction prématurément.

Ports fixes pour les connexions de clients C

Dans Message Queue 4.1, les clients C, comme les clients Java, peuvent maintenant se connecter à un port de courtier fixe plutôt qu'à un port affecté de façon dynamique par le service du courtier Port Mapper. Les connexions de port fixe sont utiles si vous essayez de franchir un pare-feu ou si avez besoin de contourner le service Port Mapper pour d'autres raisons.

Pour configurer une connexion de port fixe, vous devez configurer à la fois l'exécution du courtier et du client C (les deux extrémités de la connexion). Par exemple, si vous souhaitez connecter votre client via ssljms au port 1756, il vous faut procéder comme suit :

• Côté client, paramétrez les propriétés suivantes :

  MQ_SERVICE_PORT_PROPERTY=1756

  MQ_CONNECTION_TYPE_PROPERTY=SSL

• Côté courtier, paramétrez la propriété imq.serviceName.protocolType .port comme suit :

  imq.ssljms.tls.port=1756

La propriété de connexion MQ_SERVICE_PORT_PROPERTY a été reportée dans Message Queue 3.7 Mise à jour 2.

Nouvelles fonctions de Message Queue 4.0

Message Queue 4.0 est une version mineure visant essentiellement à prendre en charge Application Server 9 PE. Elle comprend de nouvelles fonctions, des améliorations de fonctions et des corrections de bogues. Cette section inclut une description des nouvelles fonctions de cette version :

• Prise en charge de l'API d'administration JMX

• Journalisation à l'exécution client

• API de notification des événements de connexion

• Améliorations de l'administration du courtier

• Affichage des informations concernant le magasin de données basé sur JDBC

• Prise en charge du fournisseur JDBC

• Modifications du format du magasin de données persistant

• Propriétés supplémentaires des messages

• Prise en charge de SSL

Parmi les modifications mineures mais radicales de la version 4.0, on peut souligner la désapprobation de l'option de ligne de commande pour spécifier un mot de passe. Désormais, vous devez stocker tous les mots de passe dans un fichier, comme décrit dans Option de mot de passe désapprouvée ou les saisir lorsque vous y êtes invité.

Prise en charge de l'API d'administration JMX

Une nouvelle API a été ajoutée dans Message Queue 4.0 pour la configuration et le contrôle des courtiers Message Queue conformément à la spécification Java Management Extensions (JMX). A l'aide de cette API, vous pouvez configurer et contrôler les fonctions de courtier, à l'aide de programmes, depuis une application Java. Dans les anciennes versions de Message Queue, ces fonctions étaient uniquement accessibles à partir des utilitaires d'administration de la ligne de commande ou de la console d'administration.

Pour de plus amples informations, reportez-vous au Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients.

Journalisation à l'exécution client

Message Queue 4.0 a introduit la prise en charge de la journalisation de l'exécution du client des événements liés aux connexions et aux sessions.

Pour obtenir des informations sur la journalisation de l'exécution client et la façon de la configurer, reportez-vous au Java Dev Guide page 137.

API de notification des événements de connexion

Message Queue 4.0 a introduit un API de notification des événements qui permet l'exécution du client pour informer une application des changements dans l'état de connexion. Les notifications d'événements de connexion permettent à un client Message Queue d'écouter les événements de fermeture et de reconnexion et d'entreprendre l'action appropriée selon le type de notification et l'état de connexion. Par exemple, lorsqu'un basculement se produit et que le client est reconnecté à un autre courtier, une application peut vouloir nettoyer l'état de transaction correspondant et utiliser une nouvelle transaction.

Pour obtenir des informations sur les événements de connexion et la façon de créer un listener d'événements, reportez-vous au Guide Java Dev, page 96.

Améliorations de l'administration du courtier

Dans Message Queue 4.0, une nouvelle sous-commande et plusieurs options de commande ont été ajoutées à l'utilitaire de Commande (imqcmd) pour permettre aux administrateurs de mettre en attente un courtier, de fermer un courtier après un intervalle spécifié, de détruire une connexion ou de paramétrer les propriétés du système java (par exemple, les propriétés liées à la connexion).

• La mise en attente du courtier place ce dernier dans un état silencieux, permettant ainsi une purge des messages avant la fermeture ou le redémarrage de celui-ci. Il est impossible de créer une nouvelle connexion vers un courtier mis en attente. Pour mettre le courtier en attente, saisissez une commande similaire à l'exemple suivant.

  imqcmd quiesce bkr -b Wolfgang:1756

• Pour fermer le courtier après un intervalle spécifié, saisissez une commande similaire à l'exemple ci-dessous. (L'intervalle de temps spécifie le nombre de secondes à attendre avant la fermeture du courtier.)

  imqcmd shutdown bkr -b Hastings:1066 -time 90

  Si vous spécifiez un intervalle de temps, le courtier journalisera un message indiquant l'heure de fermeture. Par exemple :

  Fermeture du courtier dans 29 secondes (29996 millisecondes)

  Alors que le courtier est en attente de fermeture, son comportement est affecté de diverses manières :

  • Les connexions JMS administratives sont encore acceptées.

  • Aucune nouvelle connexion JMS n'est acceptée.

  • Les connexions JMS existantes continuent de fonctionner.

  • Le courtier n'est pas en mesure de remplacer un autre courtier dans un cluster de courtiers améliorés.

  • L'utilitaire imqcmd ne s'interrompt pas, il envoie la requête de fermeture au courtier et reprend directement une activité normale.

• Pour détruire une connexion, saisissez une commande similaire à l'exemple suivant.

  imqcmd destroy cxn -n 2691475382197166336

  Utilisez la commande imqcmd list cxn ou imqcmd query cxn pour obtenir l'ID de connexion.

• Pour définir une propriété système à l'aide de imqcmd, utilisez l'option -D. Ceci s'avère pratique pour définir ou ignorer des propriétés de fabrique de connexion JMS ou des propriétés système Java liées à la connexion. Exemple :

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

Pour de plus amples informations sur la syntaxe de la commande imqcmd, reportez-vous au Chapitre 16, Command Line Reference du Sun GlassFish Message Queue 4.4 Administration Guide.

Affichage des informations concernant le magasin de données basé sur JDBC

Dans Message Queue 4.0, une nouvelle sous-commande de requête a été ajoutée à l'utilitaire du Gestionnaire de base de données, imqdbmgr. Cette sous-commande est utilisée pour afficher les informations relatives au magasin de données basé sur JDBC persistant, notamment la version de la base de données, l'utilisateur de la base de données et la création ou non de tables de base de données.

Voici un exemple des informations affichées par la commande.

imqdbmgr query

[04/Oct/2005:15:30:20 PDT] Using plugged-in persistent store:
        version=400
        brokerid=Mozart1756
        database connection url=jdbc:oracle:thin:@Xhome:1521:mqdb
        database user=scott
Running in standalone mode.
Database tables have already been created.

Prise en charge du fournisseur JDBC

Dans Message Queue 4.0, Apache Derby Version 10.1.1 est désormais pris en charge comme fournisseur de magasin de données basé sur JDBC.

Modifications du format du magasin de données persistant

Message Queue 4.0 a introduit des modifications au magasin de données basé sur JDBC à des fins d'optimisation et pour prendre en charge des améliorations futures. Pour cette raison, le format du magasin de données JDBC est passé à la version 400. Notez que dans Message Queue 4.0, la version du magasin de données basé sur les fichiers reste la version 370 car elle n'a subi aucune modification.

Propriétés supplémentaires des messages

Message Queue 4.0 a ajouté deux nouvelles propriétés paramétrées sur tous les messages placés dans la file d'attente bloquée.

• JMS_SUN_DMQ_PRODUCING_BROKER indique le courtier dans lequel le message a été créé.

• JMS_SUN_DMQ_DEAD_BROKER indique le courtier ayant marqué le message comme bloqué.

Prise en charge de SSL

À partir de Message Queue 4.0, la valeur par défaut pour la propriété de fabrique de connexion des clients imqSSLIsHostTrusted est false. Si votre application est basée sur la valeur par défaut précédente true, vous devez reconfigurer et définir explicitement la propriété sur true.

Vous pouvez choisir de faire confiance à l'hôte lorsque le courtier est configuré pour utiliser des certificats autosignés. Dans ce cas, en plus d'indiquer que la connexion doit utiliser un service de connexions SSL (à l'aide de la propriété imqConnectionType), vous devez définir la propriété imqSSLIsHostTrusted sur true.

Par exemple, pour exécuter de manière sécurisée les applications clientes lorsque le courtier utilise des certificats autosignés, utilisez une commande similaire à l'exemple suivant.

java -DimqConnectionType=TLS 
      -DimqSSLIsHostTrusted=true ClientAppName

Pour utiliser l'utilitaire de Commande (imqcmd) de façon sécurisée lorsque le courtier utilise des certificats auto-signés, utilisez une commande semblable à l'une des commandes suivantes (pour répertorier les services de connecteur).

imqcmd list svc -secure -DimqSSLIsHostTrusted=true

Fonctions qui seront désapprouvées dans les versions futures

Les fonctions suivantes seront désapprouvées dans une version ultérieure :

• Surveillance basée sur les messages

  La surveillance basée sur les messages utilise le producteur de messages métriques configurable du courtier pour écrire des données métriques dans des messages JMS envoyés aux destinations de sujets métriques, selon le type d'informations métriques contenues dans les messages. Il est ensuite possible d'accéder à ces informations métriques en écrivant une application client qui souscrit à la destination de sujet métrique appropriée, consomme ses messages et traite les données à volonté.

  La fonction de surveillance basée sur les messages a été supplantée par l'API d'administration JMX implémentée dans MQ 4.0 (reportez-vous à la section Prise en charge de l'API d'administration JMX). L'API de JMX API est plus complet (il comprend plus de données métriques que dans les destinations de sujet) et est basé sur le standard industriel JMX.

  Il n'existe plus de raison valable d'utiliser une surveillance basée sur les messages maintenant que Message Queue prend en charge l'API JMX. Les informations concernant la surveillance basée sur les messages restera dans la documentation de Message Queue jusqu'à ce que la fonction soit formellement désapprouvée.

• Programme d'installation en mode texte

  Le mode texte du programme d'installation de Message Queue (installer -t) sera supprimé sur toutes les plates-formes de système d'exploitation. En mode texte, le texte simple s'affiche dans la fenêtre du terminal pour simuler l'apparence du mode d'interface graphique (IG). Le mode IG et le mode silencieux seront toujours pris en charge.

• Plates-formes prises en charge

  Windows 2000 et Red Hat Linux 3 ne seront plus pris en charge dans les versions futures.

• Adaptateur de ressources JMSRA

  L'adaptateur de ressources de Message Queue, imqjmsra.rar, généralement référencé comme JMSRA, sera remplacé dans une version future de Message Queue par un nouvel adaptateur de ressources. JMSRA est utilisé pour intégrer Message Queue au serveur Sun Java System Application Server.

  Le nouvel adaptateur de ressources, qui va combiner les fonctions existantes de JMSRA avec les fonctions d'autres adaptateurs de ressources JMS Sun, fourniront une prise en charge spécialisée pour Message Queue, ainsi que d'autres fournisseurs, dans un environnement de serveur Java EE 5 Application Server. À ce titre, elle sera utilisée pour intégrer Message Queue à un serveur Sun GlassFish Enterprise Server et à la suite Sun Java Application Composite Platform Suite (Java CAPS).

Bogues résolus dans Message Queue 4.4 et ses versions récentes

Message Queue 4.4 inclut de nouveaux correctifs de bogues et intègre également les bogues qui ont été résolus dans les versions précédentes de la famille Message Queue 4.x.

Les sections suivantes dressent par version la liste des bogues résolus :

• Bogues résolus dans Message Queue 4.4

• Bogues résolus dans Message Queue 4.3

• Bogues résolus dans Message Queue 4.2

• Bogues résolus dans Message Queue 4.1

• Bogues résolus dans Message Queue 4.0

Bogues résolus dans Message Queue 4.4

Le tableau suivant décrit les bogues résolus dans Message Queue.

Bogues résolus dans Message Queue 4.3

Le tableau suivant décrit les bogues résolus dans Message Queue 4.3.

Bogues résolus dans Message Queue 4.2

Le tableau suivant décrit les bogues résolus dans Message Queue 4.2.

Bogues résolus dans Message Queue 4.1

Le tableau suivant décrit les bogues résolus dans Message Queue 4.1.

Bogues résolus dans Message Queue 4.0

Le tableau suivant décrit les bogues résolus dans Message Queue 4.0.

Mises à jour de la documentation relative à Message Queue 4.4

Cette section contient des informations sur les mises à jour de la documentation de Message Queue 4.4 :

• Problèmes de compatibilité

• Modifications dans le jeu de documentation de Message Queue 4.4

Problèmes de compatibilité

Cette section décrit les problèmes de compatibilité concernant Message Queue 4.4.

Stabilité de l'interface

Sun GlassFish Message Queue utilise de nombreuses interfaces pouvant être modifiées dans le temps. L'Annexe B, Stability of Message Queue Interfaces du Sun GlassFish Message Queue 4.4 Administration Guide classe les interfaces selon leur stabilité. Plus l'interface est stable, plus il y a de chances pour qu'elle ne soit pas modifiée dans les versions à venir d'un produit.

Problèmes liés à la prochaine version principale de Message Queue

La prochaine version principale de Message Queue pourrait introduire des changements la rendant incompatible avec des applications actuelles de Message Queue. Ces informations sont fournies dans l'intérêt d'une publication extensive.

• L'emplacement des fichiers individuels installés pour Sun GlassFish Message Queue peut changer. Cette modification risque de briser les applications existantes qui dépendent de l'emplacement actuel de certains fichiers de Message Queue.

• Il se peut que les courtiers Message Queue 3.5 et antérieurs ne puissent pas fonctionner dans un cluster hébergeant des courtiers plus récents.

• Dans les prochaines versions, il est possible que les clients Message Queue ne puissent plus utiliser les versions JDK antérieures à 1.5.

• Dans les prochaines versions, il est possible que les clients Message Queue ne puissent plus utiliser les versions JDK antérieures à la version 1.6.

Modifications dans le jeu de documentation de Message Queue 4.4

Le jeu de documentation de Message Queue 4.4 comprend des mises à jour du jeu de documentation de Message Queue 4.3, comme décrit ci-dessous :

Présentation technique

Le document Sun GlassFish Message Queue 4.4 Technical Overview reflète les nouvelles fonctions de Message Queue 4.4.

Informations d'installation et de mise à niveau

Le Sun GlassFish Message Queue 4.4 Installation Guide inclut l'installation de Message Queue sur la plate-forme AIX.

Guide d'administration

Le Sun GlassFish Message Queue 4.4 Administration Guide inclut des correctifs de bogues mineurs, la prise en charge de la plate-forme AIX et les procédures révisées de gestion des clusters de courtiers et de conversion de clusters conventionnels en clusters améliorés.

Guide du développeur pour Clients Java

Le Sun GlassFish Message Queue 4.4 Developer’s Guide for Java Clients reflète les nouveaux numéros de version, mais il s'agit de la seule modification.

Guide du développeur pour Clients C

Le Sun GlassFish Message Queue 4.4 Developer’s Guide for C Clients contient des informations sur la construction d'applications clientes C sur la plate-forme AIX.

Guide du développeur pour Clients JMX

Le Sun GlassFish Message Queue 4.4 Developer’s Guide for JMX Clients apporte des améliorations dans l'API JMX.

Problèmes connus et restrictions

Cette section contient une liste des problèmes connus concernant Message Queue 4.4. Les domaines suivants du produit sont abordés :

• Problèmes d'installation

• Option de mot de passe désapprouvée

• Problèmes d'administration/de configuration

• Problèmes relatifs au courtier

• Clusters de courtiers

• Problèmes relatifs à JMX

• Prise en charge de SOAP

Pour obtenir une liste des bogues actuels, de leur état et de leurs solutions, les membres de Java Developer Connection™ peuvent consulter la « Bug Parade » sur le site Web de Java Developer Connection. Avant de signaler tout nouveau bogue, merci de consulter cette page. Bien que tous les bogues de Message Queue n'y soient pas répertoriés, il est préférable ce consulter cette page pour savoir si un problème a déjà été signalé.

http://bugs.sun.com/bugdatabase/index.jsp

L'adhésion à Java Developer Connection est gratuite, mais elle requiert une inscription. Pour savoir comment devenir membre de Java Developer Connection, consultez la page Web « For Developers » de Sun .

Pour signaler un nouveau bogue ou soumettre une demande d'amélioration, envoyez un e-mail à l'adresse suivante : imq-feedback@sun.com .

Problèmes d'installation

Cette section décrit les problèmes liés à l'installation de Message Queue version 4.4.

Enregistrement du produit et Java ES

Message Queue 4.4, tout comme Message Queue 4.2 et 4.1, est installé par un programme d'installation relativement nouveau qui installe et met à niveau les composants partagés de Java Enterprise System (Java ES) requis par Message Queue ; par exemple, JDK, NSS, JavaHelp, etc.

Le nouveau programme d'installation Message Queue et l'ancien programme d'installation de Java ES utilisé pour installer les versions précédentes de Message Queue, ne partagent pas le même registre de produit. Si une version de Message Queue, précédemment installée avec Java ES, est supprimée, puis que Message Queue 4.4 est installé via le programme d'installation de Message Queue, le registre de produit Java ES peut alors se trouver dans un état incohérent. Ainsi, si le programme de désinstallation de Java ES est exécuté, il est possible qu'il supprime par accident Message Queue 4.4 et les composants partagés dont il dépend, même s'il ne les a pas installés.

Le meilleur moyen de mettre à niveau le logiciel Message Queue installé par le programme d'installation de Java ES est de :

1. Supprimer Message Queue et ses composants partagés avec le programme de désinstallation de Java ES.

2. Installer le programme d'installation de Message Queue pour installer Message Queue 4.4.

Installation sur toutes les plates-formes

Ces problèmes affectent le processus d'installation sur toutes les plates-formes.

• L'écran Prêt à installer affiche le nom du produit comme « mq » plutôt que comme Sun Java System Message Queue 4.3. (Bogue 6650841)

• Lorsque le programme d'installation est en cours d'exécution pour l'installation de Message Queue 4.3 et que l'écran de progression est affiché, le bouton Annuler est actif. Si vous sélectionnez ce bouton à ce stade, l'installation sera incomplète ou endommagée. (Bogue 6595578)

• L'écran de synthèse du programme d'installation contient certains liens qui, lorsque vous cliquez dessus, lancent un visualiseur de page de synthèse ou de journal. Si vous fermez la fenêtre du visualiseur en utilisant le bouton « X » au lieu du bouton Fermer, il sera alors impossible de la faire réapparaître. (Bogue 6587138)

  Solution : utilisez le bouton Fermer pour fermer la fenêtre.

• Lorsqu'un système dispose d'anciennes versions de Message Queue et de NSS/NSPR, l'écran de mise à niveau du programme d'installation signale uniquement que Message Queue a besoin d'une mise à niveau ; il n'est pas mentionné que NSS/NSPR doivent être mis à niveau également. Tous les logiciels pertinents seront néanmoins mis à niveau (comme indiqué par l'écran Prêt à installer qui affiche les informations correctes). (Bogue 6580696)

• La liste des JDK sur l'écran de sélection JDK est active même lorsque l'option “Choisir un JDK” n'est pas sélectionnée. (Bogue 6650874)

• Lors de l'utilisation du programme de désinstallation de Message Queue, si vous cliquez sur Annuler au lieu de Supprimer, certains fichiers du programme d'installation seront tout de même supprimés et les futures désinstallations échoueront. (Bogue 6760416)

• L'exécution du programme d'installation en mode d'enregistrement seul (installer -r) après avoir effectué une installation en mode silencieux au cours de laquelle l'enregistrement a été ignoré entraîne un échec de l'enregistrement avec une erreur « Fin prématurée de fichier ». (Bogue 6767988)

• Lorsque vous exécutez le programme d'installation de Message Queue 4.3 sur un ordinateur sur lequel Open Message Queue a été précédemment installé, il est possible que vous voyiez le message d'avertissement suivant : « Erreur lors de la lecture des données de la session précédente à partir de Config-State ». (Bogue 6764305)

  Solution : le message n'est pas important et ne sera pas reproduit une fois l'installation terminée. Ou vous pouvez supprimer le fichier /var/install/config/mq/InstallDirectory.xcu afin d'éviter les messages.

• Lors de l'exécution du programme d'installation basé sur un zip de Message Queue sur un ordinateur sur lequel le JDK n'est pas installé, le message d'erreur suivant s'affiche : « Racine incorrecte dans la clé de registre HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\CurrentVersion ». (Bogue 6764358)

  Solution : installez le JDK avant de lancer le programme d'installation.

• Le répertoire mqInstallHome est créé par le programme d'installation de Message Queue avant que vous ne cliquiez sur le bouton Installer sur l'écran Prêt pour l'installation. (Bogue 6595590)

• La tentative d'enregistrement de Message Queue en mode texte (installer -t -r) sans avoir installé Message Queue renvoit une exception NullPtr. (Bogue 6760991)

  Solution : installez Message Queue avant de tenter d'enregistrer l'installation.

Installation sous Windows

Lorsque vous installez Message Queue sous Windows, veuillez prendre en compte les limitations suivantes.

• La structure de répertoires installée de Message Queue 4.3 sur la plate-forme Windows est différente de celle des versions précédentes. Reportez-vous à la section Installed Directory Structure du Sun GlassFish Message Queue 4.4 Installation Guide.

• Le programme d'installation n'ajoute pas d'entrées pour Message Queue dans le menu Démarrer >Programmes. (Bogue 6567258)

  Solution : pour démarrer la console d'administration, utilisez la ligne de commande comme décrit à la section Starting the Administration Console du Sun GlassFish Message Queue 4.4 Administration Guide.

• Le programme d'installation n'ajoute pas le répertoire IMQ_HOME\mq\bin à la variable d'environnement PATH.(Bogue 6567197)

  Solution : les utilisateurs doivent ajouter cette entrée à leur variable d'environnement PATH ou fournir un nom de chemin complet lorsqu'ils invoquent les utilitaires de Message Queue (IMQ_HOME\mq\bin\ commande).

• Le programme d'installation n'ajoute pas d'entrée dans le registre Windows pour indiquer que Message Queue a été installé. (Bogue 6586389)

• Le programme d'installation n'ajoute pas le courtier de Message Queue en tant que service Windows.

  Solution : ajoutez manuellement le courtier de Message Queue en tant que service Windows à l'aide de la commande imqsvcadm.

• Si le JDK n'est pas installé, le programme d'installation renvoie l'erreur suivante : « Racine incorrecte dans la clé de registre HKLM\\SOFTWARE\\JavaSoft\\Java Runtime Environment\\CurrentVersion ». (Bogue 6764358)\par

  Solution : si cette erreur s'affiche, installez un JDK et poursuivez.

• Lorsqu'il est exécuté en mode silencieux avec un fichier de réponse, le programme d'installation réapparait immédiatement. L'installation s'effectue mais l'utilisateur n'a pas la possibilité de savoir quand l'installation en mode silencieux est réellement exécutée. (Bogue 6586560)

• Toute tentative d'exécuter le programme d'installation en mode texte (installer –t ) sur Windows provoque un message d'erreur qui s'affiche en anglais même si le programme d'installation est exécuté dans une autre langue que l'anglais. Le mode texte n'est pas pris en charge sous Windows. (Bogue 6594142)

• Le programme d'installation installe Message Queue sur C :\ même si le système d'exploitation est installé sur un autre lecteur. (Bogue 6673511)

• Pour l'installation et la désinstallation sous Windows, il n'existe aucun fichier .bat que l'utilisateur puisse exécuter, et celui-ci ne peut pas non plus effectuer une désinstallation par le biais de Ajouter/Supprimer des programmes dans le panneau de configuration de Windows. (Bogue 6673417)

• Sous Windows Vista, vous ne pouvez pas installer Message Queue sous C:\Program Files, sauf si vous procédez à l'installation à partir d'une invite de commande en tant qu'administrateur. (Bogue 6701661)

  Solution : pour installer à partir de l'invite de commande en tant qu'administrateur :

  1. Démarrer->Programmes->Accessoires->Invite de commande.

  2. Cliquez avec le bouton droit sur l'invite de commande.

  3. Sélectionnez Exécuter en tant qu'administrateur.

  4. Changez le répertoire vers l'image d'installation de Message Queue 4.2.

  5. Exécutez installer.vbs.

• Lorsque le programme de désinstallation est exécuté en mode de simulation (uninstaller -n), il exécute de façon incorrecte une désinstallation. (Bogue 6719051)

  Solution : exécutez une installation silencieuse à l'aide de la commande suivante :

  uninstaller -s

• La chaîne “Install Home” sur la page d'accueil du programme d'installation n'est pas localisée. (Bogue 6592491)

• Le programme de désinstallation basé sur un zip de Message Queue se bloque sous Windows 2003. (Bogue 6764370)

  Solution : supprimez manuellement le répertoire mqInstallHome.

Installation sous Solaris

• Lorsque le programme d'installation est exécuté en mode de simulation (installer –n ), l'écran de synthèse affiche des messages d'erreur, ainsi qu'un état d'installation « Incomplet ». Cela est incorrect et peut prêter à confusion ; l'installation en mode de simulation n'installe aucun élément sur le système mais crée uniquement un fichier de réponse qui peut être utilisé par la suite pour exécuter l'installation silencieuse. (Bogue 6594351)

• Le programme d'installation n'exécute pas l'enregistrement Sun Connection lorsque l'exécution se fait en mode silencieux avec un fichier de réponse (installer -a filename -s). (Bogue 6710268)

• Lors de l'exécution du programme d'installation en mode texte, et lors de la saisie d'un nom d'utilisateur ou d'un mot de passe pour l'enregistrement à Sun Connect ou la création d'un compte en ligne, vous ne pouvez pas corriger ces entrées avec la touche d'effacement arrière. (Bogue 6673460)

  Solution : utilisez les touches Control-H au lieu de la touche d'effacement arrière, ou utilisez un émulateur de terminal différent comme dtterm ou xterm.

• L'écran de mise à niveau du programme d'installation ne rapporte pas toujours correctement la version installée existante de Message Queue ou du moteur du programme d'installation. (Bogue 6679765)

• Lors de l'utilisation du programme d'installation en mode texte et de la tentative d'enregistrement de Sun Connection avec un nom d'utilisateur et un mot de passe invalides, le programme d'installation affiche « enregistrement impossible », envoie une exception de pointeur null et se ferme. (Bogue 6666365)

Installation sous Linux

Les problèmes suivants affectent le processus d'installation sur une plate-forme Linux :

• Sous Redhat Linux 5, la bibliothèque compat-libstdc++ nécessaire à l'exécution des applications clientes C n'est pas incluse dans la distribution de Message Queue et n'est donc n'est pas installée par le programme d'installation de Message Queue. Si vous développez et exécutez des clients C, vous devez installer cette bibliothèque manuellement.

  Le rpm compat-libstdc++ se trouve généralement sur le support d'installation de la version Linux que vous utilisez. Elle peut être installée à l'aide de la commande suivante :

  rpm -ivh compat-libstdc++-x-x.x.x.x..rpm

  où x représente le numéro de version.

  Pour vérifier que la bibliothèque a bien été installée, utilisez la commande suivante :

  rpm -qa | grep compat-libstdc++

• Sur le panneau de sélection du JDK, la liste déroulante n'affiche qu'un seul élément. Il est donc difficile de sélectionner tout autre JDK dans la liste. (Bogue 6584735)

• Si le JDK est actif et que l'utilisateur sélectionne « Installer le JDK par défaut » sur l'écran de sélection du JDK, le programme d'installation tente toujours de l'installer et signale qu'il n'est pas en mesure d'installer le package. L'installation se termine correctement malgré ce problème. (Bogue 6581310)

• Si la version de JDK actuellement installée est ultérieure à JDK 1.5.0_15 (la version installée normalement par le programme d'installation Message Queue), alors le programme de désinstallation de Message Queue ne peut pas trouver le répertoire par défaut IMQ_JAVAHOME et renvoie une erreur. (Bogue 6673415)

  Solution : installez JDK 1.5 manuellement comme suit avant d'exécuter le programme de désinstallation de Message Queue.

  # cd installImage/Product/UNIX/LINUX/X86/2.4/Packages

  # rpm -i --force jdk-1.5.0_15–linux- arch.rpm

  où arch est soit i586 soit amd64.

• Lorsque le programme d'installation est exécuté en mode de simulation (installer –n ), l'écran de synthèse affiche des messages d'erreur, ainsi qu'un état d'installation « Incomplet ». Cela est incorrect et peut prêter à confusion ; l'installation en mode de simulation n'installe aucun élément sur le système mais crée uniquement un fichier de réponse qui peut être utilisé par la suite pour exécuter l'installation silencieuse. (Bogue 6594351)

• L'exécution du programme d'installation de Message Queue en mode texte sous Linux 64 bits ne fonctionne pas. (Bogue 6771303)

  Solution : si vous essayez de procéder à l'installation à distance à partir d'une fenêtre de terminal, vous devrez utiliser certains logiciels d'affichage distant pour exécuter le programme d'installation en mode IG à la place.

Anomalies de version dans le programme d'installation

Le programme d'installation affiche en opaque les informations de version de Message Queue. (Bogue 6586507)

Plate-forme Solaris

Sur la plate-forme Solaris, reportez-vous au tableau suivant pour déterminer la version de Message Queue affichée par le programme d'installation.

Pour les versions de patch jusqu'au 3.6 SP4 (par exemple, 3.6 SP4 Patch 1), la chaîne de version affichée par le programme d'installation reste la même. Vous devez exécuter la commande imqbrokerd –version pour déterminer la version exacte.

Plate-forme Linux

Sur la plate-forme Linux, le numéro de version affiché par le programme d'installation se fait sous la forme suivante.

majorReleaseNumber.minorReleaseNumber-someNumber

Par exemple, 3.7–22. Ce numéro signale uniquement qu'il s'agit de l'une des versions 3.7 sans spécifier laquelle. Pour déterminer la version Message Queue installée, exécutez la commande :

imqbrokerd -version.

Problèmes liés à la localisation

Les bogues suivants sont liés aux problèmes de localisation.

• Lorsque le programme d'installation est exécuté en mode texte (installer –t ), dans une langue non anglaise, les caractères multi-octets apparaissent corrompus. (Bogue 6586923)

• Sur l'écran de progression de l'installation, la barre de progression affiche des caractères inconnus. L'infobulle est codée en dur pour les langues non anglaises. (Bogue 6591632)

• Le mode Texte (installer –t) n'est pas pris en charge sous Windows. L'exécution du programme d'installation en mode texte, sous Windows, entraîne l'affichage d'un message d'erreur. Ce message n'est pas localisé lorsque le programme d'installation est exécuté en langues non anglaises. (Bogue 6594142)

• L'écran relatif à la licence du programme d'installation affiche le texte correspondant en anglais, quelle que soit la langue d'exécution du programme. (Bogue 6592399)

  Solution : pour accéder aux fichiers de licence localisés, consultez le fichier LICENSE_MULTILANGUAGE.pdf.

• L'aide relative à l'utilisation du programme d'installation n'est pas localisée. (Bogue 6592493)

• La chaîne « None » apparaissant sur la page HTML de synthèse du programme d'installation est codée en dur en anglais. (Bogue 6593089)

• Lorsque le programme d'installation est exécuté dans un environnement linguistique allemand, l'écran d'accueil n'affiche pas le texte complet qui apparaît pour les autres langues. (Bogue 6592666)

• La chaîne « Install Home » apparaissant sur la page d'accueil de l'installation n'est pas localisée. Elle s'affiche en anglais même si le programme d'installation est exécuté en langues non anglaises. (Bogue 6592491)

• Lorsque le programme d'installation est exécuté en mode texte (installer –t ), les choix de réponse en anglais « Yes » et « No » sont utilisés quelle que soit la langue d'exécution choisie. (Bogue 6593230)

• L'infobulle du bouton Parcourir à l'écran de sélection du JDK est codée en dur en anglais. (Bogue 6593085)

Option de mot de passe désapprouvée

Dans les versions précédentes de Message Queue, vous aviez la possibilité d'utiliser l'option —p ou —password pour spécifier un mot de passe, de manière interactive, pour les commandes suivantes : imqcmd, imqbrokerd et imdbmgr. À partir de la version 4.0, ces options ont été désapprouvées.

À la place, vous pouvez créer un fichier de mots de passe spécifiant les mots de passe pertinents et référencer le fichier de mots de passe à l'aide de l'option de commande -passfile, ou saisir simplement un mot de passe lorsque vous y êtes invité par la commande.

Un fichier de mots de passe peut contenir un ou plusieurs des mots de passe énumérés ci-dessous :

• Un mot de passe de keystore utilisé pour ouvrir le keystore SSL. Utilisez la propriété imq.keystore.password pour spécifier ce mot de passe.

• Un mot de passe de référentiel LDAP utilisé pour se connecter, de manière sécurisée, à l'aide d'un répertoire LDAP si la connexion n'est pas anonyme. Utilisez la propriété imq.user_repository.ldap.password pour spécifier ce mot de passe.

• Un mot de passe de base de données JDBC utilisé pour se connecter à une base de données compatible JDBC. Utilisez la propriété imq.persist.jdbc.vendorName.password pour spécifier ce mot de passe. Le composant nomFournisseur du nom de la propriété est une variable spécifiant le fournisseur de la base de données. Vous avez le choix entre hadb, derby, pointbase, oracle ou mysql.

• Un mot de passe pour la commande imqcmd (en vue d'effectuer des tâches d'administration du courtier). Utilisez la propriété imq.imqcmd.password pour spécifier ce mot de passe.

Dans l'exemple suivant, le mot de passe pour la base de données JDBC est défini dans le fichier mots de passe sur abracadabra.

imq.persist.jdbc.mysql.password=abracadabra

Vous pouvez utiliser un fichier de mots de passe de l'une des façons suivantes.

• Configurez le courtier pour utiliser le fichier de mots de passe en paramétrant les propriétés suivantes dans son fichier config.properties.

  imq.passfile.enabled=trueimq.passfile.dirpath= passwordFileDirectory imq.passfile.name=passwordFileName

• Utilisez l'option -passfile de la commande pertinente, par exemple :

  imqbrokerd -passfile passwordFileName

Problèmes d'administration/de configuration

Les problèmes suivants sont liés à l'administration et à la configuration de Message Queue

• Sur les plates-formes Windows, vous devez ajouter manuellement le courtier de Message Queue en tant que service Windows à l'aide de la commande imqsvcadm. Le programme d'installation n'effectue pas cela pour vous.

• Sur les plates-formes Windows, le pare-feu Windows intégré, activé par défaut, doit être configuré manuellement avec une règle de pare-feu qui permet au courtier d'accepter les connexions entrantes des clients. (Bogue 6675595)

  1. Double-cliquez sur le pare-feu Windows dans le panneau de configuration

     Cliquez sur Continuer dans la boîte de dialogue de configuration du compte utilisateur pour ouvrir la boîte de dialogue Paramétrage du pare-feu Windows.

  2. Dans la boîte de dialogue de paramétrage du pare-feu Windows, cliquez sur l'onglet Exceptions.

  3. Cliquer sur Ajouter un programme.

  4. Dans la boîte de dialogue Ajouter un programme, sélectionnez java.exe et cliquez sur Naviguer.

     Windows identifie le processus de courtier comme système binaire de Java Platform SE. Par conséquent, localisez java.exe utilisé par le courtier (habituellement sur jdk1.5.0_15\jre\bin\java.exe).

  5. Cliquez sur Changement de portée.

  6. Dans la boîte de dialogue Changement de portée, sélectionnez « Tout ordinateur (y compris ceux situés sur Internet. »

  7. Cliquez sur OK.

  8. Dans la boîte de dialogue Ajouter un programme, cliquez sur OK.

  9. Dans la boîte de dialogue Paramétrer le pare-feu Windows, cliquez sur OK.

• Sur les plates-formes Windows, les commandes imqadmin et imqobjmgr envoient une erreur lorsque CLASSPATH contient des guillemets. (Bogue 5060769)

  Solution : ouvrez une fenêtre d'invite de commande et désactivez CLASSPATH :

  set classpath=

  Exécutez ensuite la commande souhaitée, la même fenêtre d'invite de commande, par exemple :

  mqInstallHome\mq\bin\imqadmin

• L'option -javahome dans tous les scripts Solaris et Windows ne fonctionne pas si la valeur fournie contient un espace. (Bogue 4683029)

  L'option javahome est utilisée par les commandes et utilitaires de Message Queue pour spécifier une autre exécution Java 2 compatible à utiliser. Cependant, le nom de chemin vers l'exécution Java alternative ne doit pas contenir d'espace. Voici quelques exemples de chemins contenant des espaces :

  Windows : C:\jdk 1.4

  Solaris : /work/java 1.4

  Solution : installez Java Runtime à un emplacement ou un chemin ne contenant pas d'espace.

• L'attribut imqQueueBrowserMaxMessagesPerRetrieve spécifie le nombre maximal de messages pouvant être récupérés en une seule fois par l'exécution client lors de la navigation dans une file d'attente. L'attribut affecte la façon dont les messages en file d'attente sont regroupés pour être délivrés à l'exécution client, mais cela n'affecte pas le nombre total de messages faisant l'objet de la navigation. L'attribut affecte uniquement le mécanisme de navigation, cela n'affecte pas la livraison de messages en file d'attente. (Bogue 6387631)

Problèmes relatifs au courtier

Les problèmes suivants concernent le courtier de Message Queue.

• Le courtier devient inaccessible lorsque le magasin de données persistant ouvre trop de destinations. (Bogue 4953354)

  Solution : ce problème est dû au fait que le courtier atteint la limite du descripteur de fichier ouvert définie pour le système. Sur Solaris et Linux, utilisez la commande ulimit pour augmenter cette limite.

• Les consommateurs sont orphelins lorsqu'une destination est supprimée. ( Bogue 5060787)

  Les consommateurs actifs sont orphelins lorsqu'une destination est supprimée. Une fois orphelins, ils ne peuvent plus recevoir de messages (même si la destination est recréée).

• Lorsqu'un client JMS utilisant le service de connexion HTTP met brutalement fin à la connexion (en utilisant, par exemple, Ctrl+C), le courtier met environ une minute avant de libérer la connexion client et toutes les ressources associées.

  Si une autre instance du client est démarrée dans la minute d'attente en essayant d'utiliser le même ID client, la même souscription durable ou file d'attente, il est possible que celle-ci reçoive une exception « L'ID client est déjà utilisé ». Il ne s' agit pas d'un vrai problème, mais d'un effet secondaire du processus de fin décrit précédemment. Si un client est démarré après un délai d'environ une minute, tout doit fonctionner correctement.

• Lors de l'utilisation d'une base de données MySQL pour un magasin de données, le stockage de messages supérieurs à 1 Mo envoie une exception SQL « Packet de requête trop grand ». (Bogue 6682815)

  Solution : démarrez le serveur MySQL avec l'option --max_allowed_packet paramétrée sur une valeur supérieure à 1 Mo par défaut. Par exemple, utilisez la valeur suivante :

  --max_allowed_packet=60M

• Lors de l'utilisation d'une base de données MySQL pour un magasin de données partagées hautement disponible, un mécanisme est nécessaire pour configurer le moteur de stockage de MySQL comme NDBCLUSTER . (Bogue 6691394)

  Solution : ajoutez la valeur de propriété suivante au fichier config.properties du courtier (voir la section Enhanced Clusters: JDBC Configuration Properties du Sun GlassFish Message Queue 4.4 Administration Guide).

  imq.persist.jdbc.mysql.tableoption=EMGINE=NDBCLUSTER

• Lors de l'utilisation du pilote 9i (JDBC 9.2.0.x) d'Oracle, le courtier renvoie une exception « Échec de persistance de la propriété... ». (Bogue 6626825)

  Solution : utilisez le pilote 10g (JDBC 10.2.0.x) d'Oracle, pour lequel le courtier est optimisé.

  imq.persist.jdbc.derby.table.MYCONSTATE41.index.IDX2=CREATE INDEX &(index) ON $(name) (MESSAAGE_ID)

• Lors de l'utilisation de la base de données Java DB pour un magasin de données, le stockage d'un message envoie une exception SQL « Verrouillage impossible à obtenir dans le délai requis ». (Bogue 6691394)

  Solution : ajoutez la valeur de propriété suivante au fichier config.properties du courtier :

  imq.persist.jdbc.derby.table.MYCONSTATE41.index.IDX2=CREATE INDEX &(index) ON $(name) (MESSAAGE_ID)

Clusters de courtiers

Les problèmes suivants affectent les clusters de courtiers.

• Seuls les clusters de courtiers complètement connectés sont pris en charge par cette version. Autrement dit, tous les courtiers d'un cluster doivent communiquer directement avec tous les autres. Si vous essayez de connecter les courtiers dans un cluster conventionnel à l'aide de l'argument de ligne de commande imqbrokerd -cluster, assurez-vous que tous les courtiers du cluster sont bien inclus.

• Si un client est connecté à un courtier dans un cluster de courtiers amélioré, l'exécution client tentera de se reconnecter jusqu'à ce qu'elle y parvienne (elle ignore la valeur de l'attribut de connexion par défaut imqAddressListIterations).

• Un client ne peut naviguer que dans les contenus des files d'attente situées sur le courtier qui l'héberge. Il peut toutefois continuer d'envoyer des messages vers les files d'attente ou de consommer les messages provenant des files d'attente sur n'importe quel courtier du cluster, la restriction ne s'appliquant qu'à la navigation.

• Dans un cluster conventionnel avec des courtiers de version 4.3, tous les courtiers doivent avoir la version 3.5 ou ultérieure.

• Les courtiers de Message Queue 4.1, 4.2 et 4.3 ne peuvent pas interopérer dans un cluster par défaut avec les courtiers de Message Queue 3.6 ou 3.7 car la valeur par défaut de imq.autocreate.queue.maxNumActiveConsumers a été modifiée entre ces versions. (Bogue 6716400)

  Solution : vérifiez que tous les courtiers ont la même valeur ou modifiez la valeur de imq.autocreate.file.maxNumActiveConsumers, généralement appliquée par la modification de la configuration de Message Queue 4.1, 4.2 et 4.3 afin de correspondre à celle utilisée par les courtiers de la version 3.6 ou 3.7 (par défaut, de la valeur de -1 à 1, valeur par défaut de la version précédente).

• Pour ajouter un courtier de Message Queue 4.3 (ou 4.x) à un cluster de courtiers de Message Queue 3.x, un courtier maître doit être en cours d'exécution. (Bogue 6763796)

• Lors de la conversion d'un cluster conventionnel en cluster amélioré, vous pouvez utiliser l'utilitaire de gestionnaire de bases de données de Message Queue (imqdbmgr ) pour convertir un magasin de données basé sur JDBC autonome existant en magasin de données basé sur JDBC partagé comme indiqué à la section Cluster Conversion: JDBC-Based Data Store du Sun GlassFish Message Queue 4.4 Administration Guide.

• Un courtier utilisant HADB ne peut pas gérer des messages supérieurs à 10 Mo. (Bogue 6531734)

• Ce processus de conversion, effectué à l'aide de la commande imqdbmgr upgrade hastore, peut échouer. Le message « nombre de verrous trop élevé » s'affiche si le magasin contient plus de 10 000 messages. (Bogue 6588856)

  Solution : utilisez la commande suivante pour augmenter le nombre de verrous.

  hadbm set NumberOfLocks=<desiredNumber>

  Pour de plus amples informations, reportez-vous à la section « HADB Problems » du Sun Java System Application Server 9.1 Enterprise Edition Troubleshooting Guide.

• Si plus de 500 messages distants sont validés dans une transaction, le courtier peut renvoyer l'erreur « HADB-E-12815 : espace de mémoire tableau épuisé ». (Bogue 6550483)

  Pour de plus amples informations, reportez-vous à la section « HADB Problems » du Sun Java System Application Server 9.1 Enterprise Edition Troubleshooting Guide.

• Dans un cluster de courtiers, un courtier place des messages en file d'attente sur une connexion distante qui n'a pas été initiée. (Bogue 4951010)

  Solution : le consommateur recevra les messages dès qu'il se connecte. Les messages seront renvoyés à un autre consommateur si la connexion du consommateur reste fermée.

• Lorsque plusieurs messages sont consommés à partir d'un courtier distant dans une transaction, il est possible que le message d'erreur suivant soit consigné vers le courtier. Celui-ci n'est pas important et peut donc être ignoré :

  [26/Jul/2007:13:18:27 PDT] WARNING [B2117]: 
  Message acknowledgement failed from 
  mq://129.145.130.95:7677/?instName=a&brokerSessionUID=3209681167602264320:
      ackStatus = NOT_FOUND(404)\
      Reason = Update remote transaction state to COMMITED(6): 
  transaction 3534784765719091968 not found, the transaction
  may have already been committed.
      AckType = MSG_CONSUMED
      MessageBrokerSession = 3209681167602264320
      TransactionID = 3534784765719091968
          SysMessageID = 8-129.145.130.95(95:fd:93:91:ec:a0)-33220-1185481094690
          ConsumerUID = 3534784765719133952\par
  
  [26/Jul/2007:13:18:27 PDT] WARNING Notify commit transaction 
  [8-129.145.130.95(95:fd:93:91:ec:a0)-33220-1185481094690, 
  [consumer:3534784765719133952, type=NONE]]
  TUID=3534784765719091968 got response: 
  com.sun.messaging.jmq.jmsserver.util.BrokerException:
   Update remote transaction state to COMMITED(6): 
    transaction 3534784765719091968 not found, the transaction may have already 
    been committed.:
  com.sun.messaging.jmq.jmsserver.util.BrokerException: Update remote transaction 
  state to COMMITED(6): transaction 3534784765719091968 not found, the transaction
   may have already been committed.r

  Ce message est consigné lors de la notification de validation au courtier de base du message pour les prochains messages de la transaction lorsque la valeur de la propriété imq.txn.reapLimit est faible par rapport au nombre de messages distants contenus dans une transaction. (Bogue 6585449)

  Solution : pour ne pas recevoir ce message, augmentez la valeur de la propriété imq.txn.reapLimit.

Problèmes relatifs à JMX

Sur les plates-formes Windows, la méthode getTransactionInfo du MBean de contrôle du gestionnaire de transactions renvoie des informations de transaction comportant des heures de création incorrectes. (Bogue 6393359)

Solution : utilisez plutôt la méthode getTransactionInfoByID du MBean de contrôle du gestionnaire de transactions.

Prise en charge de SOAP

Deux problèmes principaux à prendre en compte pour la prise en charge de SOAP.

• À partir de la version 4.0 de Message Queue, la prise en charge des objets administrés par SOAP a été interrompue.

• Le développement de SOAP dépend de plusieurs fichiers : SUNWjaf, SUNWjmail, SUNWxsrt et SUNWjaxp. Dans la version 4.1 de Message Queue, ces fichiers sont uniquement disponibles lorsque Message Queue est exécuté avec JDK version 1.6.0 ou version supérieure.

• Précédemment, l'implémentation de SAAJ 1.2 .jar référençait directement mail.jar. Dans SAAJ 1.3, cette référence a été supprimée ; par conséquent, les clients Message Queue doivent explicitement placer mail.jar dans CLASSPATH.

Fichiers redistribuables

Sun GlassFish Message Queue 4.4 contient l'ensemble de fichiers ci-dessous pouvant être utilisés et distribués librement sous forme binaire :

Vous pouvez également redistribuer les fichiers LICENSE et COPYRIGHT.

Accessibilité des personnes handicapées

Pour obtenir la liste des fonctions d'accessibilité mises à disposition depuis la publication de ce média, consultez les évaluations de produit de la Section 508, disponibles sur demande auprès de Sun, afin de déterminer les versions les mieux adaptées au déploiement des solutions accessibles. Des versions à jour des applications sont disponibles à l'adresse http://sun.com/software/javaenterprisesystem/get.html.

Pour obtenir des informations sur l'engagement de Sun en matière d'accessibilité, consultez la page Web http://sun.com/access.

Comment signaler des problèmes et apporter des commentaires

Si vous rencontrez des problèmes avec Sun GlassFish Message Queue, contactez le service clientèle Sun de l'une des manières suivantes :

• Services de support logiciel Sun en ligne disponibles à la page http://www.sun.com/service/sunone/software.

  Ce site est lié à la base de connaissances de Sun, au centre de support en ligne et à ProductTracker, de même qu’à des programmes de maintenance et des numéros d’assistance téléphonique.

• Le numéro de téléphone indiqué sur votre contrat de maintenance.

Afin que nous puissions vous aider au mieux à résoudre vos problèmes, munissez-vous des informations suivantes lorsque vous contactez le support :

• Description du problème, notamment les conditions dans lesquelles le problème se produit et sa répercussion sur l'opération effectuée.

• Le type de machine, les versions du système d'exploitation et du produit, y compris les patchs et autres logiciels pouvant avoir un lien avec le problème.

• Les étapes détaillées des méthodes utilisées pour reproduire le problème.

• Les journaux des erreurs ou core dumps éventuels.

Forum de Sun GlassFish

Accédez au forum de Sun GlassFish Message Queue à partir de l'adresse suivante :

http://swforum.sun.com/jive/forum.jspa?forumID=24

Votre participation est la bienvenue.

Forum sur la technologie Java

Il existe un forum JMS au sein des forums sur la technologie Java qui peut être utile.

http://forum.java.sun.com

Vos commentaires sont les bienvenus

Dans le souci d’améliorer notre documentation, nous vous invitons à nous faire parvenir vos commentaires et vos suggestions.

Pour nous faire part de vos commentaires, accédez au site http://docs.sun.com, puis cliquez sur Envoyer des commentaires. Dans le formulaire en ligne, indiquez le titre et le numéro de référence du document. La référence est un numéro composé de sept ou neuf chiffres figurant sur la page de garde du manuel ou en haut du document. Par exemple, le titre de ce document est Notes de version, et son numéro de référence est 821-0891-05.

Ressources Sun supplémentaires

Vous pouvez obtenir des informations utiles concernant Sun GlassFish sur les sites Internet suivants :

• Documentation

  http://docs.sun.com/prod/java.sys

• Services professionnels

  http://www.sun.com/service/sunps/sunone

• Produits et services logiciels

  http://www.sun.com/software

• Services de support logiciel

  http://www.sun.com/service/sunone/software

• Base de connaissances et support

  http://www.sun.com/service/support/software

• Services de support et de formation Sun

  http://training.sun.com

• Services professionnels et de conseil

  http://www.sun.com/service/sunps/sunone

• Informations pour les développeurs

  http://developers.sun.com

• Services de support pour les développeurs Sun

  http://www.sun.com/developers/support

• Formation sur les logiciels

  http://www.sun.com/software/training