Sun Java System Message Queue 3 2005T1 Notes de version

Notes de version de Sun Java System Message Queue

Version 3 2005T1 (3.6)

R�f�rence 819-2032

Ces notes de version contiennent des informations importantes connues au moment de la commercialisation de Sun Java™ System Message Queue 3 2005T1 (3.6). 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/MessageQueue_05q1. 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 version les plus r�centes.

Ces notes de version comprennent les sections suivantes :

Historique de r�vision des notes de version

À propos de Message Queue 3 2005T1 (3.6)

Bogues r�solus dans la pr�sente version

Informations importantes

Probl�mes connus et restrictions

Fichiers redistribuables

Comment signaler des probl�mes et apporter des commentaires

Ressources Sun suppl�mentaires

Des adresses URL de sites tiers, qui renvoient � des informations compl�mentaires connexes, sont r�f�renc�es dans ce document.

Remarque

Sun d�cline toute responsabilit� quant � la disponibilit� des sites tiers mentionn�s. Sun ne garantit pas le contenu, la publicit�, les produits et autres mat�riaux disponibles sur ces sites ou dans ces ressources, ou accessibles par leur interm�diaire, et ne saurait en �tre tenu pour responsable. Par ailleurs, la responsabilit� de Sun ne saurait �tre engag�e en cas de dommages ou de pertes, r�els ou suppos�s, occasionn�s par, ou li�s �, l’utilisation du contenu, des produits ou des services disponibles sur ces sites ou dans ces ressources, ou accessibles par leur biais, ou encore � la confiance qui a pu leur �tre accord�e.

Historique de r�vision des notes de version

Tableau 1  Historique des r�visions

Date

Description des modifications

24 janvier 2005

Mise � jour avec la version finale de Sun Java System Message Queue 3 2005T1 et Java Enterprise System 2005T1.

8 novembre 2004

Premi�re version des Notes de version de Message Queue Sun Java System.

À propos de Message Queue 3 2005T1 (3.6)

Sun Java System Message Queue est un service de messagerie complet qui fournit une messagerie fiable et asynchrone, conforme � la sp�cification Java Messaging Specification (JMS) 1.1. Message Queue h�berge en outre des fonctions d�passant la sp�cification JMS pour permettre des d�ploiements d’entreprise � grande �chelle.

Cette section inclut :

Nouveaut�s de cette version

Configurations mat�rielle et logicielle requises

Nouveaut�s de cette version

Message Queue 3 2005T1 (3.6) offre notamment les nouvelles fonctionnalit�s suivantes :

File d’attente des messages bloqu�s

Mode sans accus� de r�ception

Compression du corps des messages du client

D�tection de l’�chec de connexion (Ping du programme d’ex�cution client)

Gestion des certificats : Outils NSS de C-API

Prise en charge de l’authentification de base pour l’interface C-API

Prise en charge de l’interface C-API 64 bits

Ces fonctionnalit�s sont d�crites dans les sous-sections suivantes :

File d’attente des messages bloqu�s

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, reportez-vous au manuel 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, reportez-vous au manuel 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 2005T1 (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 2005T1 (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, reportez-vous au manuel 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 2005T1 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, reportez-vous au manuel 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 2005T1, 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, reportez-vous au manuel 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 Queue 3 2005T1 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.

Tableau 2  Configurations mat�rielle et logicielle requises pour Solaris SPARC

Composant

Configuration requise par la plate-forme

Syst�me d’exploitation

Solaris 8, Update 7

Solaris 9, Update 7

Solaris 10

(inclut une prise en charge 32 et 64 bits pour Solaris 8, Solaris 9 et Solaris 10)

Unit� centrale

Sun UltraSPARC™

Remarque : pour un fonctionnement correct de Message Queue, vous devez installer tous les patchs Solaris requis pour Java 2 Platform, Standard Edition 5.0. Pour obtenir les derni�res informations sur les patchs requis et recommand�s et pour les t�l�charger, consultez le site :

http://java.sun.com/j2se/1.5.0/download.jsp

M�moire vive

256 Mo

Espace disque

Le fichier d’installation compress� fait environ 27 Mo.

Le r�pertoire de travail temporaire utilis� pour l’extraction des fichiers d’installation requiert 27 Mo suppl�mentaires.

Le produit install� requiert environ 27 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement.

Le Tableau 3 r�pertorie les configurations mat�rielle et logicielle requises pour les syst�mes d’exploitation Solaris x86.

Tableau 3  Mat�riel et logiciels requis pour Solaris x86

Composant

Configuration requise par la plate-forme

Syst�me d’exploitation

Solaris 9, Update 7

Solaris 10

(inclut une prise en charge 32 et 64 bits pour Solaris 9 et Solaris 10)

Unit� centrale

Intel Pentium 2 (ou compatible)

Remarque : pour un fonctionnement correct de Message Queue, vous devez installer tous les patchs Solaris requis pour Java 2 Platform, Standard Edition 5.0. Pour obtenir les derni�res informations sur les patchs requis et recommand�s et pour les t�l�charger, consultez le site :

http://java.sun.com/j2se/1.5.0/download.jsp

M�moire vive

256 Mo

Espace disque

Le fichier d’installation compress� fait environ 27 Mo.

Le r�pertoire de travail temporaire utilis� pour l’extraction des fichiers d’installation requiert 27 Mo suppl�mentaires.

Le produit install� requiert environ 27 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement.

Le Tableau 4 r�pertorie les configurations mat�rielle et logicielle requises pour les syst�mes d’exploitation Linux.

Tableau 4  Mat�riel et logiciels requis pour Linux

Composant

Configuration requise par la plate-forme

Syst�me d’exploitation

RedHat Advanced Server 2.1, Update 2

RedHat Advanced Server 3.0, Update 1

Remarque : la distribution du logiciel Message Queue inclut la version JRE requise au moment de sa commercialisation.

Unit� centrale

Intel Pentium 2 (ou compatible)

M�moire vive

256 Mo

Espace disque

Le fichier compress� du produit fait environ 18 Mo.

Le produit install� requiert environ 18 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement.

Message Queue 3 2005T1 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.

Tableau 5  Tableau des produits de base de Message Queue 3 2005T1

Plate-forme/Produit

Utilis� pour

Plate-forme/Version de produit prises en charge

Java Runtime Environment (JRE)
(versions Sun Microsystems uniquement)

Courtier Message Queue (serveur de messagerie) et outils d’administration de Message Queue

Java Runtime Environment 1.4.2_05

Java 2 Platform, Standard Edition, 5.0 (1.5) :

Solaris 8 (SPARC), Solaris 9 (SPARC et X86) et Solaris 10 (SPARC et X86)

Linux Red Hat Advanced Server 2.1, Update 2 et Linux Red Hat Advanced Server 3.0, Update 1

Windows XP Professionnel SP3, 2000 toutes �ditions SP4, Windows Server 2003 Enterprise Edition

Java Software Development Kit (JDK), Standard Edition
(versions de production Sun Microsystems uniquement)

D�veloppement et d�ploiement du client Java

(les clients Java SOAP/JAXM ne sont pris en charge que sur JDK 1.4.2 et 1.5)

JDK 1.4.2_05

Java 2 Platform, Standard Edition, 5.0 (1.5) :

Solaris (m�mes plates-formes que JRE)

Linux (m�mes plates-formes que JRE)

Windows (m�mes plates-formes que JRE)

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.

Tableau 6  Tableau des produits facultatifs de Message Queue 3 2005T1

Produit

Utilis� pour

Version de produit prise en charge

Serveur d’annuaire LDAP

Prise en charge des objets administr�s et du r�f�rentiel utilisateur de Message Queue

Sun Java System Directory Server Version 5.2 SP 3

Web Server

Prise en charge HTTP et HTTPS

Sun Java System Web Server, Enterprise Edition Version 6.1 SP 4

Application Server

Prise en charge HTTP et HTTPS

Sun Java System Application Server, Enterprise Edition 8.1

Base de donn�es

Prise en charge de la persistance enfichable

PointBase, Version 4.8

Oracle 9i, Version 9.2

JNDI

(Java Naming and Directory Interface)

Prise en charge des objets administr�s

JNDI Version 1.2.1

LDAP Service Provider Version 1.2.2

File System Service Provider Version 1.2 Beta 3 (pris en charge pour le d�veloppement et le test, mais pas pour un d�ploiement dans un environnement de production)

Compilateur C
et
biblioth�que d’ex�cution C++ compatible

Prise en charge des clients C de Message Queue

Sous Solaris : Compilateur C++ Sun WorkShop 6, Update 2 ou ult�rieur avec -compat=5, Compilateur C Sun WorkShop

Sous Linux : gcc/g++ 2.96

Sous Windows : Microsoft Windows Visual C++ 6.0, SP3

NSPR

(Netscape Portable Runtime)

Prise en charge des clients C de Message Queue

Version int�gr�e � Java Enterprise System 2005T1.

Pour l’�dition Platform Edition, ce produit est install� en tant que package partag�.

NSS

(Network Security Service)

Prise en charge des clients C de Message Queue

Version int�gr�e � Java Enterprise System 2005T1.

Pour l’�dition Platform Edition, ce produit est install� en tant que package partag�.

Bogues r�solus dans la pr�sente version

Le Tableau 7 r�pertorie les bogues r�solus dans Message Queue 3 2005T1 (3.6) :

Tableau 7  Bogues r�solus dans Message Queue 3 2005T1

R�f�rence

Description

2091749

Le courtier r�cup�re une exception de pointeur nul sur un pool de threads partag� lors de charges normales.

2092975

Le d�p�t permanent doit continuer le chargement si la d�s�rialisation �choue sur l’une des destinations.

2092976

Un message d’erreur de traitement est p�riodiquement envoy� � une rubrique lors de la fermeture d’un consommateur avec s�lecteur pendant l’acheminement du message dans le syst�me.

4888259

Les arguments vmargs sont ignor�s si plusieurs arguments sont transmis � imqbroker sous Windows.

4934433

Le code du paquet doit emp�cher la cr�ation de paquets volumineux.

4941127

Le chargement des messages dans la destination ne sera pas complet si la taille d’un message d�passe la limite autoris�e pour chaque message

4949398

imqcmd query dst donne des valeurs incorrectes lorsqu’une destination est en cours de chargement

4953659

Le client Message Queue n’appelle jamais ExceptionListener.onException lors de connexions semi-ouvertes.

4962906

Le courtier doit d�tecter une connexion � une base de donn�es p�rim�e et se reconnecter.

4969880

Receive(timeout) retourne null avant expiration du d�lai d’attente avec des fermetures fr�quentes de connexion.

4970719

Des messages avec accus�s de r�ception dans la transaction pr�par�e peuvent �tre renvoy�s aux consommateurs.

4983525

Erreur lors de la cr�ation du producteur dans la destination cr��e automatiquement sous le syst�me Linux 3.0.

4987799

L’adaptateur de ressources de Message Queue et le courtier doivent prendre en charge les abonnements partag�s pour les clusters Application Server 8.1 Enterprise Edition.

4989708

imqbrokerd se comporte toujours comme si imq.transaction.autorollback avait la valeur true.

4992645

Adaptateur de ressources de Message Queue : l’adaptateur de ressources JMS doit prendre en charge le groupement de connexions.

4996776

Le courtier renvoie une exception ConcurrentModificationExceptions avec des charges �lev�es sur le serveur lorsque la g�n�ration de mesures est activ�e.

5004868

Les transactions supprim�es ne sont pas retir�es de la base de donn�es JDBC.

5014570

L’exemple QBrowser ne fonctionne pas avec l’�dition Platform Edition.

5024685

Listes de contr�le d’acc�s : l’interaction entre queue.create.deny.user=* et imq.autocreate.queue=true fonctionne mal.

5025241

L’abonn� durable avec noLocal=true re�oit des messages auto-publi�s.

5037962

Une diff�rence entre l’�tat du courtier principal et le journal entra�ne un blocage au d�marrage.

5042763

Le code du magasin de fichiers doit utiliser FileChannel.force(false) pour am�liorer les performances E/S synchrones.

5046995

L’impl�mentation de la n�gociation de protocole du client Java de Message Queue ne fonctionne pas correctement.

5053565

Message Queue 3.5 SP1 : le courtier utilise le processeur inutilement dans un cluster avec ma�tre.

5063625

Le r�cepteur de file d’attente ne re�oit plus les messages comprenant des messages distants qui lui sont destin�s dans un cluster � deux courtiers.

6021000

Le courtier se bloque lorsque des consommateurs sont ajout�s ou supprim�s lors de charges importantes.

6057402

Le courtier principal se bloque au red�marrage si une destination comprenant des abonn�s durables a �t� supprim�e.

6057450

imqcmd : impossible de d�finir maxNumBackupConsumers sur 0 pour les files d’attente.

6155087

Les courtiers avec un nom incorrect et un abonn� durable dans un cluster se bloquent � l’arr�t.

6155091

JDBC : la commande "-reset store" est lente avec les messages volumineux et Oracle

6157943

Le service imqbrokerd ne s’arr�te pas correctement lors du red�marrage de Windows 2000.

6165743

Adaptateur de ressources de Message Queue : une utilisation r�p�t�e de connection.open/close dans des conditions de forte sollicitation peut entra�ner une exception IllegalStateException.

6165984

imqSSLIsHostTrusted n’est pas pris en compte lorsque imqAddressList est utilis� pour sp�cifier le client lors d’une connexion SSL.

6170578

Adaptateur de ressources de Message Queue :ManagedConnectionFactory doit h�riter des propri�t�s d�finies dans le bean java de l’adaptateur de ressources.

6170831

Adaptateur de ressources de Message Queue : un probl�me de synchronisation dans l’annulation du d�ploiement de MDB peut entra�ner une exception de pointeur nul si les messages sont toujours en cours de r�ception.

6174532

Les courtiers JMS d�livrent une nouvelle fois les messages d�j� consomm�s par les MDB.

6178549

La r�ex�cution de la commande cls fait perdre la liste des courtiers configur�s si -D imq.cluster.url est utilis� sur la ligne de commande

6189214

MQ_MESSAGE_ID_HEADER_PROPERTY (C) du message re�u est diff�rent de JMSMessageID du message envoy� (Java).

Informations importantes

Cette 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

Probl�mes de compatibilit�

Mises � jour de la documentation de Message Queue 3 2005T1 (3.6)

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 2005T1 (3.6) sur les plates-formes Solaris et Linux.

Installation des packages Solaris manquants (distribution de Message Queue 3 2005T1 Enterprise Edition uniquement (distribution des sous-ensembles) avec le programme d’installation de Java Enterprise System)

La distribution de Message Queue 3 2005T1 Enterprise Edition pour Solaris n’inclut pas les packages SUNWtlsu (Network Security Services Utilties) 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 2005T1.

Solution
Vous pouvez obtenir la version des packages SUNWtlsu et SUNWtlsux incluse dans Java Enterprise System 2005T1 � partir des fichiers de l’�dition Message Queue 3 2005T1 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 2005T1 (3.6).

Probl�mes de Message Queue 3 2005T1 (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

D�sapprobation des options de mot de passe     Pour des raisons de s�curit�, les options suivantes ont �t� d�sapprouv�es :

-p

-password

-dbpassword

-ldappassword

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 ci-apr�s contiennent les fichiers jar utilis�s pour prendre en charge JNDI et JSSE pour le d�ploiement et le d�veloppement client sur JDK 1.3. Ces packages sont uniquement livr�s 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 :

SUNWiqsup--Plate-forme Solaris

sun-mq-sup--Plate-forme Linux

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.

Le Tableau 8 montre les r�pertoires d’installation par d�faut des RPM Message Queue sur Linux.

Tableau 8  Emplacements d’installation par d�faut des RPM Message Queue 3 2005T1

Nom du package RPM

Emplacement d'installation par d�faut

sun-mq-config

/etc/opt/sun

sun-mq-var

/var/opt/sun

Tous les autres RPM

/opt/sun

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�.

Le Tableau 9 montre le nouveau nom des packages RPM Linux de Message Queue 3 2005T1.

Tableau 9  Packages RPM dans les fichiers Linux

RPM

Description

Remarques

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 Message Queue 3.5 vers les emplacements de fichiers Message Queue 3 2005T1 (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.

Distribution de Message Queue, Platform Edition :
Lorsque vous d�compressez la distribution, un r�pertoire rpms est cr��.

Message Queue, Enterprise Edition (fourni avec la distribution Java Enterprise System) :
Linux_x86/Product/message_queue/Packages

  Pour installer le package sun-mq-compat

Ouvrez une session superutilisateur.

À partir du r�pertoire du package RPM, utilisez la commande suivante :

rpm -ivh --nodeps sun-mq-compat-3.6-<Num�roVersion>.i386.rpm

Probl�mes relatifs � la prochaine version majeure de Message Queue

La prochaine version majeure de Message Queue peut introduire des modifications affectant la compatibilit� des clients. Cette information vous est fournie d�s maintenant de sorte que vous puissiez vous y pr�parer.

Toutes les versions de J2SE 1.3 ne seront plus prises en charge par les clients Message Queue. La prise en charge de J2SE 1.4, quant � elle, demeure.

L’emplacement des fichiers individuels install�s avec Message Queue peut �tre modifi�. Cette modification peut interrompre les applications existantes qui d�pendent de l’emplacement actuel de certains fichiers Message Queue.

Les clients Message Queue qui utilisent une version de Message Queue ant�rieure � la prochaine version majeure risquent de ne pas avoir acc�s aux nouvelles fonctionnalit�s de cette version du produit.

Mises � jour de la documentation de Message Queue 3 2005T1 (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 Enterprise System.

Pour obtenir des informations sur la mise � niveau et la migration vers Message Queue 3 2005T1 (3.6), Enterprise Edition, reportez-vous au Guide de migration et de mise � niveau de Sun Java Enterprise System.

Pr�sentation technique

Le document Message Queue Technical Overview est un nouveau document qui d�crit le produit 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.

Guide d’administration

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.

Java Client Developer’s Guide

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.

Probl�mes connus et restrictions

Cette section contient la liste des probl�mes connus de Message Queue 3 2005T1 (3.6). Les domaines suivants du produit sont abord�s :

Probl�mes d’ordre g�n�ral

Probl�mes relatifs � l’installation

Probl�mes li�s � l’administration/configuration

Probl�mes relatifs au courtier

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 :

http://developer.java.sun.com/developer/bugParade

Remarque

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 de Sun � For Developers �.

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 2005T1 (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

Dans Message Queue 3 2005T1, l’exemple de configuration du courtier pour l’utilisation d’un serveur LDAP comme r�f�rentiel utilisateur se trouve dans la zone de commentaire du fichier config.properties, et l’exemple de r�f�rentiel utilisateur LDAP du fichier default.properties a �t� comment�.

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 2005T1.

Lorsque le client JMS tente d’�tablir une connexion avec le courtier de Message Queue 3 2005T1, 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

Solution
D�finissez la propri�t� du courtier imq.user_repository.ldap.uidattr selon les instructions du guide Message Queue Administration Guide.

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 2005T1) de l’application C-API de Message Queue ou MQInitializeSSL (biblioth�que C-API de Message Queue 3 2005T1 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 2005T1 :

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�er une connexion au courtier de Message Queue en appelant MQCreateConnection avant de lancer un thread

Les plates-formes Windows limitent le nombre de connexions � un courtier qui peuvent �tre initi�es simultan�ment par TCP/IP, conform�ment � la taille maximale du backlog. Le backlog correspond � la m�moire tampon des connexions de la pile TCP : le nombre de connexions TCP simultan�es ne peut pas d�passer la taille du backlog. Par exemple, le backlog est limit� � 5 sous Windows 2000 Professionnel et � 200 sous Windows 2000 Server.

Si vous utilisez Windows XP, le nombre de connexions entrantes est limit�. Pour Windows XP Professionnel, le nombre maximal d’ordinateurs autoris�s � se connecter simultan�ment sur le r�seau est de dix. Cette limite s’applique � tous les protocoles de partage de ressources et de transport combin�s. Pour Windows XP �dition familiale, le nombre maximal d’ordinateurs autoris�s � se connecter simultan�ment sur le r�seau est de cinq. Cette limitation affecte le nombre de clients pouvant se connecter au courtier sous Windows XP.

Tout fichier, impression, canal nomm� ou session d’emplacement de messagerie inactif est automatiquement d�connect� apr�s expiration du d�lai AutoDisconnect. La valeur par d�faut du d�lai AutoDisconnect est de 15 minutes. La d�connexion d’une session lib�re l’une des dix connexions, de sorte qu’un autre utilisateur peut se connecter au syst�me Windows XP. Par cons�quent, la r�duction du d�lai AutoDisconnect peut permettre de r�soudre en partie certains des probl�mes li�s � la limite des 10 ou 5 connexions sur un syst�me peu utilis� � des fins de serveur. Pour plus d’informations, consultez le site suivant :

http://support.microsoft.com/default.aspx?scid=kb;EN-US;314882

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 :

Plate-forme

Emplacement

Solaris

/var/imq/instances/instanceName/props/config.properties

Linux

/var/opt/sun/mq/instances/instanceName/props/config.properties

Windows

IMQ_VARHOME\instances\instanceName\props\config.properties

Lorsque le fichier config.properties a �t� cr��, modifiez-le pour ajouter d’autres valeurs de propri�t�s de configuration, puis red�marrez le courtier.

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 relatifs � l’installation

Lorsque vous installez Message Queue � l’aide de l’installation personnalis�e sous Windows, si vous s�lectionnez � JDK runtime �, le programme d’installation indique � JDK 1.4 runtime � (n� 6174677)

Solution
Le programme d’installation installe JDK 1.5. Les informations affich�es � l’�cran sont incorrectes.

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 (n� 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 (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.4

     Solaris :
     /work/java 1.4

Solution
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 (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 (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. (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 (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. (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.

Le message Unknown Destination:temporary_destination s’affiche parfois � l’arr�t du courtier (n� 5055667)

Lorsqu’un courtier est arr�t� alors que des messages sont en cours de traitement vers une file d’attente temporaire, le message d’erreur suivant peut s’afficher dans les journaux :

AVERTISSEMENT [B2011] : �chec du stockage du message JMS � partir de <connexion> :
com.sun.messaging.jmq.jmsserver.util.BrokerException: Unknown
Destination:temporary_destination:<iddestination>

Solution
Ne tenez pas compte de ce message d’erreur. Cette erreur n’affecte pas la fiabilit� du courtier.

Les consommateurs sont orphelins lorsqu’une destination est d�truite (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.

Un nouveau consommateur risque de ne pas recevoir de messages dans un cluster de courtiers avec des destinations cr��es automatiquement (n� 6172794)

Si un consommateur distant est ajout� � une destination cr��e automatiquement au moment m�me o� la destination est supprim�e, il risque d’�tre ajout� � une mauvaise destination. Le consommateur ne pourra pas recevoir les messages publi�s dans cette destination.

Solution
Choisissez l’une des trois options suivantes :

Augmentez la propri�t� de courtier imq.autocreate.reaptime.

Utilisez les destinations cr��es par l’administrateur.

Fermez et rouvrez le consommateur.

Le contr�le de flux des producteurs peut s’interrompre si des producteurs sont sans cesse ajout�s � des destinations satur�es (n� 6173336)

L’interruption se produit dans les cas suivants :

La limite d’une destination est d�finie sur une valeur trop faible (<= 2 * nb max de producteurs).

La destination est d�finie sur flow_control.

Des producteurs sont fr�quemment ajout�s � la destination.
Dans ce cas, dans une boucle, chaque producteur envoie un message avant de se fermer.

Les producteurs sont ajout�s � un producteur satur�.

Solution
Proc�dez comme suit :

Augmentez la taille de la destination.

Diminuez le nombre maximal de consommateurs.

Modifiez le code de sorte que des producteurs ne soient pas ajout�s lors d’une connexion.

Impossible de s�lectionner des messages avec JMSMessageID (n� 6196233)

La s�lection de messages avec le s�lecteur "JMSMessageID = ’<id_message>’" ne fonctionne pas.

Envoyez un message � une file d’attente.

Lisez l’ID JMSMessageID du message envoy� - <id_message>.

Cr�ez un consommateur dans la file d’attente avec le s�lecteur d�fini sur "JMSMessageID = '<id_message>'"

Le message ne sera pas re�u.

Solution
Remplacez le s�lecteur :

JMSMessageID = "ID:message-id-string"

par :

JMSMessageID IN ('ID:message-id-string', 'message-id-string')

Fichiers redistribuables

Sun Java System Message Queue 3 2005T1 (3.6) contient le jeu de fichiers suivant que vous pouvez utiliser et distribuer librement sous forme binaire :

jms.jar

imq.jar

imqxm.jar

fscontext.jar

providerutil.jar

jndi.jar

ldap.jar

ldapbpjar

jaas.jar

jsse.jar

jnet.jar

jcert.jar

Vous pouvez �galement redistribuer les fichiers LICENSE et COPYRIGHT.

Comment signaler des probl�mes et apporter des commentaires

Si 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 suivante :
http://www.sun.com/service/sunone/software

Ce site contient des liens vers la base de connaissances, le centre de support en ligne et ProductTracker, ainsi que vers des programmes de maintenance et des coordonn�es pour le support.

En composant le num�ro de t�l�phone indiqu� sur votre contrat de maintenance.

Afin de vous aider au mieux � r�soudre votre probl�me, nous vous sugg�rons de r�unir les informations suivantes lorsque vous contactez le support technique de Sun :

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 core dumps.

Forum des logiciels Sun Java System

Il existe un forum Sun Java System Message Queue � l’emplacement suivant :

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

Sun attend vos commentaires

Afin 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 les 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 Notes de version de Sun Java System Message Queue 3 2005T1, et sa r�f�rence est 819-2032.

Ressources Sun suppl�mentaires

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

Documentation de Message Queue
http://docs.sun.com/coll/MessageQueue_05q1

Documentation 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. d�tient les droits de propri�t� intellectuels relatifs � la technologie incorpor�e dans le produit qui est d�crit dans ce document. En particulier, et ce sans limitation, ces droits de propri�t� intellectuelle peuvent inclure un ou plus des brevets am�ricains list�s � l’adresse http://www.sun.com/patents et un ou les brevets suppl�mentaires ou les applications de brevet en attente aux Etats - Unis et dans les 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™ ONE sont des marques de fabrique ou des marques d�pos�es de Sun Microsystems, Inc. aux Etats-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 Etats-Unis et dans d’autres pays.

UNIX est une marque d�pos�e aux �tats-Unis et dans d’autres pays, sous licence exclusive de X/Open Company, Ltd.

Plate-forme/Produit	Utilis� pour	Plate-forme/Version de produit prises en charge
Java Runtime Environment (JRE) (versions Sun Microsystems uniquement)	Courtier Message Queue (serveur de messagerie) et outils d’administration de Message Queue	Java Runtime Environment 1.4.2_05 Java 2 Platform, Standard Edition, 5.0 (1.5) : Solaris 8 (SPARC), Solaris 9 (SPARC et X86) et Solaris 10 (SPARC et X86) Linux Red Hat Advanced Server 2.1, Update 2 et Linux Red Hat Advanced Server 3.0, Update 1 Windows XP Professionnel SP3, 2000 toutes �ditions SP4, Windows Server 2003 Enterprise Edition
Java Software Development Kit (JDK), Standard Edition (versions de production Sun Microsystems uniquement)	D�veloppement et d�ploiement du client Java (les clients Java SOAP/JAXM ne sont pris en charge que sur JDK 1.4.2 et 1.5)	JDK 1.4.2_05 Java 2 Platform, Standard Edition, 5.0 (1.5) : Solaris (m�mes plates-formes que JRE) Linux (m�mes plates-formes que JRE) Windows (m�mes plates-formes que JRE)


Remarque	Sun d�cline toute responsabilit� quant � la disponibilit� des sites tiers mentionn�s. Sun ne garantit pas le contenu, la publicit�, les produits et autres mat�riaux disponibles sur ces sites ou dans ces ressources, ou accessibles par leur interm�diaire, et ne saurait en �tre tenu pour responsable. Par ailleurs, la responsabilit� de Sun ne saurait �tre engag�e en cas de dommages ou de pertes, r�els ou suppos�s, occasionn�s par, ou li�s �, l’utilisation du contenu, des produits ou des services disponibles sur ces sites ou dans ces ressources, ou accessibles par leur biais, ou encore � la confiance qui a pu leur �tre accord�e.

Date	Description des modifications
24 janvier 2005	Mise � jour avec la version finale de Sun Java System Message Queue 3 2005T1 et Java Enterprise System 2005T1.
8 novembre 2004	Premi�re version des Notes de version de Message Queue Sun Java System.

Composant	Configuration requise par la plate-forme
Syst�me d’exploitation	Solaris 8, Update 7 Solaris 9, Update 7 Solaris 10 (inclut une prise en charge 32 et 64 bits pour Solaris 8, Solaris 9 et Solaris 10)
Unit� centrale	Sun UltraSPARC™ Remarque : pour un fonctionnement correct de Message Queue, vous devez installer tous les patchs Solaris requis pour Java 2 Platform, Standard Edition 5.0. Pour obtenir les derni�res informations sur les patchs requis et recommand�s et pour les t�l�charger, consultez le site : http://java.sun.com/j2se/1.5.0/download.jsp
M�moire vive	256 Mo
Espace disque	Le fichier d’installation compress� fait environ 27 Mo. Le r�pertoire de travail temporaire utilis� pour l’extraction des fichiers d’installation requiert 27 Mo suppl�mentaires. Le produit install� requiert environ 27 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement.

Composant	Configuration requise par la plate-forme
Syst�me d’exploitation	Solaris 9, Update 7 Solaris 10 (inclut une prise en charge 32 et 64 bits pour Solaris 9 et Solaris 10)
Unit� centrale	Intel Pentium 2 (ou compatible) Remarque : pour un fonctionnement correct de Message Queue, vous devez installer tous les patchs Solaris requis pour Java 2 Platform, Standard Edition 5.0. Pour obtenir les derni�res informations sur les patchs requis et recommand�s et pour les t�l�charger, consultez le site : http://java.sun.com/j2se/1.5.0/download.jsp
M�moire vive	256 Mo
Espace disque	Le fichier d’installation compress� fait environ 27 Mo. Le r�pertoire de travail temporaire utilis� pour l’extraction des fichiers d’installation requiert 27 Mo suppl�mentaires. Le produit install� requiert environ 27 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement.

Composant	Configuration requise par la plate-forme
Syst�me d’exploitation	RedHat Advanced Server 2.1, Update 2 RedHat Advanced Server 3.0, Update 1 Remarque : la distribution du logiciel Message Queue inclut la version JRE requise au moment de sa commercialisation.
Unit� centrale	Intel Pentium 2 (ou compatible)
M�moire vive	256 Mo
Espace disque	Le fichier compress� du produit fait environ 18 Mo. Le produit install� requiert environ 18 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement.

Produit	Utilis� pour	Version de produit prise en charge
Serveur d’annuaire LDAP	Prise en charge des objets administr�s et du r�f�rentiel utilisateur de Message Queue	Sun Java System Directory Server Version 5.2 SP 3
Web Server	Prise en charge HTTP et HTTPS	Sun Java System Web Server, Enterprise Edition Version 6.1 SP 4
Application Server	Prise en charge HTTP et HTTPS	Sun Java System Application Server, Enterprise Edition 8.1
Base de donn�es	Prise en charge de la persistance enfichable	PointBase, Version 4.8 Oracle 9i, Version 9.2
JNDI (Java Naming and Directory Interface)	Prise en charge des objets administr�s	JNDI Version 1.2.1 LDAP Service Provider Version 1.2.2 File System Service Provider Version 1.2 Beta 3 (pris en charge pour le d�veloppement et le test, mais pas pour un d�ploiement dans un environnement de production)
Compilateur C et biblioth�que d’ex�cution C++ compatible	Prise en charge des clients C de Message Queue	Sous Solaris : Compilateur C++ Sun WorkShop 6, Update 2 ou ult�rieur avec -compat=5, Compilateur C Sun WorkShop Sous Linux : gcc/g++ 2.96 Sous Windows : Microsoft Windows Visual C++ 6.0, SP3
NSPR (Netscape Portable Runtime)	Prise en charge des clients C de Message Queue	Version int�gr�e � Java Enterprise System 2005T1. Pour l’�dition Platform Edition, ce produit est install� en tant que package partag�.
NSS (Network Security Service)	Prise en charge des clients C de Message Queue	Version int�gr�e � Java Enterprise System 2005T1. Pour l’�dition Platform Edition, ce produit est install� en tant que package partag�.

R�f�rence	Description
2091749	Le courtier r�cup�re une exception de pointeur nul sur un pool de threads partag� lors de charges normales.
2092975	Le d�p�t permanent doit continuer le chargement si la d�s�rialisation �choue sur l’une des destinations.
2092976	Un message d’erreur de traitement est p�riodiquement envoy� � une rubrique lors de la fermeture d’un consommateur avec s�lecteur pendant l’acheminement du message dans le syst�me.
4888259	Les arguments vmargs sont ignor�s si plusieurs arguments sont transmis � imqbroker sous Windows.
4934433	Le code du paquet doit emp�cher la cr�ation de paquets volumineux.
4941127	Le chargement des messages dans la destination ne sera pas complet si la taille d’un message d�passe la limite autoris�e pour chaque message
4949398	imqcmd query dst donne des valeurs incorrectes lorsqu’une destination est en cours de chargement
4953659	Le client Message Queue n’appelle jamais ExceptionListener.onException lors de connexions semi-ouvertes.
4962906	Le courtier doit d�tecter une connexion � une base de donn�es p�rim�e et se reconnecter.
4969880	Receive(timeout) retourne null avant expiration du d�lai d’attente avec des fermetures fr�quentes de connexion.
4970719	Des messages avec accus�s de r�ception dans la transaction pr�par�e peuvent �tre renvoy�s aux consommateurs.
4983525	Erreur lors de la cr�ation du producteur dans la destination cr��e automatiquement sous le syst�me Linux 3.0.
4987799	L’adaptateur de ressources de Message Queue et le courtier doivent prendre en charge les abonnements partag�s pour les clusters Application Server 8.1 Enterprise Edition.
4989708	imqbrokerd se comporte toujours comme si imq.transaction.autorollback avait la valeur true.
4992645	Adaptateur de ressources de Message Queue : l’adaptateur de ressources JMS doit prendre en charge le groupement de connexions.
4996776	Le courtier renvoie une exception ConcurrentModificationExceptions avec des charges �lev�es sur le serveur lorsque la g�n�ration de mesures est activ�e.
5004868	Les transactions supprim�es ne sont pas retir�es de la base de donn�es JDBC.
5014570	L’exemple QBrowser ne fonctionne pas avec l’�dition Platform Edition.
5024685	Listes de contr�le d’acc�s : l’interaction entre queue.create.deny.user=* et imq.autocreate.queue=true fonctionne mal.
5025241	L’abonn� durable avec noLocal=true re�oit des messages auto-publi�s.
5037962	Une diff�rence entre l’�tat du courtier principal et le journal entra�ne un blocage au d�marrage.
5042763	Le code du magasin de fichiers doit utiliser FileChannel.force(false) pour am�liorer les performances E/S synchrones.
5046995	L’impl�mentation de la n�gociation de protocole du client Java de Message Queue ne fonctionne pas correctement.
5053565	Message Queue 3.5 SP1 : le courtier utilise le processeur inutilement dans un cluster avec ma�tre.
5063625	Le r�cepteur de file d’attente ne re�oit plus les messages comprenant des messages distants qui lui sont destin�s dans un cluster � deux courtiers.
6021000	Le courtier se bloque lorsque des consommateurs sont ajout�s ou supprim�s lors de charges importantes.
6057402	Le courtier principal se bloque au red�marrage si une destination comprenant des abonn�s durables a �t� supprim�e.
6057450	imqcmd : impossible de d�finir maxNumBackupConsumers sur 0 pour les files d’attente.
6155087	Les courtiers avec un nom incorrect et un abonn� durable dans un cluster se bloquent � l’arr�t.
6155091	JDBC : la commande "-reset store" est lente avec les messages volumineux et Oracle
6157943	Le service imqbrokerd ne s’arr�te pas correctement lors du red�marrage de Windows 2000.
6165743	Adaptateur de ressources de Message Queue : une utilisation r�p�t�e de connection.open/close dans des conditions de forte sollicitation peut entra�ner une exception IllegalStateException.
6165984	imqSSLIsHostTrusted n’est pas pris en compte lorsque imqAddressList est utilis� pour sp�cifier le client lors d’une connexion SSL.
6170578	Adaptateur de ressources de Message Queue :ManagedConnectionFactory doit h�riter des propri�t�s d�finies dans le bean java de l’adaptateur de ressources.
6170831	Adaptateur de ressources de Message Queue : un probl�me de synchronisation dans l’annulation du d�ploiement de MDB peut entra�ner une exception de pointeur nul si les messages sont toujours en cours de r�ception.
6174532	Les courtiers JMS d�livrent une nouvelle fois les messages d�j� consomm�s par les MDB.
6178549	La r�ex�cution de la commande cls fait perdre la liste des courtiers configur�s si -D imq.cluster.url est utilis� sur la ligne de commande
6189214	MQ_MESSAGE_ID_HEADER_PROPERTY (C) du message re�u est diff�rent de JMSMessageID du message envoy� (Java).

Nom du package RPM	Emplacement d'installation par d�faut
sun-mq-config	/etc/opt/sun
sun-mq-var	/var/opt/sun
Tous les autres RPM	/opt/sun

RPM	Description	Remarques
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


Remarque	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 de Sun � For Developers �.

Plate-forme	Emplacement

Solaris	/var/imq/instances/instanceName/props/config.properties
Linux	/var/opt/sun/mq/instances/instanceName/props/config.properties
Windows	IMQ_VARHOME\instances\instanceName\props\config.properties