Sun Java Enterprise System 2005Q4 Aktualisierungshandbuch |
Kapitel 7
Message QueueIn 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 QueueIn 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 EditionDirekte Aktualisierung:
Durch Anwendung des Skripts mqupgrade.Keine
Release 2
Sun Java System Message Queue
2004Q2 (3.5)
Platform und Enterprise EditionDirekte 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 EditionDirekte 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 EditionKeine 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.
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.
Beachten Sie bei der Aktualisierung von Message Queue auf Release 4 Folgendes:
- 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:
- Ein Release 4-Broker unterst�tzt Release 2-Clients (jedoch ohne zus�tzliche Release 4-Funktionen).
- Ein Release 4-Java-Client kann eine Verbindung zu einem Release 2-Broker herstellen (jedoch ohne zus�tzliche Release 4-Funktionen).
- C-Client-Programme werden nur mit einer Testlizenz (Platform Edition) oder einer Enterprise Edition-Lizenz von Release 2-, Release 3- oder Release 4-Brokern unterst�tzt.
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.
F�r Message Queue bestehen Abh�ngigkeiten zu folgenden Java ES-Komponenten:
- 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 3Dieser 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.
Die Release 4-Version von Message Queue ist optional von Directory Server und Web Server abh�ngig (oder Application Server), wie unter Message Queue-Abh�ngigkeiten beschrieben. Hierbei handelt es sich jedoch nicht um zwingende Aktualisierungsabh�ngigkeiten; eine Aktualisierung dieser Komponenten ist 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:
imqbrokerd -version
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.
So f�hren Sie die Aktualisierung durch
- 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/ToolsUnter Solaris x86:
cd Solaris_x86/Product/message_queue/ToolsUnter 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 2Das 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.
Anweisungen zur Aktualisierung der gemeinsam genutzten Java ES-Komponenten auf Release 4 finden Sie in Kapitel 2, „Aktualisieren der gemeinsam genutzten Java ES-Komponenten“.
Aktualisieren der Release 2-Version von Message Queue (Solaris)
Folgen Sie den Anweisungen unter Aktualisieren von Message Queue von Java ES Release 3; ersetzen Sie jedoch Verweise auf Release 3 durch Release 2.
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]
- 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 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.
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
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.
Linux_x86/Product/message_queue/Packages
So installieren Sie das sun-mq-compat-Paket
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.