Sun Java System Message Queue 3 2005Q4 Notes de version |
Sun Java System Message Queue Notes de version
Version 3 2005Q4 (3.6 SP3)
R�f�rence 819-3557
Ces notes de version contiennent des informations importantes connues au moment de la commercialisation de Sun Java System Message Queue 3 2005Q4 (3.6 SP3). Ce document inclut �galement le contenu des notes de version de Sun Java System Message Queue 3 2005Q1 (3.6) pour les clients qui effectuent une mise � niveau depuis des versions pr�c�dentes de Message Queue 3 2005Q1. Vous y trouverez des renseignements sur les nouvelles fonctionnalit�s, les am�liorations, les restrictions et probl�mes connus, etc. Prenez connaissance de ce document avant d’utiliser Message Queue.
Vous trouverez la derni�re version de ces notes de version sur le site Web de la documentation Sun Java System Message Queue � l’adresse : http://docs.sun.com/coll/1307.1. Consultez ce site Web avant d’installer et de configurer votre logiciel, puis 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 comprennent les sections suivantes :
Des adresses URL de sites tiers, qui renvoient � des informations compl�mentaires connexes, sont r�f�renc�es dans ce document.
Historique de r�vision des notes de version
Tableau 1 Historique de r�vision
Date
Description des modifications
26 ao�t 2005
- Mise � jour du document À propos de Message Queue 3 2005Q4 (3.6 SP3).
- Mise � jour du document Mises � jour de la documentation de Message Queue 3 2005Q4 (3.6 SP3)
- Mise � jour du document Configurations mat�rielle et logicielle requises pour Message Queue 2005Q4 (3.6 SP3).
- Ajout des bogues r�solus pour Message Queue 3 2005Q4 (3.6 SP3) dans le document Bogues r�solus dans la pr�sente version.
28 juin 2005
- Ajout des bogues r�solus pour Message Queue 3 2005Q1 (3.6 SP1) et Message Queue 32005Q4 (3.6 SP2) dans le document Bogues r�solus dans la pr�sente version.
1er mai 2005
- Mise � jour de la section Probl�mes relatifs � la prochaine version majeure de Message Queue.
- Ajout d’une instruction Stabilit� de l’interface dans la section Compatibilit�.
24 janvier 2005
Mise � jour avec la version finale de Sun Java System Message Queue 3 2005Q1 et Java Enterprise System 2005Q1.
8 novembre 2004
Premi�re version des Sun Java System Notes de version de Message Queue.
À propos de Message Queue 3 2005Q4 (3.6 SP3)Message Queue 3 2005Q4 (3.6 SP3) est une mise � jour des bogues r�solus de Message Queue 3 2005Q1 (3.6). Il contient toutes les r�solutions des versions 3.6 SP2 et 3.6 SP1, ainsi que des nouvelles mises � jour de la documentation.
Message Queue 3 2005Q1 (3.6)
Sun Java System Message Queue est un service de messagerie complet fournissant des fonctions de messagerie fiables et asynchrones conformes � la sp�cification Java Messaging Specification (JMS) 1.1. En outre, Message Queue propose un ensemble de fonctions d�passant le cadre de la sp�cification JMS afin de prendre en charge les d�ploiements d’entreprise � grande �chelle.
Cette section inclut :
Nouveaut�s de cette version
Message Queue 3 2005Q1 (3.6) offre notamment les nouvelles fonctionnalit�s suivantes :
Ces fonctionnalit�s sont d�crites dans les sous-sections suivantes :
Message Queue bloqu�
Message Queue cr�e automatiquement une destination sp�ciale au d�marrage du courtier, utilis�e pour stocker les messages bloqu�s � des fins de diagnostic. Un message bloqu� est un message qui est supprim� du syst�me en dehors du traitement normal ou de l’action explicite d’un administrateur. Un message peut �tre consid�r� comme bloqu� parce qu’il a expir�, qu’il a �t� supprim� d’une destination en raison d’une insuffisance de m�moire ou parce qu’il n’a pu �tre livr� apr�s plusieurs tentatives.
Un administrateur peut configurer les destinations de sorte que les messages bloqu�s soient supprim�s ou qu’ils soient plac�s dans une file d’attente. Lorsqu’ils sont plac�s dans la file d’attente, des informations de propri�t� suppl�mentaires sont �crites dans le message, renseignant l’administrateur sur la cause du blocage. Un d�veloppeur client peut �galement d�finir une valeur de propri�t� lors de la cr�ation d’un message, de sorte � placer directement le message dans la file d’attente des messages bloqu�s s’il venait � �tre bloqu�.
Pour plus d’informations, voir Message Queue Administration Guide.
Mode sans accus� de r�ception
Le mode d’accus� de r�ception NO_ACKNOWLEDGE est une extension de l’API JMS. En principe, le courtier attend l’accus� de r�ception d’un client. Cet acquittement doit �tre effectu� par le programme si le client est d�fini sur le mode CLIENT_ACKNOWLEDGE ou automatiquement, par la session, s’il est d�fini sur AUTO_ACKNOWLEDGE ou DUPS_OK. Si un client est d�fini sur le mode NO_ACKNOWLEDGE, le courtier ignore le message d�s que ce dernier a �t� envoy� au client. Cette fonctionnalit� est r�serv�e en premier lieu aux abonn�s non durables consommant des messages non persistants, mais elle peut �galement servir � tout autre consommateur.
Cette fonction permet d’accro�tre les performances en limitant le trafic de gestion de protocole et le travail du courtier impliqu�s dans l’acquittement d’un message. Elle permet �galement d’am�liorer les performances des courtiers traitant avec des clients au fonctionnement anormal qui n’accusent pas r�ception des messages et de ce fait, utilisent inutilement les ressources de m�moire du courtier. L’utilisation de ce mode n’a aucune incidence sur les producteurs.
Les clients C ne prennent pas en charge le mode NO_ACKNOWLEDGE. Pour plus d’informations, voir Message Queue Developer’s Guide for Java Clients.
Compression du corps des messages du client
Le d�veloppeur peut d�finir la compression du corps d’un message. Les op�rations de compression et de d�compression des messages sont enti�rement effectu�es par le programme client et n’affectent pas le courtier. Les applications peuvent donc utiliser cette fonction avec une version ant�rieure du courtier, mais doivent employer la version 3 2005Q1 (3.6) de la biblioth�que d’ex�cution du client Message Queue.
Avantages et limitations de la compression Bien que la fonction de compression ait �t� ajout�e dans le but d’am�liorer les performances, ses b�n�fices ne sont pas syst�matiques. Ces derniers d�pendent en effet de la taille et du format des messages, du nombre de consommateurs, de la bande passante du r�seau et des performances de l’unit� centrale. Par exemple, le co�t induit par la compression et la d�compression peut se r�v�ler trop �lev� par rapport au temps que vous pouvez gagner dans la r�ception et l’envoi d’un message compress�. Cela se v�rifie tout particuli�rement lorsque vous envoyez des messages peu volumineux sur un r�seau haut d�bit. En revanche, la compression des messages peut constituer un avantage lorsqu’il s’agit d’envoyer des messages volumineux � plusieurs consommateurs ou de les publier dans un environnement r�seau lent.
Les consommateurs de messages d�ploy�s avec les biblioth�ques d’ex�cution clientes ant�rieures � la version 3 2005Q1 (3.6) ne peuvent pas traiter les messages compress�s. Pour les clients configur�s pour l’envoi de messages compress�s, il faut s’assurer de la compatibilit� des consommateurs. Actuellement, les clients C ne peuvent pas consommer de messages compress�s.
Pour plus d’informations, voir Message Queue Developer’s Guide for Java Clients.
D�tection de l’�chec de connexion (Ping du programme d’ex�cution client)
Message Queue 3 2005Q1 introduit un nouvel attribut ConnectionFactory nomm� imqPingInterval. L’attribut imqPingInterval sp�cifie la fr�quence de l’op�ration ping du programme client vers le courtier. En testant r�guli�rement la connexion, le programme client peut d�tecter de mani�re pr�ventive tout �chec de connexion. Si l’op�ration ping �choue, le programme client envoie une exception � l’objet module d’�coute des exceptions de l’application cliente. Si l’application ne comporte pas de module d’�coute des exceptions, sa tentative suivante de connexion �choue.
Pour plus d’informations, voir Message Queue Administration Guide.
Gestion des certificats : Outils NSS de C-API
L’interface C-API utilise les biblioth�ques NSS (Network Security Services) pour prendre en charge le protocole SSL. Ces biblioth�ques fournissent les API et les utilitaires permettant de d�velopper des applications s�curis�es. Les utilitaires incluent les outils de gestion des bases de donn�es des cl�s et des certificats. Dans Message Queue 3.5, les d�veloppeurs devaient utiliser Mozilla pour g�rer les certificats et cl�s NSS. Dans Message Queue 3 2005Q1, les administrateurs peuvent se servir de l’outil certutil NSS pour g�n�rer les certificats et cl�s n�cessaires.
Pour plus d’informations, voir Message Queue Developer’s Guide for C Clients.
Prise en charge de l’authentification de base pour l’interface C-API
L’interface C-API de Message Queue3 2005Q1 prend en charge le type d’authentification basic. Ce n’�tait pas le cas des pr�c�dentes versions de Message Queue.
Prise en charge de l’interface C-API 64 bits
Message Queue prend d�sormais en charge l’interface C-API 64 bits sur la plate-forme Solaris/SPARC. Pour plus d’informations sur l’activation de la prise en charge de l’interface C-API 64 bits, reportez-vous au manuel Message Queue Developer’s Guide for C Clients.
Configurations mat�rielle et logicielle requises
Cette section d�crit le mat�riel et les logiciels recommand�s pour cette version de Message Queue. Le Tableau 2 r�pertorie les configurations mat�rielle et logicielle requises pour les syst�mes d’exploitation Solaris SPARC.
Le Tableau 3 r�pertorie les configurations mat�rielle et logicielle requises pour les syst�mes d’exploitation Solaris x86.
Le Tableau 4 r�pertorie les configurations mat�rielle et logicielle requises pour les syst�mes d’exploitation Linux.
Message Queue 3 2005Q1 n�cessite �galement d’autres technologies, comme indiqu� dans le Tableau 5. 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.
Le Tableau 5 r�pertorie et d�crit les composants de base � installer pour pouvoir d�velopper et ex�cuter les clients Message Queue.
Le Tableau 6 r�pertorie et d�crit les composants que vous pouvez installer pour fournir une prise en charge suppl�mentaire pour un client Message Queue. Tous les composants r�pertori�s ne sont pas forc�ment n�cessaires. Par exemple, si vous ne d�veloppez pas de client C pour Message Queue, vous n’avez pas besoin des composants requis pour la prise en charge du client C.
Bogues r�solus dans la pr�sente versionLe Tableau 7 r�pertorie les bogues r�solus dans Message Queue 3 2005Q1 (3.6) :
Le Tableau 8 r�pertorie les bogues r�solus dans Message Queue 3 2005Q1 (3.6 SP1) :
Le Tableau 9 r�pertorie les bogues r�solus dans Message Queue 3 2005Q4 (3.6 SP2) :
Le Tableau 10 r�pertorie les bogues r�solus dans Message Queue 3 2005Q4 (3.6 SP3) :
Informations importantesCette section comprend les derni�res informations qui n’ont pu �tre incluses dans la documentation de base du produit. Elle aborde les th�mes suivants :
Notes relatives � l’installation
Reportez-vous au manuel Message Queue Installation Guide pour obtenir des informations sur les instructions de pr�-installation, les proc�dures de mise � niveau et toutes autres informations relatives � l’installation de Message Queue, Platform Edition sur les plates-formes Solaris, Linux et Windows.
Reportez-vous au Guide d'installation de Sun Java Enterprise System pour obtenir des informations sur les instructions de pr�-installation et toutes autres informations relatives � l’installation de Message Queue, Enterprise Edition sur les plates-formes Solaris et Linux.
Reportez-vous au Guide de migration et de mise � niveau de Sun Java Enterprise System pour obtenir des informations sur les instructions de migration et de mise � niveau vers Message Queue 3 2005Q1 (3.6) sur les plates-formes Solaris et Linux.
Installation des packages Solaris manquants (distribution de Message Queue 3 2005Q1 Enterprise Edition uniquement (distribution des sous-ensembles) avec le programme d'installation de Java Enterprise System)
La distribution de Message Queue 3 2005Q1 Enterprise Edition pour Solaris n’inclut pas les packages SUNWtlsu (Network Security Services Utilities) et SUNWtlsux (Network Security Services Utilities SPARC 64 bits uniquement).
Ces packages ne sont utiles que pour la prise en charge des clients C SSL. Il se peut que vous poss�diez une version pr�c�dente de ces packages, mais il est conseill� de les mettre � jour avec la version incluse dans Java Enterprise System 2005Q1.
Solution
Vous pouvez obtenir la version des packages SUNWtlsu et SUNWtlsux incluse dans Java Enterprise System 2005Q1 � partir des fichiers de l’�dition Message Queue 3 2005Q1 Platform Edition sur le site Web Sun Java System. Apr�s avoir t�l�charg� les fichiers de Message Queue, suivez les instructions de la section � Installing Message Queue � (Installation de Message Queue) du chapitre 2, � Solaris Installation � (Installation Solaris) dans le guide Message Queue Installation Guide. À l’�tape 8, r�pondez n (non) et passez � l’�tape 9 pour installer uniquement les packages SUNWtlsu et SUNWtlsux sur votre syst�me.Probl�mes de compatibilit�
Cette section d�crit les probl�mes de compatibilit� de Message Queue 3 2005Q1 (3.6).
Probl�mes de Message Queue 3 2005Q1 (3.6)
Les sections suivantes d�crivent les probl�mes affectant : toutes les plates-formes, les plates-formes Solaris et Linux, et uniquement les plates-formes Linux.
Toutes les plates-formes
Stabilit� de l’interface Sun Java System Message Queue utilise de nombreuses interfaces qui permettent d’automatiser certaines t�ches des administrateurs. L’Annexe B du Message Queue Administration Guide classe ces interfaces en fonction de leur stabilit�. Plus l’interface est stable, moins elle est susceptible d’�tre modifi�e dans les versions ult�rieures du produit.
D�sapprobation des options de mot de passe Pour des raisons de s�curit�, les options suivantes ont �t� d�sapprouv�es :
Si un mot de passe est sp�cifi� dans une commande, comme dans l’exemple suivant :
imqcmd query bkr -u admin -p adminpassword
un utilisateur peut voir le mot de passe de l’administrateur lors de l’inventaire ou de l’interrogation des processus d’une machine (par ex., en utilisant ps sur Solaris).
Pr�f�rez l’option -passfile � la place. L’option passfile est expliqu�e dans le chapitre relatif � la s�curit� dans le guide Message Queue Administration Guide.
Plates-formes Solaris et Linux
Prise en charge du client JDK 1.3 Les packages suivants contiennent les fichiers jar utilis�s pour la prise en charge de JNDI et JSSE pour le d�veloppement et le d�ploiement du client sur JDK 1.3. Ces packages ne sont fournis qu’avec Message Queue, Platform Edition. Ils ne seront pas fournis dans les versions ult�rieures. Ces packages ne sont pas install�s par d�faut :
Pour plus d’informations sur l’installation des packages de mani�re s�par�e, reportez-vous au guide Message Queue Installation Guide.
Plates-formes Linux
Cette section d�crit les modifications qui affectent les packages et les emplacements d’installation sur la plate-forme Linux.
Nouveaux emplacements d’installation Linux L’emplacement des r�pertoires d’installation de Message Queue a �t� modifi� pour Linux.
Remarque
Aucune modification n’a �t� apport�e � l’emplacement des r�pertoires d’installation entre Message Queue 3 2005Q1 (3.6) et Message Queue 3 2005Q4 (3.6 SP3).
Le Tableau 11 montre les r�pertoires d’installation par d�faut des RPM Message Queue sur Linux.
Pour plus d’informations, reportez-vous � l’annexe A, � Operating System-Specific Locations of Message Queue Data � (Emplacements des donn�es de Message Queue en fonction des syst�mes d’exploitation) dans le guide Message Queue Administration Guide.
Modification du nom des packages RPM Linux Le nom des fichiers de package RPM Linux de Message Queue a �t� modifi�.
Remarque
Aucune modification n’a �t� apport�e aux noms des packages RPM Linux Message Queue entre la version Message Queue 3 2005Q1 et la version Message Queue 3 2005Q4.
Le Tableau 12 montre le nouveau nom des packages RPM Linux de Message Queue 3 2005Q1.
Tableau 12 Packages RPM dans les fichiers Linux
RPM
Description
Notes
sun-mq-config
Fichiers /etc
sun-mq-var
Fichiers /var
sun-mq
Fichiers /opt
D�pend des packages sun-javahelp, sun-mq-jmsclient, sun-mq-config et sun-mq-var
sun-mq-ent
Fichier de licence Enterprise Edition.
Ce RPM est livr� uniquement avec Message Queue, Enterprise Edition, disponible avec Java Enterprise System.
sun-mq-jaxm
Message Queue Java API for XML Messaging (JAXM) : API
D�pend de sun-saaj
sun-mq-jmsclient
JMS : API et programme d’ex�cution
Aucune d�pendance
sun-mq-xmlclient
Client XML
D�pend de sun-jmsclient et de sun-saaj
sun-mq-capi
C-API
D�pend de sun-nspr, sun-nss
sun-mq-compat
Liens symboliques vers les emplacements de Message Queue 3.5.
D�pend de sun-mq
Ce RPM n’est pas install� par d�faut.
Remarque : ce package est requis uniquement si vos clients existants d�pendent des emplacements de fichiers de Message Queue 3.5.
sun-mq-sup
Requis pour la prise en charge de JDK 1.3
D�pend de sun-mq
Ce RPM n’est pas install� par d�faut.
Remarque : ce package est uniquement livr� avec Message Queue, Platform Edition.
sun-mq-[locale]
Fichiers L10N
sun-javahelp1
JavaHelp : API et programme d’ex�cution
Prend en charge le visionneur JavaHelp pour l’aide d’Admin Console
sun-nss1
Biblioth�ques NSS (Network Security Services).
Requis pour la prise en charge des clients du langage C
sun-nspr1
Biblioth�ques NSPR (Netscape Portable Runtime)
Requis pour la prise en charge des clients C
sun-saaj1
SOAP with Attachments API for Java : API et programme d’ex�cution
Requis pour la prise en charge des clients Java utilisant l’API SOAP/JAXM
sun-jaxp1
Message Queue Java API for XML Processing (JAXP) : API et programme d’ex�cution
Requis pour la prise en charge des clients Java utilisant l’API SOAP/JAXM
sun-javamail1
JavaMail : API et programme d’ex�cution
Requis pour la prise en charge des clients Java utilisant l’API SOAP/JAXM
sun-jaf1
JavaBeans Activation Framework : API et programme d’ex�cution
Requis pour la prise en charge des clients Java utilisant l’API SOAP/JAXM
1Ce package RPM est partag� par un certain nombre de produits Sun Java System. Il est fourni avec Message Queue, Platform Edition dans la distribution, mais pas avec Message Queue, Enterprise Edition.
Package des liens symboliques pour les clients de Message Queue 3.5 L’emplacement des fichiers individuels install�s avec Message Queue sur Linux a chang�. Cette modification peut interrompre les applications qui d�pendent de l’ancien emplacement de certains fichiers Message Queue. Par exemple, si vos clients utilisent des scripts pour localiser les fichiers jar install�s avec Message Queue 3.5, ils ne pourront plus localiser ces fichiers.
Pour r�soudre ce probl�me, le package Linux sun-mq-compat est inclus dans cette version. Il installe les liens symboliques des emplacements de fichiers de Message Queue 3.5 vers les emplacements de fichiers de Message Queue 3 2005Q1 (3.6). Ce package peut ne pas �tre fourni dans les versions ult�rieures. Vous devez corriger tous les scripts qui pointent vers les anciens emplacements de fichiers Message Queue.
Le package sun-mq-compat se trouve dans les emplacements suivants.
Pour installer le package sun-mq-compat
Probl�mes relatifs � la prochaine version majeure de Message Queue
La prochaine version principale de Message Queue peut introduire des modifications rendant vos clients incompatibles avec cette version. Cette information vous est fournie d�s � pr�sent afin que vous puissiez vous pr�parer � ces modifications.
- Il s’agit de la derni�re version de fonction de Sun Java System Message Queue qui sera compatible avec Sun One Message Queue 3.0.1. Les futures versions de Sun Java System Message Queue ne prendront plus en charge les fonctions suivantes :
- connexion des clients 3.0.1 aux courtiers de la derni�re version ;
- mise � niveau d’un magasin persistant 3.0.1 au niveau de la derni�re version ;
- clustering des courtiers 3.0.1 avec les courtiers de la derni�re version ;
- utilisation des fichiers de propri�t�s, des magasins d’utilisateurs, des listes de contr�le d’acc�s, etc. 3.0.1 avec des courtiers de la derni�re version.
- Il s’agit de la derni�re version de Sun Java System Message Queue qui sera prise en charge et int�gr�e en tant que fournisseur de messagerie JMS syst�me pour Sun Java System Application Server 7.X. Les versions ult�rieures de Sun Java System Message Queue ne prendront en charge que Sun Java System Application Server 8.0 et versions sup�rieures.
- Il s’agit de la derni�re version de Sun Java System Message Queue qui inclura l’ex�cution SOAP et prendra en charge les objets administr�s SOAP Message Queue.
- Les versions futures prendront uniquement en charge SOAP conjointement avec une version Java 2 Standard Edition Platform qui prend en charge SOAP.
- Sun Java System La prise en charge du client Message Queue pour toutes les versions de Java 2 Standard Edition 1.3 sera abandonn�e. Java 2 Standard Edition 1.4 continuera d’�tre pris en charge.
- L’emplacement des fichiers individuels install�s avec Sun Java System Message Queue peut changer. Ceci risque de perturber l’ex�cution des applications existantes d�pendant de l’emplacement actuel des fichiers Message Queue.
- Sun Java System Les clients Message Queue utilisant une version de Message Queue plus ancienne que la prochaine version principale risquent de ne pas avoir acc�s aux nouvelles fonctions fournies dans cette version du produit.
Mises � jour de la documentation de Message Queue
Les sections suivantes pr�sentent les mises � jour de la documentation de Message Queue 3 2005Q1 (3.6) et de Message Queue 3 2005Q4 (3.6 SP3).
Mises � jour de la documentation de Message Queue 3 2005Q1 (3.6)
Les documents de Message Queue suivants ont fait l’objet d’une mise � jour � partir de la version 3.5 du produit :
Guide d’installation
Le guide Message Queue Installation Guide a �t� mis � jour pour refl�ter les modifications relatives aux marques et les informations sp�cifiques aux plates-formes. Ce document contient d�sormais les informations d’installation concernant Message Queue, Platform Edition.
Les informations d’installation de Message Queue Enterprise Edition figurent maintenant dans le Guide d'installation Sun Java System.
Pour plus d’informations sur la mise � niveau et la migration vers Message Queue 3 2005Q1 (3.6) Enterprise Edition, reportez-vous au Guide de migration et de mise � niveau de Sun Java System.
Pr�sentation technique
Message Queue Technical Overview est un nouveau document introduit avec la version Message Queue 3 2005Q1 (3.6). Il a �t� remani� pour la version Message Queue 3 2005Q4 (3.6 SP3). Il d�crit Message Queue, ses fonctions, son architecture, sa technologie et sa terminologie. Il contient les informations g�n�rales contenues pr�c�demment dans d’autres manuels et est destin� aux utilisateurs de Message Queue, qu’ils soient administrateurs ou d�veloppeurs, ainsi qu’� tout autre utilisateur.
Administration Guide
Le guide Message Queue Administration Guide a �t� mis � jour afin de refl�ter les modifications relatives aux marques ainsi que les nouvelles fonctions. Il a �galement fait l’objet d’une r�organisation afin d’�tre plus facile d’utilisation pour les administrateurs de Message Queue. Les informations g�n�rales qui figuraient auparavant dans ce document ont �t� transf�r�es dans le document Message Queue Technical Overview.
Message Queue Developer’s Guide for Java Clients
Le guide Java Client Developer’s Guide a �t� mis � jour pour refl�ter les modifications relatives aux marques et les nouvelles fonctions. Il a �galement chang� d’intitul� et s’appelle d�sormais Message Queue Developer’s Guide for Java Clients.
Le guide Message Queue Developer’s Guide for Java Clients a fait l’objet d’une r�organisation afin d’�tre plus facile d’utilisation pour les d�veloppeurs du client Java de Message Queue. Les informations g�n�rales qui figuraient auparavant dans ce document ont �t� transf�r�es dans le document Message Queue Technical Overview.
C Client Developer’s Guide
Le guide C Client Developer’s Guide a �t� mis � jour pour refl�ter les modifications relatives aux marques et les nouvelles fonctions. Il a �galement chang� d’intitul� et s’appelle d�sormais Message Queue Developer’s Guide for C Clients.
Le guide Message Queue Developer’s Guide for C Clients a fait l’objet d’une r�organisation afin d’�tre plus facile d’utilisation pour les d�veloppeurs du client C de Message Queue. Les informations g�n�rales qui figuraient auparavant dans ce document ont �t� transf�r�es dans le document Message Queue Technical Overview.
Mises � jour de la documentation de Message Queue 3 2005Q4 (3.6 SP3)
Les documents de Message Queue suivants ont fait l’objet d’une mise � jour � partir de la version 3 2005Q1 (3.6) du produit :
Guide d’installation
Le document Message Queue Installation Guide a �t� mis � jour de sorte � refl�ter les modifications relatives � l’installation du produit introduites depuis la version Message Queue 3 2005Q1 (3.6).
Pr�sentation technique
Message Queue Technical Overview est un nouveau document introduit avec la version Message Queue 3 2005Q1 (3.6). Il a �t� remani� pour la version Message Queue 3 2005Q4 (3.6 SP3). Il d�crit Message Queue, ses fonctions, son architecture, sa technologie et sa terminologie. Il contient les informations g�n�rales contenues pr�c�demment dans d’autres manuels et est destin� aux utilisateurs de Message Queue, qu’ils soient administrateurs ou d�veloppeurs, ainsi qu’� tout autre utilisateur.
Administration Guide
Le document Message Queue Administration Guide a fait l’objet d’une r�organisation afin d’�tre plus facile d’utilisation pour les administrateurs de Message Queue. Les informations g�n�rales qui figuraient auparavant dans ce document ont �t� transf�r�es dans le document Message Queue Technical Overview.
Message Queue Developer’s Guide for Java Clients
Le document Message Queue Developer’s Guide for Java Clients contient un nouveau chapitre, � Using the Java API �.
Probl�mes connus et restrictionsCette section contient la liste des probl�mes connus de Message Queue 3 2005Q1 (3.6). Les domaines suivants du produit sont abord�s :
Pour conna�tre la liste des probl�mes actuels, leur �tat et les solutions possibles, les membres de Java Developer Connection doivent consulter la page � Bug Parade � du site Web Java Developer Connection. Avant de signaler tout nouveau probl�me, merci de consulter cette page. Bien que tous les probl�mes de Message Queue n’y soient pas r�pertori�s, il est bon de s’y r�f�rer pour savoir si un probl�me a d�j� �t� signal�.
La page concern�e est la suivante :
Pour signaler un nouveau probl�me ou soumettre une demande d’am�lioration, envoyez un courrier �lectronique � l’adresse imq-feedback@sun.com.
Probl�mes d’ordre g�n�ral
Cette section d�crit les probl�mes d’ordre g�n�ral de Message Queue 3 2005Q1 (3.6). Certains ont d�j� �t� signal�s dans des versions pr�c�dentes de Message Queue. Cette section regroupe les probl�mes en fonction de leur appartenance � Enterprise Edition et Platform Edition de Message Queue ou � Enterprise Edition uniquement.
Enterprise Edition et Platform Edition
Si vous d�pendiez auparavant des valeurs de propri�t�s de la configuration du r�f�rentiel utilisateur LDAP donn� en exemple dans le fichier default.properties, votre client d’application JMS recevra une exception de s�curit� lorsqu’il tentera de cr�er une connexion JMS. Ce probl�me survient apr�s une mise � niveau vers Message Queue 3 2005Q1.
Lorsque le client JMS tente d’�tablir une connexion avec le courtier de Message Queue 3 2005Q1, une erreur s’affiche dans le journal du courtier et le client JMS re�oit l’exception suivante :
SecurityException.
20/ao�t/2004:11:16:41 PDT] ERREUR [B4064] : Propri�t� .uidattr du r�f�rentiel LDAP ldap non d�finie pour le type d'authentification basic:com.sun.messaging.jmq.auth.LoginException: [B4064] : Propri�t� .uidattr du r�f�rentiel LDAP ldap non d�finie pour le type d'authentification basic
- Un bogue dans RedHat Linux 2.1 (bogue NSS n� 5078380) peut bloquer les m�thodes MQCreateConnection (biblioth�que C-API de Message Queue 3 2005Q1) de l’application C-API de Message Queue ou MQInitializeSSL (biblioth�que C-API de Message Queue 3 2005Q1 ou 3.5) si un thread est cr�� dans l’application C-API de Message Queue avant l’appel de ces deux m�thodes.
Solution
Quatre options permettent d’�viter ce probl�me lors de l’utilisation de la biblioth�que C-API de Message Queue 3 2005Q1 :
- Mettre � niveau vers RedHat Linux 3.0
- D�finir la variable d’environnement MQ_NSS_5078380_WORKAROUND avant d’ex�cuter l’application cliente C de Message Queue et d�finir la propri�t� du courtier Message Queue sur la valeur imq.authentication.type=basic
- Appeler la m�thode MQInistializeSSL(<chemin-bd-certificats>) avant de lancer tout thread dans votre application cliente C de Message Queue. Vous pouvez utiliser l’utilitaire certutil pour cr�er les fichiers de base de donn�es de certificats.
- Cr�ez une connexion au courtier de Message Queue en appelant MQCreateConnection avant de lancer un thread. Vous ne pouvez pas modifier le fichier de configuration des instances d’un courtier sans avoir d�marr�, au moins une fois, l’instance du courtier, tout simplement parce que le fichier config.properties n’existe pas tant que l’instance du courtier n’a pas �t� d�marr�e une premi�re fois. Pour configurer un courtier afin qu’il utilise la permanence enfichable ou pour d�finir d’autres propri�t�s de configuration, ex�cutez une fois le courtier (avec le nom d’instance qui doit �tre utilis� pour cr�er le courtier) pour cr�er le fichier config.properties :
Enterprise Edition uniquement
- Seuls les clusters de courtiers enti�rement 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 connectez des courtiers par l’interm�diaire de l’argument de ligne de commande imqbrokerd -cluster, assurez-vous bien que tous les courtiers du cluster sont pris en compte.
- Un client connect� � un courtier appartenant � un cluster ne peut actuellement pas utiliser QueueBrowser pour parcourir les files d’attente situ�es sur les courtiers distants de ce cluster. Il ne peut que parcourir le contenu des files d’attente situ�es sur le courtier auquel il est directement connect�. 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 limitation ne s’appliquant en effet qu’� la navigation.
- Si aucun courtier ne fait office de courtier principal dans un cluster, les informations permanentes enregistr�es par un courtier ayant �t� ajout� au cluster ne sont pas communiqu�es aux autres courtiers du cluster.
- Un service de connexion utilisant SSL ne prend en charge actuellement que les certificats de serveurs auto-sign�s, c’est-�-dire le mode d’approbation par l’h�te.
- Lorsqu’un client JMS utilisant le transport 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 pendant cet intervalle d’une minute et qu’elle tente d’utiliser le m�me ClientID, le m�me abonnement durable ou la m�me file d’attente, elle peut recevoir 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.
Probl�mes li�s � l’administration/configuration
Les utilitaires imqadmin et imqobjmgr renvoient une erreur lorsque la variable CLASSPATH contient des guillemets sur les postes Windows (ID de bogue 5060769)
Solution
Vous pouvez ignorer ce message d’erreur, le courtier traite correctement le probl�me en notifiant toute erreur aux consommateurs. Cette erreur n’affecte pas la fiabilit� du syst�me.L'option -javahome dans tous les scripts Solaris/Windows ne fonctionne pas si la valeur comprend un espace (bogue n� 4683029)
L’option -javahome est utilis�e par les commandes et les utilitaires de Message Queue pour indiquer un autre ex�cuteur Java 2 compatible. N�anmoins, le chemin d’acc�s de l’autre ex�cuteur Java ne doit pas contenir d’espace.
Vous trouverez ici des exemples de chemin contenant des espaces :
Windows :
C:\jdk 1.4Solaris :
/work/java 1.4Solution
Installez l’ex�cuteur Java � un emplacement ou un chemin ne contenant pas d’espace.Message Queue envoie un message garbage au journal syst�me dans un environnement autre que C (bogue n� 6193884)
Message Queue envoie une sortie garbage au journal syst�me lorsque le courtier est ex�cut� dans un environnement autre que C.
Solution
Ex�cutez le courtier dans un environnement C.Probl�mes relatifs au courtier
Dans un cluster de courtiers, un courtier mettra en file d'attente les messages destin�s � une connexion distante qui n'a pas �t� initi�e (bogue n� 4951010)
Solution
Le consommateur recevra les messages d�s que la connexion est initi�e. Les messages seront de nouveau envoy�s � un autre consommateur si la connexion du consommateur est ferm�e.Il arrive que HTTPS createQueueConnection renvoie une exception sous Windows 2000. (bogue n� 4953348)
Solution
R�essayez de vous connecter.Lorsque vous utilisez Ctrl-C pour arr�ter le courtier, il se peut que les transactions soient effac�es apr�s la fermeture du magasin (bogue n� 4934446)
Le courtier affiche les erreurs avec le motif � Acc�s � la m�thode Store apr�s la fermeture du magasin � si le courtier est arr�t� alors que des messages ou des transactions sont en cours de traitement.
Solution
Vous pouvez ignorer ce message d’erreur, le courtier traite correctement le probl�me en notifiant toute erreur aux consommateurs. Cette erreur n’affecte pas la fiabilit� du syst�me.Le courtier devient inaccessible lorsque le d�p�t permanent ouvre trop de destinations. (Bogue n� 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 d�truite (bogue n� 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).
Solution
Il n’existe aucune solution � ce probl�me.Impossible de s�lectionner des messages avec JMSMessageID (bogue n� 6196233)
La s�lection de messages avec le s�lecteur "JMSMessageID = ’<id_message>’" ne fonctionne pas.
Solution
Remplacez le s�lecteur :JMSMessageID = "ID:message-id-string"
en :
JMSMessageID IN ('ID:message-id-string', 'message-id-string')
Message Queue QueueBrowser indique �galement des messages non valid�s (bogue n� 6264003)
Lors du parcours du contenu d’une file d’attente, les messages qui ont �t� produits dans une transaction mais n’ont pas encore �t� valid�s peuvent appara�tre dans l’�num�ration de QueueBrowser.
Solution
Il n’existe aucune solution � ce probl�me.
Fichiers redistribuablesSun Java System Message Queue 3 2005Q1 (3.6) contient le jeu de fichiers suivant que vous pouvez utiliser et distribuer librement sous forme binaire :
Fonctions d’accessibilit� destin�es aux personnes handicap�esPour 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. Vous trouverez des versions mises � jour pour certaines applications � l’emplacement suivant : http://sun.com/software/javaenterprisesystem/get.html.
Pour plus d’informations sur l’engagement de Sun en mati�re d’accessibilit�, consultez le site http://sun.com/access.
Comment signaler des probl�mes et apporter des commentairesSi vous rencontrez des probl�mes avec Sun Java System Message Queue, contactez le service client�le Sun de l’une des mani�res suivantes :
- En faisant appel aux services de support logiciel Sun en ligne � l’adresse ci-dessous :
http://www.sun.com/service/sunone/softwareAfin de vous aider � r�soudre votre probl�me, pensez � r�unir les informations suivantes lorsque vous contactez le support technique :
- la description du probl�me, en particulier les situations dans lesquelles il se produit et son impact sur vos op�rations ;
- 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 ;
- la proc�dure d�taill�e des m�thodes utilis�es pour reproduire le probl�me ;
- tous les journaux d’erreur ou vidages de la m�moire.
Forum des logiciels Sun Java System
Il existe un forum Sun Java System Message Queue � l’emplacement suivant :
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.
Sun attend vos commentairesAfin d’am�liorer sa documentation, Sun vous encourage � faire des commentaires et � apporter des suggestions.
Pour nous faire part de vos commentaires, rendez-vous sur le site http://docs.sun.com, puis cliquez sur Envoyer des commentaires. Dans le formulaire en ligne, indiquez le titre et le num�ro du document. Ce num�ro est constitu� de sept ou neuf chiffres et figure sur la page de titre du manuel ou en haut du document. Par exemple, le titre de ce manuel est Sun Java System Message Queue 3 2005Q4 Notes de version, et sa r�f�rence est 819-3557.
Ressources Sun suppl�mentairesVous pouvez obtenir des informations utiles concernant Sun Java System sur les sites Internet suivants :
- Documentation de Message Queue
http://docs.sun.com/coll/1307.1- Documentation de Sun Java System
http://docs.sun.com/prod/java.sys- Services professionnels de Sun Java System
http://www.sun.com/service/sunps/sunone- Produits et services logiciels de Sun Java System
http://www.sun.com/software- Services de support logiciel Sun Java System
http://www.sun.com/service/sunone/software- Base de connaissances et support Sun Java System
http://www.sun.com/service/support/software- Services de formation et de support Sun
http://training.sun.com- Services professionnels et de conseil Sun Java System
http://www.sun.com/service/sunps/sunone- Informations pour les d�veloppeurs Sun Java System
http://developers.sun.com- Services de support pour d�veloppeurs Sun
http://www.sun.com/developers/support- Formation sur les logiciels Sun Java System
http://www.sun.com/software/training- Fiches de pr�sentation des logiciels Sun
http://wwws.sun.com/software
Copyright � 2005 Sun Microsystems, Inc. Tous droits r�serv�s.
Sun Microsystems, Inc. Sun Microsystems, Inc. d�tient les droits de propri�t� intellectuelle relatifs � la technologie qui est d�crite dans ce document. En particulier, et ce sans limitation, ces droits de propri�t� intellectuelle peuvent inclure un ou plusieurs des brevets am�ricains r�pertori�s � l’adresse http://www.sun.com/patents, et un ou plusieurs brevets suppl�mentaires ou des demandes de brevet en instance aux �tats-Unis et dans d’autres pays.
L’utilisation est soumise aux termes du contrat de licence.
Cette distribution peut comprendre des composants d�velopp�s par des tierces parties.
Sun, Sun Microsystems, le logo Sun, Java, Solaris et Sun[tm] ONE sont des marques de fabrique ou des marques d�pos�es de Sun Microsystems, Inc. aux �tats-Unis et dans d’autres pays.
Toutes les marques SPARC sont utilis�es sous licence et sont des marques de fabrique ou des marques d�pos�es de SPARC International, Inc. aux �tats-Unis et dans d’autres pays.
UNIX est une marque d�pos�e aux �tats-Unis et dans d’autres pays et conc�d�e exclusivement sous licence par X/Open Company, Ltd.