test

Notes de Version de Sun Java System Message Queue 4.2

Mises à jour de la documentation relative à Message Queue 4.2

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

Problèmes de compatibilité

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

Stabilité de l'interface

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

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

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

Modifications dans le jeu de documentation de Message Queue 4.2

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

Présentation technique

Le Sun Java System Message Queue 4.2 Installation Guide a été mis à jour pour inclure les nouvelles fonctions de Message Queue 4.2 et la structure mise à jour pour les clusters de coutiers haute disponibilité.

Administration Guide

Le Guide d'administration a été mis à jour pour inclure les nouvelles fonctions de Message Queue 4.2.

Informations d'installation et de mise à niveau

Le Sun Java System Message Queue 4.2 Installation Guide n'a pas été mis à jour pour inclure les nouvelles fonctions de Message Queue 4.2, en particulier la nouvelle fonctionnalité d'enregistrement de Sun Connect du programme d'installation. Ces informations sont fournies dans ces Notes de version de Message Queue

Guide du développeur pour Clients Java

LeGuide du développeur pour Clients Java n'a pas été mis à jour pour inclure les nouvelles fonctions de Message Queue 4.2. Ces informations sont fournies dans ces Notes de version de Message Queue

Guide du développeur pour Clients C

LeGuide du développeur pour Clients C n'a pas été mis à jour pour inclure les nouvelles fonctions de Message Queue 4.2. Ces informations sont fournies dans ces Notes de version de Message Queue

Guide du développeur pour Clients JMX

n'a pas été mis à jour pour inclure les nouvelles fonctions de Message Queue 4.2. Ces informations sont fournies dans ces Notes de version de Message Queue

Nouvelles métriques de destination

Message Queue 4.2 comprend de nouvelles métriques de destination peuvant être utiles lors de la surveillance des destinations dans un cluster de courtiers. Dans un cluster de courtiers, les destinations sont propagées à tous les courtiers du cluster. Toutefois, un message, une fois produit, est stocké dans une destination cible du courtier hébergeant le producteur de messages et n'est envoyé à la destination correspondante sur un autre courtier du cluster que s'il existe un consommateur actif pour cette destination. Il en résulte que les messages stockés dans une destination spécifiées dépendent du courtier dans le cluster hébergeant la destination.

Autrement dit, dans un cluster de courtiers, les messages stockés dans une destination donnée sur un courtier donné du cluster se composent de messages produits directement vers la destination et de messages envoyés à la destination à partir de courtiers distants dans le cluster. L'analyse de l'acheminement et de la livraison des messages dans un cluster de courtiers est parfois utile pour savoir, dans une destination, combien de messages sont locaux (produits localement) et distants (produits à distance).

Le tableau suivant présente deux nouvelles quantités métriques de destination physique introduites dans Message Queue 4.2. Les nouvelles quantités métriques sont disponibles via les commandes imqcmd list dst, imqcmd query dst et les nouveaux attributs JMX (reportez-vous au MBean de contrôle de destination).

Tableau 1–10 Métriques de destinations physiques

Quantité métrique 

Description 

Fichier journal ? 

metrics dstType de métriques

Sujet de métriques 

Nb de messages à distance 

Nombre actuel de messages stockés dans une mémoire et un magasin persistant produits vers un courtier distant dans un cluster. Ce nombre ne compte pas les messages inclus dans les transactions. 

Non 

Non disponible [Disponible avec la commande imqcmd query dst]

Non disponible 

Total d'octets de message à distance 

Taille totale actuelle en octets des messages stockés dans une mémoire et un magasin persistant produits vers un courtier distant dans un cluster. Cette valeur n'inclut pas les messages inclus dans les transactions. 

Non 

Non disponible

Non disponible 

Démarrage automatique de courtier sur le SE Solaris 10

Cette section décrit la façon de configurer le démarrage automatique de courtier sur les systèmes d'exploitation Solaris 10. Plutôt que d'utiliser un fichier rc pour implémenter un démarrage automatique de courtier quand un ordinateur redémarre, la procédure suivante utilise l'outil de gestion des services Solaris 10 (SMF).

Pour plus d'informations sur l'utilisation de l'outil de gestion des services, reportez-vous à la documentation de Solaris 10.

ProcedureImplémentation du démarrage automatique de courtier sur Solaris 10 OS

  1. Importer le service mqbroker dans le répertoire SMF.

    # svccfg import /var/svc/manifest/application/sun/mq/mqbroker.xml

  2. Vérifier que l'importation a été effectuée avec succès en contrôlant l'état du service mqbroker.

    # svcs mqbroker

    Le résultat affiché par la commande ressemble à celui présenté ci-dessous.


    STATE STIME FMRI
disabled 16:22:50 svc:/application/sun/mq/mqbroker:default

    Le service est initialiement affiché comme désactivé.

  3. Active le service mqbroker.

    # svcadm enable svc:/application/sun/mq/mqbroker:default

    L'activation du service mqbroker lancera le processus imqbrokerd. Un redémarrage relancera par la suite le courtier.

  4. Configurer le service mqbroker pour passer tout argument désiré à la commande imqbrokerd.

    La propriété options/server_args est utilisée pour passer des arguments à imqbrokerd. Par exemple, pour ajouter -loglevel DEBUGHIGH, procédez comme suit :


    # svccfg
svc:> select svc:/application/sun/mq/mqbroker
svc:/application/sun/mq/mqbroker> setprop options/server_args=\"-loglevel DEBUGHIGH\"
svc:/application/sun/mq/mqbroker> exit

Modifications apportées à JMX API

Message Queue prend en charge l'API d'extensions de gestion de Java (JMX) pour configurere et contrôler les fonctions de courtier par le biais d'un programme à partir d'une application client Message Queue. Message Queue 4.2 comprend les extensions pour l'API JMX servant à prendre en charge de nouvelles fonctions et fonctionnalités de la version. Les nouveaux attributs JMX, opérations et/ou clés de conversion sont définis pour les Mbeans suivants :

MBean de contrôle du gestionnaire de consommateurs

Les attributs, opérations et clés de conversion des tableaux suivants prennent en charge la fonction décrite dans Destinations multiples pour un éditeur ou un abonné.

Le nom de l'attribut suivant est défini comme des constantes statiques dans la classe d'utilitaires com.sun.messaging.jms.management.server.ConsumerAttributes .

Tableau 1–11 Attributs de contrôle du gestionnaire de consommateurs

Nom 

Type 

Paramétrable ? 

Description 

NumWildcardConsumers

Entier

Non 

Nombre de consommateurs de messages génériques associés au courtier 

Les noms des opérations suivantes sont définis comme des constantes statiques dans la classe d'utilitaires com.sun.messaging.jms.management.server.ConsumerAttributes .

Tableau 1–12 Opérations de contrôle du gestionnaire de consommateurs

Nom 

Paramètres 

Type de résultat 

Description 

getConsumerWildcards

none 

String[]

Chaînes génériques utilisées par les consommateurs actuels associés au courtier 

getNumWildcardConsumers

Chaîne générique 

Entier

Nombre de consommateurs actuels associés au courtier et utilisant la chaîne générique spécifiée 

Les clés de conversion suivantes sont défnies comme des constantes statiques dans la classe d'utilitaires com.sun.messaging.jms.management.server.ConsumerInfo.

Tableau 1–13 Clés de conversion pour des informations de consommateurs de messages

Nom 

Type de valeur 

Description 

DestinationNames

String[]

Noms de destination correspondant aux génériques utilisés par des consommateurs génériques 

Pour des destinations de sujet uniquement. 

Caractère générique

Booléenne

Consommateur générique ? 

Pour des destinations de sujet uniquement. 

MBean de configuration de destinations

Les attributs dans le tableau suivant prennent en charge la fonction décrite dans Validation des schémas des messages de charge utile XML.

Les noms des attributs suivants sont définis comme des constantes statiques dans la classe d'utilitairescom.sun.messaging.jms.management.server.DestinationAttributes .

Tableau 1–14 Attributs de configuration de destinations

Nom 

Type 

Paramétrable ? 

Description 

ValidateXMLSchemaEnabled

Booléenne

Oui 

Validation du schéma XML activée ? 

Si l'option est définie non définie ou définie sur false, alors la validation du schéma XML n'est pas activée pour la destination.

XMLSchemaURIList

Chaîne

Oui 

Liste des chaînes URI du document (XSD) du schéma XML séparées par des espaces  

Les URI pointent vers l'emplacement d'un ou plusieurs XSD à utiliser pour la validation du schéma XML, si activée.  

Mettez cette valeur entre guillemets si plusieurs URI sont spécifiés. 

Exemple : 

“http://foo/flap.xsd http://test.com/test.xsd”

Si cette propriété n'est pas définie ou null et si la validation XML est activée, la validation XML est effectuée à l'aide d'un DTD spécifié dans le document XML. 

ReloadXMLSchemaOnFailure

Booléenne

Oui 

Rechargement du schéma XML en cas d'échec activé ? 

Si l'option est définie non définie ou définie sur false, alors le schéma n'est pas rechargé en cas d'échec de la validation. 

MBean de configuration du gestionnaire de destinations

Les nouveaux attributs de MBean de configuration de destinations, ci-dessus prenant en charge la nouvelle fonction Validation des schémas des messages de charge utile XML, peuvent être utilisés pour la création d'une destination à l'aide de l'opération créer du MBean de configuration du gestionnaire des destinations.

MBean de contrôle de destination

Le premier ensemble d'attributs dans le tableau suivant prend en charge la fonction décrite dans Destinations multiples pour un éditeur ou un abonné et le second ensemble d'attributs prend en charge l'amélioration décrite dans Nouvelles métriques de destination.

Les noms des attributs suivants sont définis comme des constantes statiques dans la classe d'utilitairescom.sun.messaging.jms.management.server.DestinationAttributes .

Tableau 1–15 Attributs de contrôle de destinations

Nom 

Type 

Paramétrable ? 

Description 

NumWildcards

Entier

Non 

Nombre actuel de producteurs et de consommateurs de messages génériques associés à la destination 

Pour des destinations de sujet uniquement. 

NumWildcardProducers

Entier

Non 

Nombre actuel de producteurs de messages génériques associés à la destination  

Pour des destinations de sujet uniquement. 

NumWildcardConsumers

Entier

Non 

Nombre actuel de consommateurs de messages génériques associés à la destination  

Pour des destinations de sujet uniquement. 

NumMsgsRemote

Long

Non 

Nombre actuel de messages stockés dans une mémoire et un magasin persistant produits vers un courtier distant dans un cluster. Ce nombre ne compte pas les messages inclus dans les transactions. 

TotalMsgBytesRemote

Long

Non 

Taille totale actuelle en octets de messages stockés dans une mémoire et un magasin persistant produits vers un courtier distant dans un cluster. Cette valeur ne comprend pas les messages inclus dans les transactions. 

Les opérations dans le tableau suivant prennent en charge la fonction décrite dans Destinations multiples pour un éditeur ou un abonné.

Les noms des opérations suivantes sont définis comme des constantes statiques dans la classe d'utilitairescom.sun.messaging.jms.management.server.DestinationOperations .

Tableau 1–16 Opérations de contrôle des destinations

Nom 

Paramètres 

Type de résultat 

Description 

getWildcards

none 

String[]

Les chaînes génériques utilisées par les consommateurs et producteurs actuels associés à la destination 

Pour des destinations de sujet uniquement. 

getConsumerWildcards

none 

String[]

Chaînes génériques utilisées par les consommateurs actuels associés à la destination 

Pour des destinations de sujet uniquement. 

getProducerWildcards

none 

String[]

Les chaînes génériques utilisées par les producteurs actuels associés à la destination 

Pour des destinations de sujet uniquement. 

getNumWildcardConsumers

Chaîne générique 

Entier

Nombre de consommateurs actuels associés à la destination et utilisant la chaîne générique spécifiée 

Pour des destinations de sujet uniquement. 

getNumWildcardProducers

Chaîne générique 

Entier

Nombre de producteurs actuels associés à la destination et utilisant la chaîne générique spécifiée 

Pour des destinations de sujet uniquement. 

MBean de contrôle du gestionnaire des producteurs

Les attributs, opérations et clés de conversion dans les tableaux ci-dessous prennent en charge la fonction décrite dans Destinations multiples pour un éditeur ou un abonné.

Le nom de l'attribut suivant est défini comme des constantes statiques dans la classe d'utilitairescom.sun.messaging.jms.management.server.ProducerAttributes .

Tableau 1–17 Attributs de contrôle du gestionnaire de producteurs

Nom 

Type 

Paramétrable ? 

Description 

NumWildcardProducers

Entier

Non 

Nombre de producteurs de messages génériques associés au courtier 

Les noms des opérations suivantes sont définis comme des constantes statiques dans la classe d'utilitairescom.sun.messaging.jms.management.server.ProducerAttributes .

Tableau 1–18 Opérations de contrôle du gestionnaire de producteurs

Nom 

Paramètres 

Type de résultat 

Description 

getProducerWildcards

none 

String[]

Chaînes génériques utilisées par les producteurs actuels associés au courtier 

getNumWildcardProducers

Chaîne générique 

Entier

Nombre de producteurs actuels associés au courtier et utilisant la chaîne générique spécifiée 

Les clés de conversion suivantes sont définies comme des constantes statiques dans la classe d'utilitaires com.sun.messaging.jms.management.server.ProducerInfo.

Tableau 1–19 Clés de conversion pour des informations de producteurs de messages

Nom 

Type de valeur 

Description 

DestinationNames

String[]

Noms de destination correspondant aux génériques utilisés par des producteurs génériques 

Pour des destinations de sujet uniquement. 

Caractère générique

Booléenne

Producteur générique ? 

Pour des destinations de sujet uniquement. 

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

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

imq.user_repository.ldap.usrformat=dn

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

imq.user_repository.ldap.uidattr

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

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

Amélioration de l'authentification JAAS

L'authentification JAAS Message Queue 4.2 prend en charge l'authentification par l'adresse IP ainsi que par le nom d'utilisateur dynamique.