Kapitel 7 Message Queue

In diesem Kapitel wird die Aktualisierung der Message Queue-Software von fr�heren Java ES-Versionen auf Java ES 2005 (Release 4) beschrieben: Sun Java System Message Queue 3 Enterprise Edition 2005Q4.

Das Kapitel enth�lt einen allgemeinen �berblick �ber die Aspekte und Verfahren bez�glich der verschiedenen Aktualisierungswege von Message Queue, die von Java ES Release 4 unterst�tzt werden. Es wird sowohl die Aktualisierung unter dem Solaris- als auch unter dem Linux-Betriebssystem ber�cksichtigt:

�berblick �ber Aktualisierungen von Message Queue

Aktualisieren von Message Queue von Java ES Release 3

Aktualisieren von Message Queue von Java ES Release 2



Hinweis	Die in diesem Kapitel verwendeten Message Queue-Befehle werden mit Bezug auf das Verzeichnis der ausf�hrbaren Dateien ausgef�hrt, das je nach Betriebssystemplattform unterschiedlich ist: Solaris: /usr/bin Linux: /opt/sun/mq/bin

�berblick �ber Aktualisierungen von Message Queue

In diesem Abschnitt werden die folgenden allgemeinen Aspekte bez�glich der Aktualisierung von Message Queue auf Java ES 2005Q4 (Release 4) beschrieben:

�ber Java ES Release 4 Message Queue

Die Java ES Release 4-Version von Message Queue beinhaltet geringf�gige Code-Korrekturen. Es wurden keine neuen Funktionen hinzugef�gt oder Verbesserungen vorgenommen. F�r Release 4 sind daher keine neuen Aspekte bez�glich Kompatibilit�t zu beachten (siehe Kompatibilit�t).

Die Message Queue-Software ist in zwei Ausgaben, der Platform Edition und der Enterprise Edition, erh�ltlich. Die Ausgaben weisen unterschiedliche Funktionalit�ten und einen unterschiedlichen Lizenzierungsumfang auf. Die Enterprise Edition ist f�r die Bereitstellung und Ausf�hrung von Messaging-Anwendungen in einer Produktionsumgebung eines Unternehmens konzipiert. Die Platform Edition wird haupts�chlich f�r die Entwicklung, die Fehlerbehebung und das Testen der Lastverteilung von Messaging-Anwendungen und -Komponenten verwendet. Die Platform Edition kann kostenlos von der Sun-Website heruntergeladen werden und ist ebenfalls im Lieferumfang des Solaris OS und der Java ES Application Server-Plattform enthalten. Bei der Aktualisierung von fr�heren Java ES-Release-Versionen auf Release 4 wird die installierte Platform Edition in die Enterprise Edition konvertiert.

Wegweiser f�r die Aktualisierung von Message Queue

Tabelle 7-1 zeigt die unterst�tzten Wege f�r die Aktualisierung von Message Queue auf Java ES Release 4. Die Tabelle gilt sowohl f�r das Solaris- als auch f�r das Linux-Betriebssystem.

Tabelle 7-1 Pfade f�r die Aktualisierung auf Java ES Release 4 Message Queue 3.6 SP3 2005Q4
Java ES Release	Message Queue Version	Allgemeiner Ansatz	Neukonfiguration erforderlich
Release 3	Sun Java System Message Queue 2005Q2 (3.6) nur Enterprise Edition	Direkte Aktualisierung: Durch Anwendung des Skripts mqupgrade.	Keine
Release 2	Sun Java System Message Queue 2004Q2 (3.5) Platform und Enterprise Edition	Direkte Aktualisierung: Durch Anwendung des Skripts mqupgrade.	Wird auf Solaris-Plattformen automatisch durchgef�hrt; f�r Linux-Plattformen steht das Skript mqmigrate zur Verf�gung.
Release 1	Sun Java System Message Queue 3.01 SP2 Platform und Enterprise Edition	Direkte Aktualisierung nicht zertifiziert. Kann jedoch mit dem Skript mqupgrade durchgef�hrt werden.	Wird auf Solaris-Plattformen automatisch durchgef�hrt; f�r Linux-Plattformen steht das Skript mqmigrate zur Verf�gung.
Versionen vor Java ES	Sun Java System Message Queue 3.01 SP1 und Vorg�ngerversionen Platform und Enterprise Edition	Keine direkte Aktualisierung: Sie k�nnen jedoch zun�chst auf Release 3 aktualisieren, wie im Java Enterprise System 2005Q1 Aktualisierungs- und Migrationshandbuch beschriebenen. (http://docs.sun.com/doc/819-2232). F�hren Sie anschlie�end eine Aktualisierung von Release 3 auf Release 4 durch.

Zus�tzlich zu den in Tabelle 7-1 aufgelisteten Message Queue Release-Versionen von Java ES ist Message Queue Platform Edition im Lieferumfang mit der Solaris-Betriebssystemsoftware enthalten. Die Aktualisierung der im Lieferumfang enthaltenen Versionen von Message Queue auf Release 4 Enterprise Edition kann mithilfe des Java ES-Installationsprogramms durchgef�hrt werden. Sie m�ssen lediglich Message Queue im Installationsprogramm zur Installation als neue Installation ausw�hlen. Das Installationsprogramm f�hrt automatisch eine Aktualisierung der im Paket enthaltenen Version durch sowie m�glicherweise notwendige Neukonfigurationen von Message Queue durch.

Message Queue-Daten

Wie andere Java ES-Komponenten auch verwendet Message Queue verschiedene Datentypen, die bei einer Aktualisierung m�glicherweise auf eine aktualisierte Version migriert werden m�ssen. Die folgende Tabelle enth�lt die Datentypen, die von einer Aktualisierung der Message Queue-Software betroffen sein k�nnen.

Tabelle 7-2 enth�lt die Speicherorte der Daten auf Solaris-Betriebssystemen. Die Speicherorte auf Linux-Systemen sind �hnlich und k�nnen dem Message Queue Administration Guide (http://docs.sun.com/doc/819-2571) entnommen werden. In Tabelle 7-2 instanceName die Message Queue-Broker-Instanz an, der die Daten zugeordnet sind.

Tabelle 7-2 Message Queue Verwendung der Daten
Datenkategorie	Speicherort (unter Solaris)	Verwendung
Konfigurationseigenschaften der Broker-Instanz	/var/imq/instances/instanceName/props/ config.properties	Konfigurationen der Broker und zugeh�riger Dienste
Persistenter Speicher f�r dynamische Anwendungsdaten	/var/imq/instances/instanceName/fs350/ oder ein JDBC-zug�nglicher Datenspeicher	Speichert Nachrichten, Ziele, dauerhafte Abonnements, Transaktionen und andere dynamische Daten
Verwaltete Objekte (Objektspeicher)	lokales Verzeichnis Ihrer Wahl oder ein LDAP-Directory Server	F�r die Konfiguration von Client/Broker-Verbindungen verwendete Objekte
Sicherheit: Benutzer-Repository	/var/imq/instances/instanceName/etc/passwd oder ein LDAP-Directory Server	Speichert Benutzerdaten f�r Authentifizierung und Autorisierung
Sicherheit: Zugriffssteuerungsdatei (Standard-Speicherort)	/var/imq/instances/instanceName/etc/ accesscontrol.properties	Legt die Regeln f�r die Autorisierung des Benutzerzugriffs auf Ziele und zusammenh�ngende Funktionen fest
Sicherheit: Passfile-Verzeichnis (Standard-Speicherort)	/var/imq/instances/instanceName/etc/	Speichert verschl�sselte Passwortinformationen
Sicherheit: Speicherort der Broker-Schl�sseldatei	/etc/imq/	Speichert verschl�sselte Zertifikatsinformationen f�r sicheres Messaging

Kompatibilit�t

F�r die Message Queue Release 4-Version bestehen neue Inkompatibilit�ten zur Release 3-Version. Die folgenden allgemeinen Aspekte beziehen sich auf die Kompatibilit�t von Message Queue zu Vorg�ngerversionen von Release 3.

Protokollkompatibilit�t

F�r Message Queue besteht eine zwingende Abh�ngigkeit zum Webcontainer, um HTTP-Protokollunterst�tzung f�r Message Queue-Clients und -Broker bereitzustellen. Aufgrund einer Protokoll�nderung muss bei Verwendung von Sun Java System Web Server f�r die Bereitstellung eines Webcontainers f�r die Message Queue-Anwendung imqhttp.war sowohl die Web Server-Komponente als auch die Message Queue aktualisiert werden (siehe Aufgaben nach der Aktualisierung auf (more...) und (more...) ).

Broker-Kompatibilit�t

Der Message Queue-Broker der Release 4-Version kann mit einem Release 3- oder Release 2-Broker zusammenarbeiten; die seit Release 2 vorgenommenen �nderungen der Broker-Eigenschaften und des Schemas f�r den persistenten Speicher k�nnen sich jedoch auf die Kompatibilit�t auswirken.

Message Queue der Release 4-Version kann Release 3- und Release 2-Daten verwenden, mit Ausnahme der Daten auf Linux-Systemen; Release 2-Daten m�ssen zun�chst in Release 4 migriert werden.

Message Queue config.properties-Dateien fr�herer Versionen k�nnen verwendet werden. Sie k�nnen diese Dateien in einem anderen Verzeichnis speichern und die darin enthaltenen Eigenschaftseinstellungen f�r die Konfiguration des Message Queue-Brokers der Release 4-Version verwenden.

Alle persistenten Message Queue-Daten (Meldungen, Ziele, dauerhafte Abonnements) werden gegebenenfalls automatisch in Release 4 Message Queue-Daten konvertiert, wenn Sie den Broker zum ersten Mal ausf�hren. Vorhandene Ziele werden beispielsweise gegebenenfalls in Release 4 Message Queue-Ziele konvertiert, wobei die vorhandenen Attributswerte beibehalten und f�r neue Attribute Standardwerte verwendet werden.

Wenn Sie Message Queue Release 2-Broker und Message Queue Release 4-Broker zusammen in einem Cluster verwenden, muss der Master-Broker ein Message Queue Release 2-Broker sein (in jedem Fall der �ltere); das Cluster wird als Message Queue Release 2-Cluster ausgef�hrt.

Kompatibilit�t der verwalteten Objekte

Die verwalteten Message Queue-Objekte der Release 4-Version sind mit den verwalteten Objekten der Release 3-Version identisch. Manche der verwalteten Objekte der Release 3-Version wurden jedoch im Vergleich zu Vorg�ngerversionen umbenannt oder durch neue Attribute erweitert. Beachten Sie daher beim Aktualisieren von Release 2 Message Queue auf Release 4 Folgendes:

Sie k�nnen denselben Objektspeicher und dieselben verwalteten Objekte, die Sie in Release 2 erstellt haben, verwenden. Es wird jedoch empfohlen, die verwalteten Objekte in Release 4 zu migrieren. Die Administrationskonsole (imqadmin) und das ObjectManager-Befehlszeilendienstprogramm (imqobjmgr) wandelt beim Aktualisierungsvorgang die verwalteten Release 2-Objekte in verwaltete Release 4-Objekte um.

Die Release 4-Client-Runtime sucht nach Release 2-verwalteteten Objekten, erstellt Instanzen von diesen Objekten und wandelt die Objekte um, sodass diese von Release 4-Clients verwendet werden k�nnen. Hierdurch werden jedoch keine verwalteten Release 2-Objekte konvertiert, die sich in dem Objektspeicher befinden, von dem aus die Suche durchgef�hrt wurde.

Vorhandene Release 2-Clients (Anwendungen und/oder Komponenten), d. h. Clients, die nicht erst nach verwalteten Objekten suchen, sondern diese direkt instanziieren, sind mit Release 4 kompatibel. Wenn die Clients jedoch die neuen verwalteten Objektattribute verwenden sollen, m�ssen diese neu geschrieben werden (Informationen zu verwalteten Objektattributen finden Sie in Kapitel 16 im Message Queue Administration Guide (http://docs.sun.com/doc/819-2571). (Um anzuzeigen, welche Message Queue Release 2-Attribute in Release 4 umbenannt wurden, f�hren Sie eine Neukompilierung durch. Die alten Namen k�nnen weiterhin verwendet werden.)

Skripte, die Java-Clients starten und verwalteten Objektattributwerte mithilfe von Befehlszeilenoptionen festlegen, sind mit Release 4 kompatibel. Wenn die Skripte jedoch die neuen verwalteten Objektattribute verwenden sollen, m�ssen diese neu geschrieben werden (Informationen zu verwalteten Objektattributen finden Sie in Kapitel 16 im Message Queue Administration Guide (http://docs.sun.com/doc/819-2571).

Kompatibilit�t des Administrationstools

Da in Release 3 neue Befehle und neue Verwaltungsfunktionen hinzugef�gt wurden, funktionieren die Release 4-Administrationstools (die Administrationskonsole und das Befehlszeilen-Dienstprogramm) nur mit Release 3- und Release 4-Brokern. S�mtliche Release 2-Befehle und -Befehlsoptionen werden jedoch weiterhin unterst�tzt.

Clientkompatibilit�t

Release 3-Clients sind vollst�ndig mit Release 4 Message Queue kompatibel. Bei der Aktualisierung von Release 2 auf Release 4 sollten Sie jedoch hinsichtlich der Java-Clients folgende Kompatibilit�tsaspekte ber�cksichtigen:

Message Queue-Abh�ngigkeiten

Message Queue-Abh�ngigkeiten zu anderen Java ES-Komponenten beeinflussen m�glicherweise das Verfahren f�r die Aktualisierung und Neukonfiguration der Message Queue-Software. �nderungen der Message Queue-Schnittstellen oder -Funktionen k�nnten beispielsweise eine aktualisierte Version der Komponenten erforderlich machen, von denen Message Queue abh�ngig ist. Welche dieser Komponenten aktualisiert werden m�ssen, h�ngt von dem jeweiligen Aktualisierungsweg ab.

Gemeinsam genutzte Komponenten. Message Queue ist von bestimmten gemeinsam genutzten Java ES-Komponenten abh�ngig (siehe Tabelle 1-6).

Directory Server (optional). Wenn Sie Message Queue so konfigurieren m�chten, dass verwaltete Objekte und/oder Benutzerdaten in einem LDAP-Verzeichnis und nicht lokal gespeichert werden, k�nnen Sie Directory Server f�r diese Zwecke verwenden.

Webcontainer (optional). Wenn Sie HTTP-Messaging zwischen Client und Broker ben�tigen, ist f�r Message Queue Webcontainer-Unterst�tzung durch Java ES Web Server, Java ES Application Server oder durch Drittanbieter-Webcontainer erforderlich.

Aktualisieren von Message Queue von Java ES Release 3

Dieser Abschnitt enth�lt Informationen zur Aktualisierung von Message Queue von Java ES 2005Q1 (Release 3) auf Java ES 2005Q4 (Release 4). In diesem Abschnitt werden folgende Themen behandelt:

Einf�hrung

Ber�cksichtigen Sie bei der Aktualisierung von Message Queue von Java ES Release 3 auf Release 4 folgende Aspekte des Aktualisierungsvorgangs:

Allgemeiner Aktualisierungsansatz. Die Aktualisierung erfolgt durch die Ausf�hrung des Skripts mqupgrade, das automatisch die Softwarepakete fr�herer Versionen durch die neuen Pakete ersetzt und die Migration der Release 3-Konfigurationsdaten vornimmt.

Aktualisierungsabh�ngigkeiten. W�hrend Message Queue von einer Reihe gemeinsam genutzter Java ES-Komponenten abh�ngt (siehe Tabelle 1-6), ist Message Queue f�r Release 4 mit der Release 3-Version s�mtlicher dieser Komponenten kompatibel. Eine Aktualisierung dieser gemeinsam genutzten Komponenten ist daher hinsichtlich der Aktualisierung von Message Queue auf Release 4 optional.

R�ckw�rtskompatibilit�t. Die Message Queue Release 4-Version ist mit Release 3 vollst�ndig kompatibel (siehe Kompatibilit�t).

Aufheben der Aktualisierung. F�r das Zur�cksetzen der Message Queue-Aktualisierung auf Release 3 steht kein Dienstprogramm zur Verf�gung. Sie m�ssen die aktualisierten Komponenten entfernen und die fr�here Version sowie Konfigurationsdaten manuell wieder herstellen.

Plattformspezifische Aspekte. Der allgemeine Ansatz f�r die Aktualisierung von Message Queue ist f�r das Solaris- und Linux-Betriebssystem identisch. In den folgenden Verfahren werden plattformspezifische Befehle bzw. Dateispeicherorte entsprechend gekennzeichnet.

Aktualisierung der Release 3-Version von Message Queue

In diesem Abschnitt wird die vollst�ndige Aktualisierung von Message Queue von Java ES Release 3 auf Java ES Release 4 beschrieben:

Aufgaben vor der Aktualisierung

Bevor Sie mit der Aktualisierung von Message Queue beginnen, f�hren Sie die in den folgenden Abschnitten beschriebenen Verfahren durch. Plattformspezifische Befehle sind durch die Angabe des jeweiligen Betriebssystems, auf das sich die Befehle beziehen, gekennzeichnet.

Aktuelle Versionsinformationen �berpr�fen (Solaris-Systeme)

Um die Version und Ausgabe von Message Queue auf Ihrem System zu ermitteln, starten Sie den Message Queue-Broker mit der Option -version:

Tabelle 7-3 Ausgabe der Versions�berpr�fung von Message Queue
Java ES Release	Message Queue-Versionsnummer
Release 2	Sun Java(tm) System Message Queue 3 2004Q2 Version: 3.5
Release 3	Sun Java(tm) System Message Queue 3 2005Q1 Version: 3.6
Release 4	Sun Java(tm) System Message Queue 3 2005Q4 Version: 3.6 SP3

Aktualisieren von Message Queue-Abh�ngigkeiten

Es wird grunds�tzlich empfohlen, alle Java ES-Komponenten auf einem Computersystem (und in einer Netzwerkumgebung) auf Java ES Release 4 zu aktualisieren. Da f�r Message Queue und Administration Server jedoch keine Aktualisierung der gemeinsam genutzten Java ES Release 3-Komponenten erforderlich ist, ist diese Aufgabe optional.

Wenn Sie jedoch s�mtliche Message Queue-Abh�ngigkeiten aktualisieren m�chten, ber�cksichtigen Sie die folgende Aktualisierungsreihenfolge f�r diese Abh�ngigkeiten, bevor Sie Message Queue aktualisieren. Bereits aktualisierte Abh�ngigkeiten k�nnen Sie �berspringen.

Gemeinsam genutzte Komponenten. Anleitungen f�r die Aktualisierung der gemeinsam genutzten Java ES-Komponenten auf Release 4 finden Sie in Kapitel 2, „Aktualisieren der gemeinsam genutzten Java ES-Komponenten“.

Directory Server (optional). Anleitungen f�r die Aktualisierung von Directory Server auf Release 4 finden Sie in Kapitel 4, „Directory Server und Administration Server“.

Webcontainer-Software (optional). Anweisungen zur Aktualisierung von Web Server und Application Server finden Sie in Kapitel 6, „Web Server“ bzw. Kapitel 9, „Application Server“.

Message Queue sichern

F�r das Zur�cksetzen von Message Queue in den urspr�nglichen Zustand steht kein Skript zur Verf�gung. Da Release 4-Daten mit Release 3-Daten kompatibel sind, ist das Sichern der Konfigurationsdaten nicht erforderlich. Das installierte Image muss ebenfalls nicht gesichert werden, da Sie das Release 3-Installationsprogramm verwenden k�nnen, wenn Sie Message Queue von Release 4 auf Release 3 zur�cksetzen m�ssen.

Aktualisieren von Release 3 Message Queue

Die Aktualisierung der Message Queue-Software auf Java ES Release 4 erfolgt durch die Ausf�hrung des Skripts mqupgrade. Das Skript installiert die „freshbitted“-Pakete, die in Tabelle 7-4 angegebenen Patches enthalten.

Tabelle 7-4 Patches1 f�r die Aktualisierung von Message Queue
Komponente	SPARC Solaris 8, 9 & 10	X86 Solaris 9 & 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
Lokalisierung von Message Queue	119691-03	119692-03	119693-03

1Diese Patch-Versionsnummern sind f�r die Aktualisierung auf Java ES Release 4 mindestens erforderlich. Wenn neuere Versionen verf�gbar sind, verwenden Sie anstelle der in dieser Tabelle genannten Versionen die neueren Versionen.

Halten Sie s�mtliche derzeit ausgef�hrten Message Queue-Client-Anwendungen an.

Wenn Message Queue in einer Application Server-Umgebung verwendet wird, beenden Sie Application Server ebenfalls.

Halten Sie s�mtliche ausgef�hrten Broker an. Sie werden zur Eingabe des Admin-Benutzernamens und des zugeh�rigen Passworts aufgefordert:

imqcmd shutdown bkr [-b hostName:port]

Wenn Sie dynamische Daten, das Flatfile-Benutzer-Repository Message Queue und die der jeweiligen Broker-Instanz zugeordnete Message Queue-Zugriffssteuerungsdatei nicht beibehalten m�chten, entfernen Sie diese Daten mit folgendem Befehl:

imqbrokerd -name instanceName -remove instance

Andernfalls werden die dynamischen Daten und Konfigurationsinformationen beibehalten und f�r Release 4 Message Queue verwendet.

Melden Sie sich als Root-Benutzer an.

su -

Wechseln Sie in das Tools-Verzeichnis der Java ES-Verteilung.

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

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

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

F�hren Sie das Skript mqupgrade aus.

Starten Sie das Skript.

./mqupgrade

Mithilfe des Skripts mqupgrade werden installierte Message Queue-Komponenten aufgelistet.

Geben Sie y (ja) ein, um die Message Queue-Komponenten zu aktualisieren.

Mithilfe des Skripts mqupgrade werden installierte Lokalisierungsdateien ermittelt und aufgelistet.

Wenn die Message Queue-Komponenten nicht aktualisiert werden sollen, geben Sie n (nein) ein. Mithilfe des Skripts mqupgrade wird der Vorgang beendet, ohne dass Message Queue-Komponenten aktualisiert werden.

Geben Sie y (ja) ein, um Lokalisierungsdateien zu aktualisieren.

Vom mqupgrade-Skript wird eine Ausgabe an die Protokolldatei gesendet, die sich hier befindet:

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

�berpr�fen der Message Queue-Aktualisierung

�berpr�fen Sie nach Durchf�hrung des Aktualisierungsverfahrens, ob die Aktualisierung erfolgreich war, indem Sie den Message Queue-Broker mit der Option -version starten.

Der Befehl gibt die Java ES-Versionsnummer sowie die Message Queue-spezifische Versionsnummer zur�ck.

Aufgaben nach der Aktualisierung

Wenn Sie den Webcontainer aktualisiert haben und das HTTP-Tunneling-Servlet von Message Queue verwenden, m�ssen Sie es m�glicherweise erneut im Webcontainer bereitstellen. Im �brigen wurden in Release 4 seit Release 3 keine �nderungen des HTTP-Tunneling-Servlets vorgenommen; daher muss bei einer Aktualisierung von Message Queue auf Release 4 das Servlet nicht erneut bereitgestellt werden. Weitere Informationen zu HTTP-Unterst�tzung finden Sie im Message Queue Administration Guide, (http://docs.sun.com/doc/819-2571)

Aufheben der Aktualisierung

F�r das Zur�cksetzen von Message Queue in den Zustand vor der Aktualisierung stehen keine Skripte zur Verf�gung. Der Vorgang muss wie folgt manuell durchgef�hrt werden:

Halten Sie s�mtliche derzeit ausgef�hrten Message Queue-Client-Anwendungen an.

Halten Sie s�mtliche ausgef�hrten Broker an. Sie werden zur Eingabe des Admin-Benutzernamens und des zugeh�rigen Passworts aufgefordert:

imqcmd shutdown bkr [-b hostName:port]

Wenn Sie dynamische Daten, das Flatfile-Benutzer-Repository Message Queue und die der jeweiligen Broker-Instanz zugeordnete Message Queue-Zugriffssteuerungsdatei l�schen m�chten, entfernen Sie diese Daten mit folgendem Befehl:

imqbrokerd -name instanceName -remove instance

Melden Sie sich als Root oder Superuser an.

su -

Rufen Sie mit folgendem Befehl die Liste der installierten Message Queue-Pakete ab:

Solaris:
pkginfo | grep -i "message queue"

Linux:
rpm -qa | grep mq

Entfernen Sie mit folgendem Befehl die Message Queue-Pakete:

Solaris:
pkgrm packageName
Dabei steht packageName f�r ein beliebiges Message Queue-Paket. Wenn Sie mehrere Pakete entfernen m�chten, trennen Sie die Paketnamen durch ein Leerzeichen.

Linux:
rpm -e --nodeps RPMName
Dabei steht RPMName f�r eine der Message Queue-RPM-Komponenten. Wenn Sie mehrere Komponenten entfernen m�chten, trennen Sie die RPM-Namen durch ein Leerzeichen.

Da die Message Queue-Pakete m�glicherweise von anderen Produkten verwendet werden, sollten Sie beim Entfernen vorsichtig vorgehen. Durch den Befehl pkgrm werden Sie gewarnt, ob Abh�ngigkeiten mit einem Paket bestehen, bevor dieses entfernt wird. Geben Sie bei der entsprechenden Aufforderung Ihre Anforderung zum Entfernen j (ja) ein.

Geben Sie zum Beenden „q“ ein.

Verlassen Sie die Root-Shell.

Installieren Sie Release 3 Message Queue erneut.

Verwenden Sie das Java ES Release 3-Installationsprogramm. Die Message Queue-Daten der Release 4-Version k�nnen verwendet werden.

Aktualisierung mehrerer Instanzen

Um ein Message Queue-Cluster zu aktualisieren, in dem mehrere Broker zusammenarbeiten, um einen skalierbaren Meldungsdienst bereitzustellen, k�nnen Sie ein Rolling Upgrade durchf�hren, bei dem der Cluster online bleibt, w�hrend die einzelnen Message Queue-Instanzen nacheinander von Release 3 auf Release 4 aktualisiert werden. Beachten Sie bei der Aktualisierung eines Clusters die folgenden zwei Bedingungen:

Andernfalls handelt es sich um ein unkompliziertes Verfahren: Sie beenden, aktualisieren und starten die einzelnen Broker nacheinander neu, bis alle Broker aktualisiert sind.

Aktualisieren von Message Queue von Java ES Release 2

Das Verfahren zur Aktualisierung von Message Queue von Java ES 2004Q2 (Release 2) auf Release 4 entspricht in etwa dem Verfahren zur Aktualisierung der Release 3-Version von Message Queue auf Release 4 (siehe Aktualisieren von Message Queue von Java ES Release 3). Bei der Aktualisierung von Release 2 bestehen jedoch geringe Unterschiede f�r die jeweilige Betriebssystemplattform.

Zudem sollten vor der Aktualisierung alle gemeinsam genutzten Komponenten, von denen Message Queue abh�ngt (siehe Tabelle 1-6), von der Release 2-Version auf Release 4 aktualisiert werden.

Aktualisieren der Release 2-Version von Message Queue (Solaris)

Aktualisieren der Release 2-Version von Message Queue (Linux)

Bei der Aktualisierung von Release 2 auf Release 4 unter Linux ist, im Gegensatz zur Aktualisierung von Release 3 auf Release 4, die Migration von Daten vorgesehen: Die Broker-Instanzdaten m�ssen in den entsprechenden Release 4-Speicherort migriert werden. Wenn Sie Ihre Release 2-Daten bei der Aktualisierung auf Release 4 beibehalten m�chten, f�hren Sie die Migration mit dem Migrationstool mqmigrate von Message Queue durch.

Aktualisierungsverfahren

Um eine Aktualisierung von Release 2 auf Release 3 durchzuf�hren, folgen Sie den Anweisungen unter Aktualisieren von Message Queue von Java ES Release 3. F�hren Sie jedoch das Skript mqmigrate wie folgt aus, bevor Sie das Skript mqupgrade ausf�hren:

Halten Sie s�mtliche derzeit ausgef�hrten Message Queue-Client-Anwendungen an.

Halten Sie s�mtliche ausgef�hrten Broker an. Sie werden zur Eingabe des Admin-Benutzernamens und des zugeh�rigen Passworts aufgefordert:

imqcmd shutdown bkr [-b hostName:port]

imqbrokerd -name instanceName -remove instance

Andernfalls werden die dynamischen Daten und Konfigurationsinformationen beibehalten und f�r Release 4 Message Queue verwendet.

Melden Sie sich als Root oder Superuser an.

su -

Wechseln Sie in das Tools-Verzeichnis der Java ES-Verteilung.

cd Linux_x86/Product/message_queue/Tools

Migrieren Sie Broker-Instanzdaten mithilfe dieses Befehls:

./mqmigrate

Das Skript mqmigrate verschiebt die Konfigurationsdaten der Release 2-Broker-Instanz in das entsprechende Verzeichnis der Release 4-Version.

F�hren Sie das Skript mqupgrade aus.

Starten Sie das Skript.

./mqupgrade

Mithilfe des Skripts mqupgrade werden installierte Message Queue-Komponenten aufgelistet.

Geben Sie y (ja) ein, um die Message Queue-Komponenten zu aktualisieren.

Mithilfe des Skripts mqupgrade werden installierte Lokalisierungsdateien ermittelt und aufgelistet.

Geben Sie y (ja) ein, um Lokalisierungsdateien zu aktualisieren.

Vom mqupgrade-Skript wird eine Ausgabe an die Protokolldatei gesendet, die sich hier befindet:

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

Installation des Kompatibilit�tspakets

Wenn Sie �ber Skripte verf�gen, die vom Speicherort der installierten Release 4-Dateien abh�ngen, oder Ihre Release 2-Client-Anwendungen solche Skripte enthalten, m�ssen Sie das Paket sun-mq-compat installieren. Das Paket enth�lt Symlinks von den Speicherorten der Release 2-Dateien zu den Speicherorten der Release 4-Dateien.

Das sun-mq-compat-Paket befindet sich im nachfolgendem Verzeichnis, in das Sie die Java ES-Verteilung entzippt haben.

Aufgaben nach der Aktualisierung

Wenn Sie das HTTP-Tunneling-Servlet verwenden, um Unterst�tzung f�r den HTTP-Verbindungsdienst bereitzustellen, wurde das Servlet bei der Message Queue-Aktualisierung von Release 2 auf Release 4 aktualisiert. Das hei�t, Sie m�ssen das Servlet nach der Aktualisierung von Message Queue auf Release 4 erneut bereitstellen. Weitere Informationen zur HTTP-Unterst�tzung finden Sie im Message Queue Administration Guide, (http://docs.sun.com/doc/819-2571).

Migrieren Sie mithilfe der Administrationskonsole (imqadmin) die verwalteten Release 2-Objekte in die Release 4-Versionen und/oder f�hren Sie mit dem ObjectManager-Befehlszeilendienstprogramm (imqobjmgr) eine Aktualisierung durch.

Zur�ck Inhalt Index Weiter
Sun Java Enterprise System 2005Q4 Aktualisierungshandbuch