Sun Java System Message Queue 3.7 UR1 - Versionshinweise für Microsoft Windows

Kapitel 1 Sun Java System Message Queue 3.7 UR1 – Versionshinweise für Microsoft Windows

Diese Versionshinweise enthalten wichtige Informationen, die zum Zeitpunkt der Herausgabe von Sun Java™ System Message Queue 3.7 UR1 ("Message Queue") zur Verfügung standen. In diesem Dokument werden neue Funktionen und Verbesserungen, bekannte Probleme und Einschränkungen beschrieben und weitere Informationen bereitgestellt. Lesen Sie dieses Dokument sorgfältig, bevor Sie Message Queue verwenden.

Die neueste Ausgabe dieser Versionshinweise finden Sie in der Sun-Dokumentation auf der Website unter http://docs.sun.com. Besuchen Sie diese Website vor der Installation und Konfiguration Ihrer Software und später regelmäßig, um stets die neuesten Versionshinweise und Produktdokumentationen verfügbar zu haben.

In diesen Versionshinweisen werden die folgenden Themen behandelt:

In der vorliegenden Dokumentation wird auf URLs von Drittanbietern verwiesen, über die zusätzliche relevante Informationen zur Verfügung gestellt werden.

Sun ist nicht haftbar für die Verfügbarkeit der Websites Dritter, die in diesem Dokument erwähnt werden. Sun ist nicht verantwortlich oder haftbar für die Inhalte, Werbung, Produkte oder andere Materialien, die auf solchen Websites/Ressourcen oder über diese verfügbar sind, und unterstützt diese nicht. Sun lehnt jede Verantwortung oder Haftung für direkte oder indirekte Schäden oder Verluste ab, die durch die bzw. in Verbindung mit der Verwendung von oder der Stützung auf derartige Inhalte, Waren oder Dienstleistungen, die auf oder über diese Sites oder Ressourcen verfügbar sind, entstehen können.

Grundlegendes zu Message Queue 3.7 UR1

Sun Java System Message Queue ist ein leistungsfähiger Nachrichtendienst, der ein zuverlässiges, asynchrones Messaging gemäß JMS 1.1 (Java Messaging Specification) bietet. Zusätzlich stellt Message Queue Funktionen bereit, die über die JMS-Spezifikation hinausgehen, um den Anforderungen großer Bereitstellungen im Unternehmensbereich gerecht zu werden.

Message Queue 3.7 UR1 ist ein Maintenance-Release von Message Queue 3.6, der verschiedene Fixes für die Fehlerbeseitigung sowie ein paar kleinere Verbesserungen umfasst. Der vorliegende Abschnitt umfasst die folgenden Informationen:

Neue Funktionen in dieser Version

Im folgenden Abschnitt werden die neuen Funktionen von Message Queue 3.7 UR1 beschrieben.

Kombination der Funktionen von Platform Edition und Enterprise Edition in einer Edition

Zur Rationalisierung der Produktlinie werden die Funktionen der Platform Edition und der Enterprise Edition von Sun Java Message Queue kombiniert. Ab Message Queue 3.7 UR1 wird nur noch eine Edition bereitgestellt. Durch diese Strategie fallen die Funktionseinschränkungen der eigenständigen Distributionen weg. Auf diese Weise soll die Verwendung des Produkts vereinfacht werden.

Die Kombination der verschiedenen Editionen ermöglicht ferner eine bessere Anbindung von Message Queue an das Solaris Enterprise System, und bietet die Möglichkeit zur allgemeinen Nutzung der Enterprise Edition-Funktionen, jedoch ohne Anspruch auf Support, Wartung oder Haftung. Wie bei vorherigen Versionen werden weiterhin verschiedene Lizenzierungsoptionen für Support- und Wartungsdienste bereitgestellt. Message Queue wird weiterhin im Paket mit Java Enterprise System und der Application Platform Suite bereitgestellt. Bitte besuchen Sie den Sun-Onlinestore unter http://www.sun.com, oder wenden Sie sich an Ihren Vertriebsbeauftragten, um die optimal auf Ihre Anforderungen abgestimmte Option zu ermitteln. In der nachfolgenden Tabelle werden die Upgrade-Pfade auf die neue Einzel-Edition von Message Queue beschrieben.

Tabelle 1–1 Upgrade-Pfade für Message Queue 3.7 UR1

Vorherige Edition 

Upgrade-Pfad 

Kommentare 

Platform Edition 

Sun Java System Message Queue 3.7 UR1 

Diesen Kunden stehen ab sofort alle Funktionen zur Verfügung. Ohne den Erwerb einer Lizenz sind keine Support-Optionen verfügbar. 

Enterprise Edition 

Sun Java System Message Queue 3.7 UR1 

Keine Änderungen am Funktionsumfang. Es stehen verschiedene Lizenzierungs- und Support-Optionen zur Verfügung. 

Platform Edition-Support-Verträge 

Upgrade auf Enterprise Edition-Support-Vertrag. 

Vorhandene Support-Verträge für Vorgängerversionen der Platform Edition werden weiterhin erneuert. Für vorherige Versionen der Platform Edition werden keine neuen Verträge abgeschlossen. 

Enterprise Edition-Support-Verträge 

Keine Änderung. 

Vorhandene Verträge werden weiterhin erneuert. Es werden weiterhin neue Verträge abgeschlossen. 

In der nachstehenden Tabelle werden die Änderungen in Bezug auf die Bereitstellung für die verschiedenen Message Queue-Produkte beschrieben.

Tabelle 1–2 Änderungen in Bezug auf die Bereitstellung von Message Queue-Produkten

Produkt 

Bisherige Bereitstellungsmethode 

Neue Bereitstellungsmethode 

Kommentare 

Message Queue 

Nicht anwendbar 

Produktseite im Sun Download Center 

Eigenständiger Download. Nur Community-Support. Keine Support-Verträge verfügbar. 

Message Queue Platform Edition 

Message Queue-Produktseite im Sun Download Center 

Nicht mehr verfügbar 

Alle Seiten verweisen auf Einzel-Edition von Message Queue. 

Message Queue Enterprise Edition-Testversion (über Platform Edition) 

Message Queue-Produktseite im Sun Download Center 

Testlizenz nicht länger erforderlich. 

Nicht länger erforderlich. 

90-Tage-Testversion der Message Queue Enterprise Edition (über Java Enterprise System-Download oder -DVD) 

Java Enterprise System Download Center, früher als Version 3 GA (März 2006) 

Solaris Enterprise System Download Center 

Solaris Enterprise System-Lizenz. Ohne Produktlizenz stehen keine Support-Optionen zur Verfügung. 

Message Queue Enterprise Edition über SunStore, DVD, Einzellizenz, Java Enterprise System-Lizenz, Suite-Lizenz, bereitgestellt über Java Enterprise System 

Java Enterprise System oder Suite Download Center, Medien. 

Solaris Enterprise System oder Suite Download Center, Medien. 

Keine Änderung. 

Änderungen an der Schnittstelle für C-API- und C-Client-Runtime

Formatänderungen für die persistente Speicherung

Zwei Änderungen am Message Queue-Format für die persistente Speicherung verbessern die Leistung. Eine Änderung betrifft den Dateispeicher, die andere den JDBC-Speicher.

Da sich diese Änderungen auf die Speicherkompatibilität auswirken, wurde die Speicherversion von 350 in 370 geändert. Message Queue 3.7 UR1 unterstützt eine automatische Konversion des persistenten Speichers von den älteren Versionen 200 und 350 auf 370 - sowohl für JDBC- als auch für dateibasierte Speicher. Beim ersten Start von imqbrokerd wird bei Ermittlung eines älteren Speichers eine Migration auf das neue Format vorgenommen. Der alte Speicher wird hierbei erhalten.

Wenn Sie dieses Upgrade rückgängig machen möchten, können Sie Message Queue 3.7 UR1 deinstallieren und die zuvor ausgeführte Version neu installieren. Da die ältere Kopie des Speichers beibehalten wird, kann der Broker mit der älteren Kopie des Speichers ausgeführt werden.

Hardware- und Software-Anforderungen

Informationen zu den Hardware- und Software-Anforderungen von Message Queue finden Sie im Sun Java Enterprise System Installation Guide.

In dieser Version behobene Fehler

In diesem Abschnitt werden die in Message Queue 3.7 UR1 behobenen Fehler beschrieben.

Tabelle 1–3 In Message Queue 3.7 UR1 behobene Fehler

Fehlernummer 

Beschreibung  

6193884 

Message Queue gibt für Nicht-C-Gebietsschema fehlerhafte Meldungen in syslog aus. 

6251450 

ConcurrentModificationException für connectList während Clusterbeendigung.

6252763 

java.nio.BufferOverflowException in java.nio.HeapByteBuffer.putLong/Int.

6260076 

Erste Nachrichtenveröffentlichung nach Start bei Verwendung von Oracle-Speicher erfolgt langsam.  

6264003 

Der Warteschlangen-Browser zeigt nicht verarbeitete Nachrichten. 

6260814 

Auswahlverarbeitung auf JMSXUserID wird immer als false ausgewertet.

6264003 

Der Warteschlangen-Browser zeigt nicht verarbeitete Nachrichten. 

6271876 

Verbindungsdatensteuerung arbeitet nicht ordnungsgemäß, wenn ein Verbraucher mit nicht verarbeiteten Nachrichten geschlossen wird. 

6284769 

Speicherleck in Warteschlangenbrowser, selbst wenn ein neuer Browser erstellt und für jede Auflistung geschlossen wird. 

6294767 

Message Queue-Broker muss SO_REUSEADDR auf dem Netzwerksocket setzen, der geöffnet wird.

6304043 

Der Broker führt keine Überprüfung durch, ob clientID für gemeinsam genutzte, nicht dauerhafte Abonnements ungleich null ist.

6307056 

Das txn-Protokoll führt zu einem Leistungsengpass.  

6320138 

Message Queue C-API kann den Namen einer Warteschlange für einen Reply-To-Header nicht ermitteln.  

6320325 

Der Broker wählt unter Solaris gelegentlich JDK Version 1.4 anstelle JDK Version 1.5, selbst wenn beide Versionen installiert sind.  

6321117 

Die Initialisierung eines Multibroker-Clusters führt zu einer java.lang.NullPointerException.

6330053 

Der JMS-Client gibt java.lang.NoClassDefFoundError aus, wenn eine Transaktion vom Subscriber verarbeitet wird.

6340250 

Unterstützung für MESSAGE-Typ in C-API.

6351293 

Hinzugefügte Unterstützung für Derby-Datenbank.  

6381693 

Das Flag JMSRedelivered wird für Nachrichten auf 'false' gesetzt, die nach einem Neustart des Verbraucher-Brokers erneut an einen Remote-Verbraucher übermittelt werden.

6388049 

Bereinigung einer unvollständigen XA-Transaktion nicht möglich. 

6403968 

Hinzugefügtes verbraucherbasiertes Datensteuerungsprotokoll für den Lastausgleich beim Einsatz mehrerer Empfänger. 

6403958 

Eine Broker-Ausnahme wird ausgegeben, wenn die Warteschlange mit gelöschten Nachrichten versucht, die älteste nicht persistente Nachricht zu entfernen. 

6406862 

Broker-Fehler "Monitor destination error mq.metrics.destination.queue.Name".

6415068 

Transaktionswiederherstellung schlägt fehl für AS 8.1 UR2, generischer Ressourcenadapter für JMS Message Queue. 

6421781 

Verbindung mit Broker wird über folgende Syntax unterstützt:  

—b mqtcp://hostName:portNumber/serviceName

6423696 

Session.rollback führt nicht zu Rollback verarbeiteter Nachrichten nach COMMIT REPLY-Fehler.

6314103 

Message Queue kann nicht installiert werden, wenn Verzeichnisname Leerzeichen enthält . 

6314088 

6392963 

Message Queue kann nicht installiert werden, wenn Verzeichnisname mehr als 6 Zeichen umfasst. Beispiel: C:\Software\Sun.

Wichtige Informationen

In diesem Abschnitt finden Sie die aktuellsten Informationen, die nicht in der eigentlichen Produktdokumentation enthalten sind. In diesem Abschnitt werden folgende Themen behandelt:

Installationshinweise

Anweisungen, die vor der Installation auszuführen sind, Upgrade-Verfahren und anderen Informationen zur Installation von Message Queue als unabhängiges Produkt auf Solaris-, Linux- und Windows-Plattformen finden Sie im Sun Java System Message Queue 3.7 UR1 Installation Guide.

Anweisungen, die vor der Installation auszuführen sind und andere Informationen zur Installation des Message Queue-Produkts zusammen mit Java Enterprise System auf Solaris-, Linux- und Windows-Plattformen finden Sie im Sun Java System Message Queue 3.7 UR1 Installation Guide.

Detaillierte Informationen zu Upgrade und Migration auf Message Queue (als Bestandteil von Java Enterprise System) unter Solaris, Linux, HP-UX und Windows finden Sie im Sun Java Enterprise System Upgrade and Migration Guide.

Kompatibilitätsprobleme

In diesem Abschnitt werden bekannte Kompatibilitätsprobleme in Message Queue 3.7 UR1 beschrieben.

Schnittstellenstabilität

Message Queue verwendet zahlreiche Schnittstellen, die im Laufe der Zeit möglicherweise Änderungen unterliegen. In Anhang B, Stability of Message Queue Interfaces in Sun Java System Message Queue 3.7 UR1 Administration Guide werden die Schnittstellen gemäß ihrer Stabilität klassifiziert. Je stabiler eine Schnittstelle, desto weniger wahrscheinlich ist eine Änderung in den nachfolgenden Produktversionen.

Mögliche Probleme hinsichtlich der nächsten Hauptversion von Message Queue

Die nächste Hauptversion von Message Queue umfasst eventuell Änderungen, die eine Inkompatibilität mit Ihren Clients verursachen können. Wir teilen Ihnen diese Informationen jetzt mit, um Sie auf diese Änderungen vorzubereiten.

Dokumentationsaktualisierungen für Message Queue 3.7 UR1

In den folgenden Abschnitten werden Aktualisierungen und Änderungen an der Dokumentation zu Message Queue beschrieben. Kleinere Korrekturen und Änderungen werden hier nicht einbezogen.

Installation Guide

Der Sun Java System Message Queue 3.7 UR1 Installation Guide, indem Installationsinformationen für die unabhängige Version von Message Queue dokumentiert sind, wurde unter Berücksichtigung von plattformspezifischen Informationen aktualisiert.

Developer’s Guide for C Clients

Der Sun Java System Message Queue 3.7 UR1 Developer’s Guide for C Clients wurde um Informationen zu neuen Elementen ergänzt. Es wurden Informationen zu der neuen Funktion MQGetDestinationName, dem neuen Nachrichtentyp MQ_Message sowie der neuen Verbindungseigenschaft MQ_UPDATE_RELEASE_PROPERTY hinzugefügt.

Developer's Guide for Java Clients

Der Sun Java System Message Queue 3.7 UR1 Developer’s Guide for Java Clients wurde aktualisiert. Es wurden Informationen zur Einrichtung sicherer Clients hinzugefügt, und es wird erläutert, wie Clients Ausnahmefehler verarbeiten sollten, die während der automatischen Neuverbindung auftreten.

Administration Guide

Der Sun Java System Message Queue 3.7 UR1 Administration Guide wurde aktualisiert. Es wurden Informationen zu den Datenbanktabellen des Brokers hinzugefügt, und es wird erläutert, wie Sie den Broker für die Verwendung fester Ports konfigurieren.

Bekannte Probleme und Einschränkungen

In diesem Abschnitt werden die bekannten Probleme mit Message Queue 3.7 UR1 aufgeführt. Dies betrifft die folgenden Produktbereiche:

Eine Liste der aktuellen Fehler, deren Status und Umgehungsmöglichkeiten finden Sie als Mitglied der Java Developer ConnectionSM auf der Seite "Bug Parade" auf der Java Developer Connection-Website unter http://bugs.sun.com/bugdatabase/index.jsp Prüfen Sie die Informationen auf dieser Seite, bevor Sie einen neuen Fehler melden. Auch wenn nicht alle Message Queue-Fehler aufgelistet sind, ist diese Seite ein guter Ausgangspunkt, wenn Sie feststellen möchten, ob ein Problem bekannt gegeben wurde.


Hinweis –

Die Mitgliedschaft bei der Java Developer Connection ist kostenlos, es ist jedoch eine Registrierung erforderlich. Weitere Informationen dazu, wie Sie Mitglied bei der Java Developer Connection werden, finden Sie auf der Sun Java-Webseite für Entwickler.


Wenn Sie einen neuen Fehler melden oder eine Funktionsanfrage einreichen möchten, senden Sie eine E-Mail an imq-feedback@sun.com.

Allgemeine Probleme

Eigenschaften für das LDAP-Benutzer-Repository

In Message Queue 3.7 UR1 wird die Beispielkonfiguration für einen Broker unter Verwendung eines LDAP-Servers als Benutzer-Repository im Kommentarbereich der Datei config.properties angezeigt. Das Beispiel für das LDAP-Benutzer-Repository in der Datei default.properties ist auskommentiert.

Wenn Sie bisher einen Eigenschaftswert der Repository-Eigenschaften für Beispiel-LDAP-Benutzer in der Datei default.properties verwendet haben, erhalten Sie nach dem Upgrade auf Message Queue 3.7 UR1 auf dem JMS-Anwendungsclient einen Sicherheitsausnahmefehler, wenn Sie versuchen, eine JMS-Verbindung herzustellen.

Wenn Ihr JMS-Client versucht, eine Verbindung mit dem Message Queue 3.7 UR1 -Broker herzustellen, wird ein Fehler im Broker-Protokoll angezeigt und Ihr JMS-Client empfängt folgenden Ausnahmefehler:

SecurityException.
20/Aug/2004:11:16:41 PDT] ERROR [B4064]: Ldap repository ldap property
.uidattr not defined for authentication type 
basic:com.sun.messaging.jmq.auth.LoginException: 
[B4064]: Ldap repository ldap property .uidattr not defined 
for authentication type basic

Umgehung: Setzen Sie die Broker-Eigenschaft imq.user_repository.ldap.uidattr gemäß den Anweisungen in Kapitel 7, Managing Security in Sun Java System Message Queue 3.7 UR1 Administration Guide.

Broker-Cluster

Die folgenden Punkte beziehen sich auf die Verwendung von Broker-Clustern.

Administration/Konfiguration

Die folgenden Probleme beziehen sich auf die Administration und Konfiguration von Message Queue.

Broker-Probleme

Die nachfolgend beschriebenen Probleme beziehen sich auf den Message Queue-Broker.

Dokumentation

Es gibt kein eigenständiges Produkt für Message Queue 3.7 UR1. Für diese Version müssen Sie Message Queue über das Installationsprogramm von Java Enterprise System Installer installieren. Folgen Sie den Anweisungen im Sun Java System Installationhandbuch.

Installationsprobleme

Dateien für die Neuverteilung

Sun Java System Message Queue 3.7 UR1 enthält die folgenden Dateien, die Sie möglicherweise in binärer Form verwenden und verteilen:

jms.jar

libmqcrt.so (UNIX)

imq.jar

libmqcrt.so (HPUX)

imqxm.jar

mqcrt1.dll (Windows)

fscontext.jar

 

Außerdem können Sie die Dateien LICENSE und COPYRIGHT ebenfalls neu verteilen.

Eingabehilfen für Personen mit Behinderungen

Um Eingabehilfen zu erhalten, die seit der Veröffentlichung dieses Dokuments auf den Markt gekommen sind, lesen Sie Abschnitt 508 der Produktbewertungen (bei Sun auf Anfrage erhältlich), um die für Sie geeignete Version zu ermitteln. Die aktualisierten Versionen von Anwendungen finden Sie unter http://sun.com/software/javaenterprisesystem/get.html.

Informationen zum Einsatz von Sun für Eingabehilfen erhalten Sie unter http://sun.com/access.

Problemmeldungen und Feedback

Wenn Sie mit Sun Java System Message Queue Probleme haben, wenden Sie sich an die Kundenunterstützung von Sun. Dazu stehen Ihnen folgende Möglichkeiten zur Verfügung:

Damit wir Ihnen unmittelbar Hilfe anbieten können, halten Sie die folgenden Informationen bereit, wenn Sie sich an den Support wenden:

Sun Java System-Software-Forum

Unter der folgenden Adresse steht ein Sun Java System Message Queue-Forum zur Verfügung: http://swforum.sun.com/jive/forum.jspa?forumID=24

Wir freuen uns über Ihre Teilnahme.

Java Technology Forum

Im Java Technology Forum finden Sie möglicherweise ein für Sie interessantes JMS-Forum unter: http://forum.java.sun.com

Sun freut sich über Ihre Kommentare

Sun ist stets an einer Verbesserung der eigenen Dokumentation interessiert und nimmt Ihre Kommentare und Anregungen gerne entgegen.

Sie können Ihre Kommentare unter http://docs.sun.com durch Klicken auf den entsprechenden Link an uns senden. Geben Sie im Onlineformular den Dokumenttitel und die Teilenummer an. Die Teilenummer ist eine 7- oder 9-stellige Zahl, die Sie auf der Titelseite des Handbuchs oder am Anfang des Dokuments finden. Der Titel des vorliegenden Buches lautet beispielsweise Sun Java System Message Queue 3.7 UR1 – Versionshinweise für Microsoft Windows, die Teilenummer lautet 820-1806-10.

Weitere Quellen von Sun

Nützliche Informationen über Message Queue finden Sie unter den folgenden Internetadressen: