Sun Java logo     Précédent      Sommaire      Index      Suivant     

Sun logo
Sun Java Enterprise System 2005Q4 Guide de mise à niveau 

Chapitre  7
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 2005 (version 4) : Sun Java System Message Queue 3 Enterprise Edition 2005Q4.

Ce chapitre propose une présentation générale des problèmes et procédures de mise à niveau de Message Queue pour les différentes méthodes de mise à niveau prises en charge par Java ES version 4. Il traite des mises à niveau sous les systèmes d’exploitation Solaris et Linux :


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 2005Q4 (version 4) :

À propos de Message Queue pour Java ES version 4

Message Queue pour Java ES version 4 ne présente que des corrections de code mineures, sans améliorations notables ni ajout de fonctions. Par conséquent, la version 4 n’introduit pas de nouveaux problèmes de compatibilité (reportez-vous à la section Problèmes de compatibilité).

Le logiciel Message Queue comprend deux éditions, Platform et Enterprise, qui correspondent chacune à un jeu de fonctions et une licence différente. L’édition Enterprise est destinée au déploiement et à l’exécution d’applications de messagerie au sein de l’environnement de production d’une entreprise. L’édition Platform est destinée principalement au développement, au débogage et au chargement de composants et d’applications de messagerie test. L’édition Platform peut être téléchargée gratuitement à partir du site Web de Sun et est également fournie avec le système d’exploitation Solaris et la plate-forme Java ES Application Server. Une mise à niveau d’une version antérieure de Java ES vers la version 4 convertit toute édition Platform installée en édition Enterprise.

Présentation de la mise à niveau de Message Queue

Le Tableau 7-1 répertorie les méthodes de mise à niveau de Message Queue vers Java ES version 4 prises en charge. Il s’applique à la fois à Solaris et Linux.

Tableau 7-1  Méthodes de mise à niveau vers Java ES version 4 Message Queue 3.6 SP3 2005Q4

Version de Java ES

Message Queue Version

Approche globale

Reconfiguration requise

Version 3

Sun Java System Message Queue
2005Q2 (3.6)
Enterprise Edition uniquement

Mise à niveau directe :
Exécutée à l’aide du script mqupgrade.

Aucun

Version 2

Sun Java System Message Queue
2004Q2 (3.5)
Enterprise Edition et Platform Edition

Mise à niveau directe :
Exécutée à l’aide du script mqupgrade.

Exécuté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
3.01 SP2
Enterprise Edition et Platform Edition

Mise à niveau directe non certifiée :
Peut être exécutée à l’aide du script mqupgrade.

Exécuté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.01 SP1 et versions antérieures
Enterprise Edition et Platform Edition

Pas de mise à niveau directe :
vous pouvez d’abord effectuer une mise à niveau vers la version 3 à l’aide des procédures fournies dans le Guide de migration et de mise à niveau de Sun Java Enterprise System 2005Q1
(http://docs.sun.com/doc/819-0062).

Mettez ensuite la version 3 à niveau vers la version 4.

 

Outre les versions Java ES de Message Queue indiquées dans le Tableau 7-1, Message Queue Platform Edition est également fourni avec le système d’exploitation Solaris. La mise à niveau des versions fournies de Message Queue vers Enterprise Edition pour la version 4 peut être effectuée par le programme d’installation de Java ES. Il suffit de sélectionner l’installation de Message Queue par le programme d’installation, comme pour une nouvelle installation, et le logiciel mettra automatiquement à niveau la version fournie, en reconfigurant Message Queue si nécessaire.

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 7-2 indique l’emplacement des données sur les systèmes Solaris. L’emplacement sur les systèmes Linux est similaire et est indiqué dans le manuel Message Queue Administration Guide (http://docs.sun.com/doc/819-2571). Dans le Tableau 7-2, nomInstance spécifie le nom de l’instance du courtier Message Queue auquel les données sont associées.

Tableau 7-2  Message Queue Utilisation des données 

Catégorie de données

Emplacement (sur 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

/var/imq/instances/nomInstance/fs350/

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.

Problèmes de compatibilité

Message Queue pour la version 4 n’introduit aucune nouvelle incompatibilité par rapport à la version 3. Les problèmes généraux de compatibilité Message Queue suivants concernent les versions antérieures à la version 3.

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 (reportez-vous à Tâches à exécuter après la mise à niveau, (more...) et (more...) ).

Compatibilité du courtier

Un courtier Message Queue version 4 peut fonctionner en interaction avec un courtier version 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 version 4 peut utiliser les données des versions 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 4.

Lorsque vous passez à Message Queue version 4, tenez compte des points suivants :

Compatibilité des objets gérés

Les objets gérés de Message Queue version 4 sont identiques à ceux de la version 3. 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 version 2 vers la version 4,vous devez prendre en considération les éléments suivants :

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 4 (console d’administration et utilitaires de ligne de commande) ne fonctionnent que sur les courtiers des versions 3 et 4. Cependant, les commandes et options de commande de la version 2 restent prises en charge.

Compatibilité du client

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

Message Queue Dépendances

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 :


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

Cette section présente des informations sur la mise à niveau de Message Queue à partir de Java ES 2005Q1 (version 3) vers Java ES version 4. Cette section aborde les sujets suivants :

Introduction

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

Mise à niveau de Message Queue pour la version 3

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

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

Avant de mettre à niveau Message Queue, réalisez les procédures décrites dans les sections ci-après. Lorsqu’une procédure est spécifique à la plate-forme, le système d’exploitation auquel elle fait référence est indiqué.

Vérifier les informations sur la version actuelle (systèmes Solaris)

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 :

imqbrokerd -version

Tableau 7-3  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

Mettre à niveau les dépendances de Message Queue

Il est en général recommandé de mettre à niveau tous les composants Java ES installés sur un ordinateur (et dans son environnement) vers Java ES version 4. Toutefois, puisque Message Queue ne requiert pas la mise à niveau des composants Java ES version 3 dont il dépend, cette tâche est facultative.

En revanche, si vous choisissez de mettre à niveau toutes les dépendances de Message Queue, vous devez le faire dans l’ordre suivant, et ce avant de mettre à niveau Message Queue. Vous pouvez ignorer tout composant déjà mis à niveau.

  1. Composants partagés :  Les instructions de mise à niveau des composants partagés Java ES vers la version 4 sont présentées dans le Chapitre 2, « Mise à niveau des composants partagés Java ES ».
  2. Directory Server (facultatif) :  Les instructions de mise à niveau de Directory Server vers la version 4 sont présentées dans le Chapitre 4, « Directory Server et Administration Server ».
  3. Logiciels de conteneur Web (facultatif) :  Les instructions de mise à niveau de Web Server ou d’Application Server sont présentées respectivement dans le Chapitre 6, « Web Server » et le Chapitre 9, « Application Server ».
Sauvegarder Message Queue

Il n’existe pas de script pour restaurer l’état antérieur de Message Queue. Comme les données de la version 4 sont compatibles avec celles de la version 3, il n’y a aucune raison de sauvegarder les données de configuration. Par ailleurs, il est inutile de sauvegarder l’image installée car vous pouvez utiliser le programme d’installation de la version 3 si vous deviez annuler la mise à niveau vers la version 4 de Message Queue pour revenir à la version 3.

Mise à niveau de la version 3 Message Queue

La mise à niveau du logiciel Message Queue vers Java ES version 4 utilise le script mqupgrade, qui installe les packages récents contenant les patchs mentionnés dans le Tableau 7-4.

Tableau 7-4  Patchs1 pour la mise à niveau de Message Queue 

Composant

SPARC

Solaris 8, 9 et 10

X86

Solaris 9 et 10

Linux

Message Queue Core

119132-06

119133-06

119136-06

Message Queue C-runtime

119134-04

119135-04

 

Message Queue
jmsclient & xmlclient

 

 

119137-04

Localisation de Message Queue

119691-03

119692-03

119693-03

1Les numéros de révision des patchs sont les numéros minimum requis pour la mise à niveau vers Java ES version 4. S’il existe des versions plus récentes, utilisez-les à la place de celles indiquées dans ce tableau.

La procédure de mise à niveau se compose des étapes suivantes :

  1. Arrêtez toutes les applications clientes Message Queue en cours d’exécution.
  2. Si Message Queue est utilisé dans un environnement Application Server, arrêtez également Application Server.

  3. Arrêtez tous les courtiers en cours d’exécution. Le programme vous demande d’entrer un ID et un mot de passe administrateur.
  4. imqcmd shutdown bkr [-b nom_hôte:port]

  5. 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 :
  6. imqbrokerd -name nomInstance -remove instance

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

  7. Connectez-vous en tant que superutilisateur.
  8. su -

  9. Placez-vous dans le répertoire Tools de la distribution Java ES.
  10. Sous Solaris SPARC :
    cd Solaris_sparc/Product/message_queue/Tools

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

    Sous Linux x86 :
    cd Linux_x86/Product/message_queue/Tools

  11. Exécutez le script mqupgrade.
    1. Démarrez le script :
    2. ./mqupgrade

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

    3. Entrez y (yes) pour mettre à niveau les composants de Message Queue.
    4. Le script mqupgrade détecte et répertorie tous les fichiers de localisation installés.

      Pour ne pas mettre à niveau les composants partagés de Message Queue, entrez n (non). Le script mqupgrade se fermera sans mettre à niveau les composants de Message Queue.

    5. Si vous y êtes invité, entrez y (yes) pour mettre à niveau les fichiers de localisation.
    6. Le script mqupgrade envoie les résultats au fichier journal qui se trouve à l’emplacement suivant :

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

Vérification de la mise à niveau de Message Queue

Une fois la procédure de mise à niveau terminée, vérifiez que le résultat obtenu est correct 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. Sinon, le servlet de tunnel HTTP n’a pas été modifié entre la version 3 et la version 4, et il est donc inutile de le redéployer après la mise à niveau de Message Queue vers la version 4. Reportez-vous au manuel Message Queue Administration Guide, (http://docs.sun.com/doc/819-2571) pour plus d’informations sur la prise en charge de HTTP.

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 :

  1. Arrêtez toutes les applications clientes Message Queue en cours d’exécution.
  2. Arrêtez tous les courtiers en cours d’exécution. Le programme vous demande d’entrer un ID et un mot de passe administrateur.
  3. imqcmd shutdown bkr [-b nom_hôte:port]

  4. 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 :
  5. imqbrokerd -name nomInstance -remove instance

  6. Connectez-vous en tant qu’utilisateur root ou superutilisateur.
  7. su -

  8. Récupérez la liste des packages installés de Message Queue à l’aide de la commande suivante :
  9. Solaris :
    pkginfo | grep -i "message queue"

    Linux :
    rpm -qa | grep mq

  10. Supprimez les packages de Message Queue à l’aide de la commande suivante :
  11. Solaris :
    pkgrm nomPackage
    nomPackage est l’un des packages Message Queue. Pour supprimer plusieurs packages, séparez leurs noms par un espace.

    Linux :
    rpm -e --nodeps NomRPM
    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).

  12. Entrez « q » pour quitter le programme.
  13. Quittez le shell superutilisateur.
  14. Réinstallez la version 3 de Message Queue.
  15. Utilisez le programme d’installation de Java ES version 3. Les données de Message Queue version 4 fonctionneront normalement.

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 3 vers la version 4. 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 2

La procédure de mise à niveau deMessage Queue pour Java ES 2004Q2 (version 2) vers la version 4 est quasiment identique à celle de mise à niveau de Message Queue pour la version 3 vers la version 4 (voir Mise à niveau de Message Queue à partir de Java ES version 3). Pour une mise à niveau à partir de la version 2, il y a cependant quelques différences entre les plates-formes de système d’exploitation.

En outre, les tâches préalables à l’installation doivent englober la mise à niveau de tous les composants partagés dont dépend Message Queue (voir le Tableau 1-6) de la version 2 à la version 4.

Les instructions de mise à niveau des composants partagés Java ES vers la version 4 sont présentées dans le Chapitre 2, « Mise à niveau des composants partagés Java ES ».

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

Utilisez les instructions de la section Mise à niveau de Message Queue à partir de Java ES version 3, en remplaçant chaque occurrence de version 3 par version 2.

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

Sur les systèmes Linux, une mise à niveau de la version 2 vers la version 4 inclut une étape de migration des données qui n’est pas nécessaire lors du passage de la version 3 à la version 4, à savoir la migration des données de l’instance du courtier vers l’emplacement approprié dans la version 4. Pour vous permettre de conserver les données de la version 2 lors de la mise à niveau vers la version 4, Message Queue propose un outil de migration, mqmigrate, pour exécuter cette migration.

Procédure de mise à niveau

Pour effectuer la mise à niveau de la version 2 à la version 3, utilisez les mêmes instructions que dans Mise à niveau de Message Queue à partir de Java ES version 3, mais exécutez le script mqmigrate avant de lancer le script mqupgrade, comme indiqué dans la procédure suivante.

  1. Arrêtez toutes les applications clientes Message Queue en cours d’exécution.
  2. Arrêtez tous les courtiers en cours d’exécution. Le programme vous demande d’entrer un ID et un mot de passe administrateur.
  3. imqcmd shutdown bkr [-b nom_hôte:port]

  4. 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 :
  5. imqbrokerd -name nomInstance -remove instance

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

  6. Connectez-vous en tant qu’utilisateur root ou superutilisateur.
  7. su -

  8. Placez-vous dans le répertoire Tools de la distribution Java ES.
  9. cd Linux_x86/Product/message_queue/Tools

  10. Migrez les données de l’instance du courtier à l’aide de la commande suivante :
  11. ./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 4.

  12. Exécutez le script mqupgrade.
    1. Démarrez le script :
    2. ./mqupgrade

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

    3. Entrez y (yes) pour mettre à niveau les composants de Message Queue.
    4. Le script mqupgrade détecte et répertorie tous les fichiers de localisation installés.

      Pour ne pas mettre à niveau les composants partagés de Message Queue, entrez n (non). Le script mqupgrade se fermera sans mettre à niveau les composants de Message Queue.

    5. Si vous y êtes invité, entrez y (yes) pour mettre à niveau les fichiers de localisation.
    6. Le script mqupgrade envoie les résultats au fichier journal qui se trouve à l’emplacement suivant :

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

Installation du package de compatibilité

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 4, 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 4.

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

Linux_x86/Product/message_queue/Packages

Suivez les étapes ci-après pour installer le package sun-mq-compat :

  1. Connectez-vous en tant qu’utilisateur root ou superutilisateur.
  2. su -

  3. À partir du répertoire Packages, utilisez la commande suivante :
  4. rpm -ivh --nodeps sun-mq-compat-3.6-RelNo.i386.rpm

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

Si vous utilisez le servlet de tunnel HTTP pour assurer le support du service de connexion HTTP, la mise à niveau de Message Queue de la version 2 à la version 4 a également mis à niveau de servlet. Vous devez donc le redéployer après la mise à niveau de Message Queue vers la version 4. Pour plus d’informations sur le support HTTP, reportez-vous au Message Queue Administration Guide, (http://docs.sun.com/doc/819-2571).

Faites migrer les objets gérés de la version 2 vers la version 4 à l’aide de la console d’administration (imqadmin) et/ou de l’utilitaire de ligne de commande ObjectManager (imqobjmgr) afin de procéder à la mise à jour.



Précédent      Sommaire      Index      Suivant     


Numéro de référence : 819-3460.   Copyright 2006 Sun Microsystems, Inc. Tous droits réservés.