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

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

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



Remarque	Les commandes Message Queue utilis�es dans ce chapitre sont ex�cut�es en respectant l’emplacement du r�pertoire des fichiers ex�cutables, qui d�pend de la plate-forme du syst�me d’exploitation : Solaris : /usr/bin Linux : /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 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 :

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

Toutes les donn�es persistantes de Message Queue (messages, destinations, abonnements durables) sont automatiquement converties, le cas �ch�ant, en donn�es Message Queue version 4 au premier d�marrage du courtier. Par exemple, toutes les destinations existantes seront converties, si n�cessaire, en destinations Message Queue version 4, 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 version 2 et des courtiers Message Queue version 4, le courtier ma�tre devra �tre un courtier Message Queue version 2 (le plus ancien) et le cluster fonctionnera comme un cluster Message Queue version 2.

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 :

Vous pouvez utiliser la m�me banque d’objets et les m�mes objets g�r�s que dans la version 2, mais il est conseill� de faire migrer les objets g�r�s vers la version 4. 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 4.

Le programme d’ex�cution du client version 4 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 4. Toutefois, il ne convertit pas les objets g�r�s de la version 2 r�sidant dans la banque d’objets � partir de laquelle 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 4. Toutefois, s’ils doivent utiliser les nouveaux attributs d’objet g�r� (voir le chapitre 16 du Message Queue Administration Guide (http://docs.sun.com/doc/819-2571) pour toute information sur les attributs d’objet g�r�), ils devront �tre r��crits. (La recompilation des clients version 2 avec la version 4 indiquera quels attributs Message Queue version 2 ont �t� renomm�s dans la version 4. 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 4. Toutefois, s’ils doivent utiliser les nouveaux attributs d’objet g�r� (voir le chapitre 16 du Message Queue Administration Guide (http://docs.sun.com/doc/819-2571) 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 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 :

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

Directory Server (facultatif). Si vous souhaitez configurer Message Queue pour stocker les objets g�r�s et/ou les donn�es utilisateur dans un annuaire LDAP au lieu de les stocker localement, vous pouvez utiliser Directory Server � cet effet.

Conteneur Web (facultatif). Si vous avez besoin de la messagerie HTTP entre le client et le courtier, alors Message Queue requiert la prise en charge d’un conteneur Web de la part de Java ES Web Server, Java ES Application Server ou de conteneurs Web tiers.

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 :

Approche g�n�rale de mise � niveau. La mise � niveau est ex�cut�e � l’aide du script mqupgrade qui remplace les pr�c�dents packages logiciels par les nouveaux et fait migrer automatiquement les donn�es de configuration � partir de la version 3.

D�pendances pour la mise � niveau. �tant donn� que Message Queue pr�sente des d�pendances par rapport � un certain nombre de composants partag�s Java ES (voir le Tableau 1-6), Message Queue pour la version 4 est compatible avec les versions de tous ces composants pour la version 3. La mise � niveau de ces composants partag�s est donc facultative dans le cadre de la mise � niveau de Message Queue vers la version 4.

Compatibilit� ascendante. Message Queue pour la version 4 est totalement compatible avec la version 3 (voir Probl�mes de compatibilit�).

Annulation de la mise � niveau. Il n’existe pas d’utilitaire pour annuler la mise � niveau de Message Queue. 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 globale de la mise � niveau de Message Queue est identique pour les syst�mes d’exploitation Solaris et Linux. Les proc�dures suivantes indiquent les commandes sp�cifiques � la plate-forme ou l’emplacement des fichiers si n�cessaire.

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 :

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.

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

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

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.

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 nom_h�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 la version 4 de Message Queue.

Connectez-vous en tant que superutilisateur.

su -

Placez-vous dans le r�pertoire Tools de la distribution Java ES.

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

Ex�cutez le script mqupgrade.

D�marrez le script :

./mqupgrade

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

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

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.

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

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 :

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 nom_h�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 :

Solaris :
pkginfo | grep -i "message queue"

Linux :
rpm -qa | grep mq

Supprimez les packages de Message Queue � l’aide de la commande suivante :

Solaris :
pkgrm nomPackage
o� nomPackage est l’un des packages Message Queue. Pour supprimer plusieurs packages, s�parez leurs noms par un espace.

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 la version 3 de Message Queue.

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.

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

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.

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 nom_h�te:port]

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.

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

su -

Placez-vous dans le r�pertoire Tools de la distribution Java ES.

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

Ex�cutez le script mqupgrade.

D�marrez le script :

./mqupgrade

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

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

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.

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

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 :

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
Sun Java Enterprise System 2005Q4 Guide de mise � niveau