Chapitre 10 Message Queue

Ce chapitre décrit les procédures de mise à niveau du logiciel Message Queue de versions Java ES antérieures vers Java ES 5 (version 5) : Sun Java System Message Queue 3.7 UR1.

Ce chapitre présente les considérations relatives à la mise à niveau pour les différentes méthodes de mise à niveau prises en charge par la version 5. Il traite des mises à niveau sur les systèmes d'exploitation Solaris et Linux :

Présentation des mises à niveau de Message Queue

Mise à niveau de Message Queue à partir de Java ES version 4

Mise à niveau de Message Queue à partir de Java ES version 3

Mise à niveau de Message Queue à partir de Java ES version 2



Remarque	Les emplacements de fichier indiqués dans ce chapitre sont spécifiés en référence à un chemin de répertoire désigné comme MessageQueue-base. La valeur par défaut de MessageQueue-base dépend de la plate-forme du système d'exploitation, comme indiqué dans le tableau suivant.

Tableau 10-1 Message Queue Chemins d'accès au répertoire
Variable du chemin	SE Solaris	SE Linux
MessageQueue-base	/usr/bin	/opt/sun/mq/bin

Présentation des mises à niveau de Message Queue

Cette section présente les aspects généraux de Message Queue qui ont un impact sur la mise à niveau vers Java ES 5 (version 5) :

À propos de Message Queue pour Java ES version 5

Message Queue pour Java ES version 5 constitue une mise à jour mineure par rapport à la version 4. Il contient principalement des corrections du code sans améliorations des fonctionnalités.

Historiquement, le logiciel Message Queue comprenait deux éditions, Platform Edition et Enterprise Edition, chacune correspondant à un jeu de fonctions et une licence différente. Enterprise Edition était destinée au déploiement et à l'exécution d'applications de messagerie au sein de l'environnement de production d'une entreprise. Platform Edition était destinée principalement au développement, au débogage et au test en charge de composants et d'applications de messagerie test. Dans Message Queue pour la version 5, Platform Edition a été abandonnée et Message Queue inclut maintenant toutes ses fonctionnalités. Une mise à niveau à partir d'une version antérieure de Java ES vers la version 5 convertit toute Platform Edition installée en version de Message Queue.

Présentation de la mise à niveau de Message Queue

Le Tableau 10-2 répertorie les méthodes de mise à niveau de Message Queue vers Java ES version 5 prises en charge. Il s'applique à la fois à Solaris et Linux.

Tableau 10-2 Méthodes de mise à niveau vers Java ES 5 (version 5) : Message Queue 3.7 UR1
Version de Java ES	Message Queue Version	Approche globale	Reconfiguration requise
Version 4	Sun Java System Message Queue 2005Q4 (3.6 SP3) Enterprise Edition uniquement	Mise à niveau directe : Effectuée en utilisant le programme d'installation de Java ES.	Conversion des données effectuée automatiquement.
Version 3	Sun Java System Message Queue 2005Q1 (3.6) Enterprise Edition uniquement	Mise à niveau directe : Effectuée en utilisant le programme d'installation de Java ES.	Conversion des données effectuée automatiquement.
Version 2	Sun Java System Message Queue 2004Q2 (3.5 SP1) Enterprise Edition et Platform Edition	Mise à niveau directe : Effectuée à l'aide du script mqupgrade.	Effectuée automatiquement sur les plates-formes Solaris, et à l'aide d'un script mqmigrate sur les plates-formes Linux.
Version 1	Sun Java System Message Queue 2003Q4 (3.0.1 SP2) Enterprise Edition et Platform Edition	Mise à niveau directe non certifiée : Peut être effectuée à l'aide du script mqupgrade.1	Effectuée automatiquement sur les plates-formes Solaris, et à l'aide d'un script mqmigrate sur les plates-formes Linux.
Versions antérieures à Java ES	Sun Java System Message Queue 3.0.x et versions antérieures Enterprise Edition et Platform Edition	Mise à niveau directe non certifiée : Peut être effectuée à l'aide du programme d'installation de Java ES.

1Il peut être nécessaire de sauvegarder les fichiers suivants avant d'exécuter le script mqupgrade, puis de les restaurer après : par exemple (sous Solaris), restauration de /etc/imq/passwd et /etc/imq/accesscontrol.properties vers /var/imq/instances/nomInstance/etc/

Outre les versions Java ES de Message Queue indiquées dans le Tableau 10-2, Message Queue est également fourni avec le système d'exploitation Solaris. La mise à niveau des versions de Message Queue fournies avec Solaris vers la version 5 peut être effectuée à l'aide du programme d'installation de Java ES.

Données de Message Queue

Message Queue, comme les autres composants Java ES, utilise divers types de données, qui, pour une mise à niveau particulière, peuvent requérir une migration vers une version mise à niveau. Le tableau suivant indique le type de données qui peut être affecté par une mise à niveau du logiciel Message Queue.

Le Tableau 10-3 indique l'emplacement des données sur les systèmes Solaris. L'emplacement des systèmes Linux est semblable, mais dépend de la version de Message Queue :

Dans le Tableau 10-3, nomInstance spécifie le nom de l'instance du courtier Message Queue auquel les données sont associées.

Tableau 10-3 Utilisation des données Message Queue (SE Solaris)
Catégorie de données	Emplacement (Solaris)	Utilisation
Propriétés de configuration de l'instance de courtier	/var/imq/instances/nomInstance/props/ config.properties	Courtier et configurations de services associées
Stockage persistant pour les données d'application dynamiques	Versions 2, 3 et 4 : /var/imq/instances/nomInstance/fs350/ Version 5 : /var/imq/instances/nomInstance/fs370/ ou banque de données accessible par JDBC	Stocke les messages, destinations, abonnements durables, transactions, ainsi que d'autres données dynamiques
Objets gérés (banque d'objets)	répertoire local de votre choix ou Directory Server LDAP	Objets utilisés pour configurer les connexions client/courtier
Sécurité: référentiel utilisateur	/var/imq/instances/nomInstance/etc/passwd ou un serveur d'annuaire LDAP	Stocke les données utilisateur servant pour l'authentification et les autorisations
Sécurité: fichier de contrôle d'accès (emplacement par défaut)	/var/imq/instances/nomInstance/etc/ accesscontrol.properties	Définit les règles qui autorisent l'accès de l'utilisateur aux destinations et fonctionnalités associées
Sécurité: répertoire du fichier de mot de passe (emplacement par défaut)	/var/imq/instances/nomInstance/etc/	Stocke les informations cryptées sur le mot de passe.
Sécurité: emplacement du fichier keystore du courtier	/etc/imq/	Stocke les informations de certificat cryptées pour la sécurité de la messagerie.

Stratégie de mise à niveau de Message Queue

De manière générale, la stratégie à utiliser pour effectuer la mise à niveau de Message Queue dépend de nombreuses considérations, décrites dans le Chapter 1, "Planification des mises à niveau" : méthode de mise à niveau, dépendances entre les composants Java ES, mise à niveau sélective ou globale, déploiements portant sur plusieurs instances et ainsi de suite.

Cette section aborde spécifiquement les questions susceptibles d'influer sur votre planification de mise à niveau de Message Queue.

Problèmes de compatibilité

Message Queue pour la version 5 ne présente pas de nouvelles incompatibilités par rapport aux versions 3 et 4. Néanmoins, il existe de sérieux problèmes de compatibilité par rapport à la version 2 et aux versions antérieures. Ces problèmes de compatibilité sont abordés dans la section Problèmes de compatibilité de la version 2.

De plus, de manière générale, si vous mélangez dans un cluster des courtiers Message Queue pour la version 4 et les versions antérieures et des courtiers Message Queue pour la version 5, le courtier maître devra être un courtier de la version la plus ancienne et le cluster fonctionnera comme un cluster Message Queue de la version la plus ancienne.

Dépendances de Message Queue

Les dépendances de Message Queue par rapport à d'autres composants Java ES peuvent avoir une influence sur la procédure de mise à niveau et de reconfiguration du logiciel Message Queue. Les modifications apportées aux interfaces ou fonctions de Message Queue, par exemple, peuvent demander une version mise à niveau des composants dont dépend Message Queue. Le besoin de mettre à jour ces composants dépend de la méthode de mise à niveau spécifique.

Message Queue présente des dépendances par rapport aux composants Java ES suivants :

Composants partagés. Message Queue présente des dépendances par rapport à certains composants partagés Java ES (voir le Tableau 1-9).

Directory Server. Message Queue présente une dépendance facultative par rapport à Directory Server : vous pouvez configurer Message Queue pour qu'il stocke les objets gérés et/ou les données utilisateur dans un annuaire LDAP (Directory Server) au lieu de les stocker localement.

Conteneur Web. Message Queue présente une dépendance facultative par rapport à Web Server, Application Server ou un autre conteneur Web tiers pour la prise en charge du protocole HTTP entre le client et le courtier.

Bases de données. Message Queue présente une dépendance par rapport à Base de données Java (ou une base de données tierce) pour la fourniture de magasins de données accessibles via JDBC (par opposition à des magasins de messages simples), pour la couche de persistance de Message Queue.

Sun Cluster. Message Queue présente une dépendance facultative par rapport à Sun Cluster pour la prise en charge de la haute disponibilité.

Double mise à niveau

La mise à niveau double, qui permet à la fois la mise à niveau de Message Queue et du système d'exploitation (comme le décrit la section Mises à niveau doubles : Java ES et système d'exploitation) peut être effectuée des deux façons suivantes :

Installation d'un nouveau système d'exploitation

Sauvegardez les données de Message Queue

Reportez-vous à Données de Message Queue concernant l'emplacement des données fondamentales.

Installez le nouveau système d'exploitation.

Le système d'exploitation peut être installé sur un nouveau système (ou une zone Solaris 10) ou écraser un système de fichier existant.

Installez Message Queue version 5.

Restaurez ou migrez les données Message Queue que vous avez sauvegardées dans la section Step 1.

Lors de la mise à niveau à partir de la version 2 de Message Queue sur Linux, les données sont restaurées vers l'emplacement de la version 5.

Mise à niveau d'un système d'exploitation existant

Sauvegardez les données de Message Queue

Reportez-vous à Données de Message Queue concernant l'emplacement des données fondamentales.

Mettez à niveau le système d'exploitation.

La mise à niveau ne modifie pas le système de fichier existant.

Procédez à la mise à niveau de Message Queue vers la version 5.

Reportez-vous à la section correspondante de ce chapitre, en fonction de la méthode de mise à niveau, cette dernière ne modifie pas les données Message Queue existantes.

Lors de la mise à niveau à partir de la version 2 de Message Queue sur Linux, néanmoins, les données doivent être déplacées vers l'emplacement de la version 5.

Mise à niveau de Message Queue à partir de Java ES version 4

Cette section fournit des informations sur la mise à niveau de Message Queue à partir de Java ES 2005Q4 (version 4) vers Java ES 5 (version 5). La section aborde les thèmes suivants :

Introduction

Lors de la mise à niveau de Message Queue pour Java ES version 4 vers la version 5, tenez compte des aspects suivants du processus de mise à niveau :

Approche générale de mise à niveau. La mise à niveau s'effectue en utilisant le programme d'installation de Java ES. Le programme d'installation migre automatiquement les données de configuration à partir de la version 4. De plus, toutes les données d'application dynamiques associées à la version 4 sont converties automatiquement la première fois que imqbrokerd est exécuté. Pour un magasin basé sur fichier, cela signifie que le contenu du répertoire fs350 est copié dans un nouveau répertoire fs370. Pour un magasin JDBC, les tables de base de données subissent une simple mise à jour de version.

Mise à niveau des dépendances. Message Queue présente des dépendances par rapport à un certain nombre de composants partagés Java ES (voir le Tableau 1-9), lesquels sont tous automatiquement mis à niveau vers la version 5 par le programme d'installation de Java ES lorsque vous procédez à une mise à niveau de Message Queue.

Compatibilité ascendante. Message Queue pour la version 5 est pleinement compatible avec la version 4 au niveau des protocoles, de la compatibilité du courtier, des objets gérés, des outils d'administration et des applications clientes.

Annulation de la mise à niveau. Il n'existe pas d'utilitaire pour annuler la mise à niveau de Message Queue vers la version 4. Vous devez supprimer les composants mis à niveau et restaurer manuellement la version précédente et les données de configuration.

Problèmes relatifs à la plate-forme. L'approche de la mise à niveau de Message Queue est identique pour les systèmes d'exploitation Solaris et Linux.

Mise à niveau de Message Queue pour la version 4

Cette section explique comment effectuer une mise à niveau de Message Queue à partir de Java ES version 4 vers Java ES version 5 :

Tâches à exécuter avant la mise à niveau

Avant de mettre à niveau Message Queue, vous devez effectuer les tâches décrites ci-dessous :

Vérifier les informations sur la version actuelle

Vous pouvez déterminer la version et l'édition du logiciel Message Queue installé sur votre système en démarrant le courtier Message Queue avec l'option -version :

Tableau 10-4 Résultat de la vérification de la version de Message Queue
Version de Java ES	Numéro de version de Message Queue
Version 2	Sun Java(tm) System Message Queue 3 2004Q2 Version : 3.5
Version 3	Sun Java(tm) System Message Queue 3 2005Q1 Version : 3.6
Version 4	Sun Java(tm) System Message Queue 3 2005Q4 Version : 3.6 SP3
Version 5	Sun Java(tm) System Message Queue 3.7 Version : UR1 3.7

Mise à niveau des dépendances de Message Queue

Il est généralement recommandé de mettre à niveau tous les composants Java ES sur un même ordinateur (et dans son environnement) vers Java ES version 5. Message Queue présente des dépendances strictes pour la mise à niveau par rapport à un certain nombre de composants partagés.

Vous devez effectuer la mise à niveau des dépendances de Message Queue dans l'ordre décrit ci-dessous (en sautant les dépendances déjà mises à niveau), avant d'effectuer la mise à niveau de Message Queue. La mise à niveau des composants partagés est effectuée automatiquement par le programme d'installation de Java ES.

Composants partagés. Les instructions de synchronisation des composants partagés Java ES vers la version 5 sont présentées dans la section Mise à niveau des composants partagés Java ES. Néanmoins, tous les composants partagés requis par Message Queue sont automatiquement mis à niveau par le programme d'installation de Java ES lorsque vous effectuez la mise à niveau de Message Queue vers la version 5.

Sun Cluster (dépendance souple). Les instructions de mise à niveau de Sun Cluster vers la version 5 sont présentées dans le Chapter 3, "Logiciel Sun Cluster".

Directory Server (dépendance souple). Les instructions de mise à niveau de Directory Server vers la version 5 sont présentées dans le Chapter 5, "Directory Server".

Base de données Java (dépendance souple). Vous devez effectuer une installation complète de Base de données Java pour la version 5 lorsque vous effectuez la mise à niveau de Message Queue.

Logiciels de conteneur Web (dépendance souple). Les instructions de mise à niveau de Web Server ou d'Application Server sont présentées respectivement dans le Chapter 7, "Web Server" et le Chapter 11, "Application Server".

Sauvegarder Message Queue

De manière générale, il est conseillé de sauvegarder les données des applications utilisées au sein d'un environnement de production avant d'effectuer une mise à niveau. Notez l'emplacement du magasin persistant pour les données d'application dynamiques, qui est indiqué dans le Tableau 10-3.

Mise à niveau de la version 4 de Message Queue

Arrêtez toutes les applications clientes Message Queue en cours d'exécution.

Si Message Queue est utilisé dans un environnement Application Server, arrêtez également Application Server.

Arrêtez tous les courtiers en cours d'exécution. Le programme vous demande d'entrer un ID et un mot de passe administrateur.

imqcmd shutdown bkr [-b nomHôte:port]

Si vous ne souhaitez pas conserver les données dynamiques, le référentiel utilisateur en fichier plat et le fichier de contrôle d'accès de Message Queue associés à chaque instance de courtier, supprimez ces données à l'aide de la commande suivante :

imqbrokerd -name nomInstance -remove instance

Sinon, les données dynamiques et les informations de configuration sont conservées et utilisées pour Message Queue pour la version 5.

Connectez-vous en tant que superutilisateur.

su -

Lancez le programme d'installation de Java ES.

cd distribution Java ES version 5/arch_se
./installer

où arch_se correspond à votre plate-forme, par exemple Solaris_sparc. Utilisez l'option installer -nodisplay pour l'interface de ligne de commande.

Une fois que les pages de bienvenue et du contrat de licence se sont affichées, vous accédez à la page de sélection de composant. (Lorsque des composants installés pouvant être directement mis à niveau par le programme d’installation de Java ES sont détectés, ils sont présentés avec l’état “pouvant être mis à niveau”.)

Sélectionnez Message Queue dans la page de sélection des composants.

Confirmez la configuration de mise à niveau que vous avez spécifiée.

Les packages de Message Queue sont mis à niveau et un récapitulatif de la mise à niveau s'affiche.

Quittez le programme d'installation de Java ES.

Vérification de la mise à niveau de Message Queue

Une fois la procédure de mise à niveau terminée, vérifiez qu'elle a réussi en démarrant le courtier Message Queue avec l'option -version.

La commande renvoie le numéro de version de Java ES, ainsi que le numéro de version spécifique à Message Queue.

Tâches à exécuter après la mise à niveau

Si vous avez mis à niveau le conteneur Web et que vous utilisez le servlet de tunnel HTTP Message Queue, il est possible que vous deviez le redéployer dans le nouveau conteneur Web. Le servlet de tunnel http n'a pas été modifié entre la version 4 et la version 5. Pour plus d'informations sur la prise en charge HTTP, reportez-vous au Guide d’administration de Message Queue 3.7 UR1 (http://docs.sun.com/doc/819-4467).

De plus, si vous êtes sûr que vous n'aurez pas besoin de pouvoir annuler la mise à niveau, vous pouvez supprimer le magasin de données basé sur fichier de la version 4, qui se trouve dans le répertoire fs350 directory (voir le Tableau 10-3).

Annulation de la mise à niveau

Aucun script n'est fourni pour la restauration de Message Queue à son état antérieur à la mise à niveau. La procédure doit être exécutée manuellement en suivant les étapes ci-après :

Arrêtez toutes les applications clientes Message Queue en cours d'exécution.

Arrêtez tous les courtiers en cours d'exécution. Le programme vous demande d'entrer un ID et un mot de passe administrateur.

imqcmd shutdown bkr [-b nomHôte:port]

Si vous souhaitez supprimer les données dynamiques, le référentiel utilisateur en fichier plat et le fichier de contrôle d'accès de Message Queue associés à chaque instance de courtier, supprimez ces données à l'aide de la commande suivante :

imqbrokerd -name nomInstance -remove instance

Connectez-vous en tant qu'utilisateur root ou superutilisateur.

su -

Récupérez la liste des packages installés de Message Queue à l'aide de la commande suivante :

Sous Solaris :
pkginfo | grep -i "message queue"

Sous Linux :
rpm -qa | grep mq

Supprimez les packages de Message Queue à l'aide de la commande suivante :

Sous Solaris :
pkgrm nomPackage
où nomPackage est l'un des packages de Message Queue. Pour supprimer plusieurs packages, séparez leurs noms par un espace.

Sous Linux :
rpm -e --nodeps nomRPM
où nomRPM est l'un des composants RPM de Message Queue. Pour supprimer plusieurs composants, séparez leurs noms RPM par un espace.

Faites attention lorsque vous supprimez des packages Message Queue car d'autres produits peuvent les utiliser. La commande pkgrm vous avertit s'il existe des dépendances sur un package avant de le supprimer. Lorsque le système vous y invite, confirmez la requête de suppression en entrant y (yes).

Entrez «q » pour quitter le programme.

Quittez le shell superutilisateur.

Réinstallez Message Queue pour la version 4.

Utilisez le programme d'installation de Java ES version 4.

Restaurez les données de Message Queue pour la version 4 que vous avez sauvegardées dans la section Sauvegarder Message Queue.

Message Queue pour la version 4 fonctionnera parfaitement avec les données sauvegardées avant la mise à niveau vers la version 5.

Mise à niveau de plusieurs instances

Pour mettre à niveau un cluster Message Queue dans lequel plusieurs courtiers interagissent pour offrir un service de messagerie évolutif, vous pouvez effectuer une mise à niveau progressive au cours de laquelle le cluster reste en ligne à mesure des mises à niveau de chaque instance de Message Queue de la version 4 vers la version 5. Les deux conditions à garder en mémoire lorsque vous effectuez une mise à niveau de cluster sont les suivantes :

Sinon, la procédure est simple : vous arrêtez, mettez à niveau et redémarrez tour à tour chaque courtier jusqu'à ce que tous aient fait l'objet de la mise à niveau.

Mise à niveau de Message Queue à partir de Java ES version 3

La procédure de mise à niveau de Message Queue pour Java ES 2005Q1 (version 3) vers la version 5 est la même que pour la mise à niveau de Message Queue pour la version 4 vers la version 5.

Mise à niveau de Message Queue à partir de Java ES version 2

Cette section présente des informations sur la mise à niveau de Message Queue à partir de Java ES 2004Q2 (version 2) vers Java ES version 5. Cette section aborde les sujets suivants :

Introduction

Problèmes de compatibilité de la version 2

Mise à niveau de Message Queue pour la version 2

Mise à niveau de plusieurs instances



Remarque	Si vous procédez à une mise à niveau d'Message Queue pour la version 2 sur la plate-forme Linux, il vous faudra procéder à une double mise à niveau (pour Message Queue et le système d'exploitation). Message Queue pour la version 5 n'est pas pris en charge sur RHEL 2.1. Pour plus d’informations, reportez-vous à la section Double mise à niveau.

Introduction

Lors de la mise à niveau de Message Queue pour Java ES version 2 vers la version 5, tenez compte des aspects suivants du processus de mise à niveau :

Approche générale de mise à niveau. La mise à niveau est effectuée à l'aide du script mqupgrade qui remplace les précédents packages logiciels par les nouveaux et migre automatiquement les données de configuration à partir de la version 2.

Dépendances pour la mise à niveau. La mise à niveau de tout composant Java ES d'un ordinateur à partir de la version 2 nécessite la mise à niveau de tous les autres composants Java ES hébergés sur cet ordinateur ; la mise à niveau sélective des composants Java ES de la version 2 vers la version 5 n'est pas prise en charge. En particulier, tous les composants partagés Java ES utilisés par Message Queue doivent être mis à niveau.

Compatibilité ascendante. Message Queue pour la version 5 n'est pas totalement compatible avec la version 2, comme cela est décrit dans la section Problèmes de compatibilité de la version 2, ci-dessous.

Annulation de la mise à niveau. L'annulation de la mise à niveau pour revenir de la version 5 à la version 2 n'est pas prise en charge actuellement (voir la section Annulation de la mise à niveau).).

Problèmes relatifs à la plate-forme. L'approche générale de mise à niveau de Message Queue est identique pour les systèmes d'exploitation Solaris et Linux. En revanche, des procédures supplémentaires sont nécessaires sous Linux. Les procédures suivantes indiquent les commandes, l'emplacement des fichiers ou les procédures spécifiques à la plate-forme.

Problèmes de compatibilité de la version 2

Message Queue pour la version 5 présente les problèmes généraux de compatibilité suivants par rapport à la version 2 et aux versions antérieures.

Compatibilité des protocoles

Message Queue dépend d'un conteneur Web pour assurer le support du protocole HTTP entre les clients et le courtier Message Queue. Suite à une modification de protocole, lorsque vous utilisez Sun Java System Web Server pour fournir un conteneur Web à l'application Message Queue imqhttp.war, vous ne pouvez pas mettre à niveau le composant Web Server sans mettre à niveau également Message Queue (voir la section Tâches à exécuter après la mise à niveau, (more...) et (more...) ).

Compatibilité du courtier

Un courtier Message Queue pour la version 5 peut fonctionner en interaction avec un courtier pour la version 4, 3 ou 2 ; toutefois les modifications des propriétés du courtier et du schéma de stockage persistant par rapport à la version 2 peuvent nuire à la compatibilité.

Message Queue pour la version 5 peut utiliser les données des versions 4, 3 et 2, mais sur les systèmes Linux, les données de la version 2 doivent d'abord être migrées vers la version 5.

Lorsque vous passez à Message Queue pour la version 5, tenez compte des points suivants :

Vous pouvez utiliser les fichiers config.properties antérieurs de Message Queue. Vous pouvez également les copier vers un autre emplacement et consulter les paramètres de propriétés qu'ils contiennent lorsque vous configurez les courtiers Message Queue pour la version 5.

Toutes les données persistantes de Message Queue (messages, destinations, abonnements durables) sont automatiquement converties, le cas échéant, en données Message Queue pour la version 5 au premier démarrage du courtier. Par exemple, toutes les destinations existantes seront converties, si nécessaire, en destinations Message Queue pour la version 5, en préservant les attributs existants et en utilisant les valeurs par défaut des nouveaux attributs.

Si, dans un même cluster, vous mélangez des courtiers Message Queue pour la version 2 et des courtiers Message Queue pour la version 5, le courtier maître devra être un courtier Message Queue pour la version 2 (le plus ancien) et le cluster fonctionnera comme un cluster Message Queue pour la version 2.

Compatibilité des objets gérés

Les objets gérés de Message Queue pour la version 5 sont identiques à ceux des versions 3 et 4. Toutefois, certains objets gérés de la version 3 ont été renommés ou améliorés à l'aide de nouveaux attributs par rapport aux versions antérieures. C’est pourquoi, lors de la mise à niveau de Message Queue pour la version 2 vers la version 5, vous devez prendre en considération les éléments suivants :

Vous pouvez utiliser le même magasin d'objets et les mêmes objets gérés que dans la version 2, mais il est conseillé de migrer les objets gérés vers la version 5. La console d'administration (imqadmin) et l'utilitaire de ligne de commande ObjectManager (imqobjmgr), lorsqu'ils effectuent une opération de mise à jour, convertissent les objets gérés de la version 2 en objets de la version 5.

Le programme d'exécution du client version 5 recherche et instancie les objets gérés de la version 2 et les convertit afin qu'ils soient utilisables par les clients de la version 5. Toutefois, il ne convertit pas les objets gérés de la version 2 résidant dans le magasin d'objets à partir duquel la recherche a été effectuée.

Les clients existants de la version 2 (applications et/ou composants), à savoir les clients qui instancient directement les objets gérés au lieu de les rechercher, sont compatibles avec la version 5. Toutefois, s'ils doivent utiliser les nouveaux attributs d'objet géré (voir le chapitre 16 du Guide d’administration de Message Queue 3.7 UR1, http://docs.sun.com/doc/819-4467 pour toute information sur les attributs d'objet géré), ils devront être réécrits. La recompilation des clients version 2 avec la version 5 indiquera quels attributs Message Queue version 2 ont été renommés dans la version 5. Les anciens noms fonctionnent toujours.

Les scripts qui lancent les clients Java et définissent les valeurs d'attribut d'objet géré à l'aide d'options de ligne de commande sont compatibles avec la version 5. Toutefois, s'ils doivent utiliser les nouveaux attributs d'objet géré (voir le chapitre 16 du Guide d’administration de Message Queue 3.7 UR1, http://docs.sun.com/doc/819-4467 pour toute information sur les attributs d'objet géré), ils devront être réécrits.

Compatibilité de l’outil d’administration

En raison de l'ajout de nouvelles commandes et fonctionnalités d'administration dans la version 3, les outils d'administration de la version 5 (console d'administration et utilitaires de ligne de commande) ne fonctionnent qu'avec les courtiers des versions 3, 4 et 5. Cependant, les commandes et options de commande de la version 2 restent prises en charge.

Compatibilité du client

Les clients des versions 3 et 4 sont totalement compatibles avec Message Queue pour la version 5. Toutefois, lorsque vous effectuez une mise à niveau à partir de la version 2 vers la version 5, vous devez tenir compte des problèmes de compatibilité suivants concernant les clients Java :

Mise à niveau de Message Queue pour la version 2

Cette section explique comment effectuer une mise à niveau de Message Queue à partir de Java ES version 2 vers Java ES version 5 :

Tâches à exécuter avant la mise à niveau

Avant de mettre à niveau Message Queue, vous devez effectuer les tâches décrites ci-dessous :

Vérification des informations sur la version actuelle

Vous pouvez déterminer la version et l'édition du logiciel Message Queue installé sur votre système en démarrant le courtier Message Queue avec l'option -version :

Tableau 10-5 Résultat de la vérification de la version de Message Queue
Version de Java ES	Numéro de version de Message Queue
Version 2	Sun Java(tm) System Message Queue 3 2004Q2 Version : 3.5
Version 3	Sun Java(tm) System Message Queue 3 2005Q1 Version : 3.6
Version 4	Sun Java(tm) System Message Queue 3 2005Q4 Version : 3.6 SP3
Version 5	Sun Java(tm) System Message Queue 3.7 Version : UR1 3.7

Mise à niveau des dépendances de Message Queue

Composants partagés. Les instructions de mise à niveau des composants partagés Java ES vers la version 5 sont présentées dans le Chapter 2, "Mise à niveau des composants partagés Java ES".

Sun Cluster (dépendance souple). Les instructions de mise à niveau de Sun Cluster vers la version 5 sont présentées dans le Chapter 3, "Logiciel Sun Cluster".

Directory Server (dépendance souple). Les instructions de mise à niveau de Directory Server vers la version 5 sont présentées dans le Chapter 5, "Directory Server".

Base de données Java (dépendance souple). Vous devez effectuer une installation complète de Base de données Java pour la version 5 lorsque vous effectuez la mise à niveau de Message Queue.

Sauvegarder Message Queue

De manière générale, il est conseillé de sauvegarder les données des applications utilisées au sein d'un environnement de production avant d'effectuer une mise à niveau. Pour Solaris, les données dynamiques sont stockées dans le répertoire suivant :
/var/imq/instances/nomInstance.

Pour les autres systèmes d'exploitation, voir le Guide d’administration de Message Queue 3.7 UR1 (http://docs.sun.com/doc/819-4467).

Mise à niveau de Message Queue pour la version 2 (Solaris)

La mise à niveau de Message Queue vers Java ES version 5 utilise le script mqupgrade, qui installe les packages de la version 5.

Arrêtez toutes les applications clientes Message Queue en cours d'exécution.

Si Message Queue est utilisé dans un environnement Application Server, arrêtez également Application Server.

Arrêtez tous les courtiers en cours d'exécution. Le programme vous demande d'entrer un ID et un mot de passe administrateur.

imqcmd shutdown bkr [-b nomHôte:port]

imqbrokerd -name nomInstance -remove instance

Sinon, les données dynamiques et les informations de configuration sont conservées et utilisées pour Message Queue pour la version 5.

Connectez-vous en tant que superutilisateur.

su -

Placez-vous dans le répertoire Tools de la distribution Java ES version 5.

Sous Solaris SPARC :
cd Solaris_sparc/Product/message_queue/Tools

Sous Solaris x86 :
cd Solaris_x86/Product/message_queue/Tools

Exécutez le script mqupgrade.

Démarrez le script :

./mqupgrade

Le script mqupgrade répertorie tous les composants Message Queue installés.

Entrez y (yes) pour mettre à niveau les composants Message Queue.

Le script mqupgrade détecte et répertorie tous les fichiers de localisation installés.

Pour ne pas mettre à niveau les composants Message Queue, entrez n (no). Le script mqupgrade se fermera sans mettre à niveau les composants Message Queue.

Si vous y êtes invité, entrez y (yes) pour mettre à niveau les fichiers de localisation.

Le script mqupgrade stocke les résultats dans un fichier journal qui se trouve dans l'emplacement suivant :

/var/sadm/install/logs/Message_Queue_upgrade_'date'.log

Mise à niveau de Message Queue pour la version 2 (Linux)

La mise à niveau de Message Queue pour la version 2 vers la version 5 sous Linux est compliquée : en effet Java ES version 2 n'est pris en charge que sous RHEL 2.1, alors que Java ES version 5 n'est pas pris en charge sous RHEL 2.1. Une double mise à niveau est donc nécessaire : le système d'exploitation et Message Queue doivent être mis à niveau. Voir la section Mises à niveau doubles : Java ES et système d'exploitation.

Vous devez d'abord effectuer la mise à niveau du système d'exploitation Linux, puis effectuer la mise à niveau de toutes les dépendances de Message Queue, puis effectuer la mise à niveau de Message Queue.

La mise à niveau à partir de Message Queue pour la version 2 vers la version 5 inclut une étape de migration des données qui est inutile sur un système Solaris ; il s'agit de la migration des données de l'instance du courtier vers l'emplacement approprié pour la version 5. Pour vous permettre de conserver les données de la version 2 lors de la mise à niveau vers la version 5, Message Queue propose un outil de migration, mqmigrate, pour effectuer cette migration.

Pour effectuer la mise à niveau à partir de la version 2 vers la version 5, utilisez les mêmes instructions que dans la section Mise à niveau de Message Queue pour la version 2 (Solaris), mais exécutez le script mqmigrate (Step 6) avant de lancer le script mqupgrade (Step 7), comme indiqué dans la procédure suivante.

Arrêtez toutes les applications clientes Message Queue en cours d'exécution.

Arrêtez tous les courtiers en cours d'exécution. Le programme vous demande d'entrer un ID et un mot de passe administrateur.

imqcmd shutdown bkr [-b nomHôte:port]

imqbrokerd -name nomInstance -remove instance

Sinon, les données dynamiques et les informations de configuration sont conservées et utilisées pour Message Queue pour la version 5.

Connectez-vous en tant qu'utilisateur root ou superutilisateur.

su -

Placez-vous dans le répertoire Tools de la distribution Java ES version 5.

cd Linux_x86/Product/message_queue/Tools

Migrez les données de l'instance du courtier à l'aide de la commande suivante :

./mqmigrate

Le script mqmigrate déplace les données de configuration de l'instance de courtier version 2 vers l'emplacement approprié pour la version 5.

Exécutez le script mqupgrade.

Démarrez le script :

./mqupgrade

Le script mqupgrade répertorie tous les composants Message Queue installés.

Entrez y (yes) pour mettre à niveau les composants Message Queue.

Le script mqupgrade détecte et répertorie tous les fichiers de localisation installés.

Pour ne pas mettre à niveau les composants Message Queue, entrez n (no). Le script mqupgrade se fermera sans mettre à niveau les composants Message Queue.

Si vous y êtes invité, entrez y (yes) pour mettre à niveau les fichiers de localisation.

Le script mqupgrade stocke les résultats dans un fichier journal qui se trouve dans l'emplacement suivant :

/var/sadm/install/logs/Message_Queue_upgrade_'date'.log

Installation du package de compatibilité (Linux)

Si vous disposez de scripts ou que vos applications clientes version 2 contiennent des scripts qui dépendent de l'emplacement des fichiers installés pour la version 5, vous devrez installer le package sun-mq-compat, qui contient des liens symboliques des emplacements de fichiers de la version 2 vers ceux de la version 5.

Le package sun-mq-compat se trouve à l'emplacement où vous avez décompressé les fichiers de la distribution Java ES version 5 :

Vérification de la mise à niveau de Message Queue

Une fois la procédure de mise à niveau terminée, vérifiez qu'elle a réussi en démarrant le courtier Message Queue avec l'option -version.

La commande renvoie le numéro de version de Java ES, ainsi que le numéro de version spécifique à Message Queue.

Tâches à exécuter après la mise à niveau

Si vous utilisez le servlet de tunnel HTTP pour assurer la prise en charge du service de connexion HTTP, la mise à niveau de Message Queue à partir de la version 2 vers la version 5 a également effectué la mise à niveau du servlet. Vous devez donc le redéployer après la mise à niveau de Message Queue vers la version 5. Pour plus d'informations sur la prise en charge HTTP, reportez-vous au Guide d’administration de Message Queue 3.7 UR1 (http://docs.sun.com/doc/819-4467).

Migrez les objets gérés de la version 2 vers la version 5 en utilisant la console d'administration (imqadmin) et/ou l'utilitaire de ligne de commande ObjectManager (imqobjmgr) pour effectuer une mise à jour.

Annulation de la mise à niveau

L'annulation de la mise à niveau de Message Queue à partir de la version 2 vers la version 5 n'est pas prise en charge actuellement. Normalement, la procédure devrait être la même que pour annuler la mise à niveau à partir de la version 4 vers la version 5 (voir la section Annulation de la mise à niveau). Toutefois, comme la mise à niveau de Message Queue à partir de la version 2 vers la version 5 ne met pas à jour le registre du produit Java ES, le programme d'installation de Java ES ne peut pas réinstaller Message Queue pour la version 2.

Mise à niveau de plusieurs instances

Pour mettre à niveau un cluster Message Queue dans lequel plusieurs courtiers interagissent pour offrir un service de messagerie évolutif, vous pouvez effectuer une mise à niveau progressive au cours de laquelle le cluster reste en ligne à mesure des mises à niveau de chaque instance de Message Queue de la version 2 vers la version 5. Les deux conditions à garder en mémoire lorsque vous effectuez une mise à niveau de cluster sont les suivantes :

Sinon, la procédure est simple : vous arrêtez, mettez à niveau et redémarrez tour à tour chaque courtier jusqu'à ce que tous aient fait l'objet de la mise à niveau.

Précédent Contenu Index Suivant
Guide de mise à niveau de Sun Java Enterprise System 5 pour UNIX