Sun Java System Message Queue 3 2005Q4 Versionshinweise |
Sun Java System Message Queue Versionshinweise
Version 3 2005Q4 (3.6 SP3)
Teilenummer 819-3558
Diese Versionshinweise enthalten wichtige Informationen, die zum Zeitpunkt der Herausgabe von Sun Java System Message Queue 3 2005Q4 (3.6 SP3) verf�gbar waren. Dieses Dokument umfasst zudem den Inhalt der Versionshinweise zu Sun Java System Message Queue 3 2005Q1 (3.6) f�r Kunden, die ein Upgrade von Versionen vor Message Queue 3 2005Q1 durchf�hren. In diesem Dokument werden neue Funktionen und Verbesserungen, bekannte Probleme und Einschr�nkungen und andere Informationen angesprochen, die Sie vor der Verwendung von Message Queue lesen sollten.
Die neueste Ausgabe dieser Versionshinweise finden Sie auf der Sun Java System Message Queue-Website f�r Dokumentationen unter http://docs.sun.com/coll/1307.1. 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.
�nderungsprotokoll der Versionshinweise
Tabelle 1 �nderungsprotokoll
Datum
Beschreibung der �nderungen
26. August 2005
- Aktualisierung von Informationen zu Message Queue 3 2005Q4 (3.6 SP3).
- Aktualisierung von Aktualisierung der Dokumentation f�r Message Queue 3 2005Q4 (3.6 SP3).
- Aktualisierung von Hardware- und Softwareanforderungen f�r Message Queue 2005Q4 (3.6 SP3).
- Hinzuf�gen behobener Fehler f�r Message Queue 3 2005Q4 (3.6 SP3) zu In dieser Version behobene Fehler.
28. Juni 2005
- Hinzuf�gen behobener Fehler f�r Message Queue 3 2005Q1 (3.6 SP1) und Message Queue 32005Q4 (3.6 SP2) zu In dieser Version behobene Fehler.
1. Mai 2005
- Aktualisierung des Abschnitts Probleme mit der n�chsten gr��eren Version von Message Queue mit neuen Informationen.
- Hinzugef�gte Anmerkung zur Oberfl�chenstabilit�t im Abschnitt „Kompatibilit�t“.
24. Januar 2005
Auf die Verkaufsversion von Sun Java System Message Queue 3 2005Q1 und Java Enterprise System 2005Q1 abgestimmtes Update.
8. November 2004
Urspr�ngliche Ver�ffentlichung von Sun Java System Message Queue Versionshinweise.
Informationen zu Message Queue 3 2005Q4 (3.6 SP3)Message Queue 3 2005Q4 (3.6 SP3) ist ein Fehlerbehebungs-Update von Message Queue 3 2005Q1 (3.6). Es enth�lt s�mtliche Fehlerbehebungen aus 3.6 SP2 und 3.6 SP1 sowie neue Updates der Dokumentation.
Message Queue 3 2005Q1 (3.6)
Sun Java System Message Queue ist ein umfassender Meldungsdienst, der eine zuverl�ssige, asynchrone �bermittlung von Meldungen garantiert, die der Java Messaging Specification (JMS) 1.1 entsprechen. Au�erdem bietet Message Queue eine Vielzahl von Funktionen, die die JMS Specification sogar noch �bertreffen und so die Anforderungen bei einem Einsatz in Gro�unternehmen erf�llen.
Dieser Abschnitt enth�lt Informationen zu folgenden Themen:
Neuheiten in dieser Version
Message Queue 3 2005Q1 (3.6) enth�lt folgende neue Funktionen:
Diese werden in den folgenden Abschnitten genauer erl�utert.
Dead Message Queue
Message Queue erstellt automatisch einen speziellen Zielstandort beim Broker-Start, der zum Speichern verstorbener Meldungen f�r Diagnosezwecke dient. Eine verstorbene Meldung wird aus anderen Gr�nden vom System entfernt als durch die normale Verarbeitung oder das absichtliche Handeln eines Administrators. Eine Meldung wird eventuell als "verstorben" betrachtet, weil sie abgelaufen ist, weil sie aus einem Zielstandort wegen eines �berschreitens des Speicherlimits entfernt wurde oder weil die Zustellung wiederholt fehlgeschlagen ist.
Ein Administrator kann die Zielstandorte so konfigurieren, dass verstorbene Meldungen gel�scht werden oder in die Warteschlange f�r verstorbene Meldungen aufgenommen werden. Wenn sie sich in der Warteschlange f�r verstorbene Meldungen befinden, werden in die Meldung zus�tzliche Eigenschaftsdaten geschrieben, durch die ein Administrator �ber die Todesursache informiert wird. Ein Client-Entwickler kann weiterhin beim Erstellen einer Meldung einen Eigenschaftswert festlegen, der bestimmt, ob die Meldung nach dem Tod in die Warteschlange der verstorbenen Meldungen aufgenommen wird.
Weitere Informationen finden Sie im Handbuch Message Queue Administration Guide.
Kein Best�tigungsmodus
Der Best�tigungsmodus NO_ACKNOWLEDGE ist eine Erweiterung des JMS API. Gew�hnlich wartet der Broker auf die Best�tigung eines Clients. Diese Best�tigung muss programmatisch durchgef�hrt werden, wenn der Client CLIENT_ACKNOWLEDGE angegeben hat oder kann automatisch von der Sitzung durchgef�hrt werden, wenn der Client AUTO_ACKNOWLEDGE oder DUPS_OK angegeben hat. Wenn ein konsumierender Client den Modus NO_ACKNOWLEDGE angibt, verwirft der Broker die Meldung gleich nach dem Senden an den konsumierenden Client. Diese Funktion ist f�r nichtdauerhafte Abonnenten, die nichtpersistente Meldungen konsumieren, gedacht, aber sie kann von jedem Konsumenten verwendet werden.
Wenn Sie diese Funktion verwenden, wird die Leistung verbessert, da der Protokollverkehr und die Broker-Verarbeitung beim Best�tigen einer Meldung verringert werden. Diese Funktion kann die Leistung auch bei Brokern verbessern, die mit fehlerhaft arbeitenden Clients zusammenarbeiten. Solche Clients best�tigen keine Meldungen und belegen so unn�tigerweise Speicherressourcen des Brokers. Der Einsatz dieses Modus hat auf die Produzenten keine Auswirkungen.
In C-Clients wird der Modus NO_ACKNOWLEDGE nicht unterst�tzt. Weitere Informationen finden Sie im Handbuch Message Queue Developer’s Guide for Java Clients.
Komprimierung des Client-Meldungstextes
Der Entwickler kann festlegen, dass der Meldungstext komprimiert wird. Die Komprimierung und Dekomprimierung von Meldungen wird ausschlie�lich von der Client-Runtime durchgef�hrt und hat keine Auswirkungen auf den Broker. Daher k�nnen auch Anwendungen mit einer fr�heren Broker-Version diese Funktion verwenden. Es muss jedoch die Version 3 2005Q1 (3.6) der Message Queue Client-Runtime-Bibliothek verwendet werden.
Vorteile und Nachteile der Komprimierung Die Meldungskomprimierung dient zwar der Leistungsverbesserung, aber es gibt daf�r keine Garantie. Je nach Gr��e und Format der Meldungen, der Anzahl der Konsumenten, der Netzwerk-Bandbreite und der CPU-Leistung fallen die Vorteile unterschiedlich aus. Die Kosten f�r Komprimierung und Dekomprimierung sind eventuell h�her als die Zeitersparnis beim Senden und Empfangen einer komprimierten Meldung. Das ist vor allem der Fall, wenn Sie kleine Meldungen in einem Hochgeschwindigkeitsnetzwerk senden. Andererseits k�nnen Anwendungen, die an viele Konsumenten gro�e Meldungen senden oder die in einer langsamen Netzwerkumgebung arbeiten, die Systemleistung durch das Komprimieren der Meldungen verbessern.
Meldungskonsumenten, die mit Client-Runtime-Bibliotheken aus fr�heren Versionen als 3 2005Q1 (3.6) eingesetzt werden, k�nnen keine komprimierten Meldungen verarbeiten. Clients, die zum Senden komprimierter Meldungen konfiguriert wurden, m�ssen sicherstellen, dass die Konsumenten kompatibel sind. C-Clients k�nnen derzeit keine komprimierten Meldungen empfangen.
Weitere Informationen finden Sie im Handbuch Message Queue Developer’s Guide for Java Clients.
Erkennen eines Verbindungsfehlers (Client-Runtime-Ping)
Message Queue 3 2005Q1 bietet ein neues ConnectionFactory-Attribut mit dem Namen imqPingInterval. Das imqPingInterval-Attribut gibt die H�ufigkeit einer Ping-Operation vom Client-Runtime zum Broker an. Indem die Verbindung regelm��ig getestet wird, kann die Client-Runtime eine fehlerhafte Verbindung bereits im Voraus entdecken. Falls die Ping-Operation fehlschl�gt, gibt die Client-Runtime einen Ausnahmefehler an das Ausnahmefehler-Listener-Objekt der Client-Anwendung aus. Falls die Anwendung �ber keinen Ausnahmefehler-Listener verf�gt, schl�gt der n�chste Versuch der Anwendung fehl, die Verbindung zu nutzen.
Weitere Informationen finden Sie im Handbuch Message Queue Administration Guide.
Zertifikatsverwaltung C-API NSS-Tools
Der C-API verwendet NSS (Network Security Services)-Bibliotheken zur Unterst�tzung von SSL. Diese Bibliotheken bieten APIs und Dienstprogramme zur Entwicklung sicherer Anwendungen. Diese Dienstprogramme enthalten Tools zur Verwaltung von Schl�sseln und Zertifikatsdatenbanken. In Message Queue 3.5 wurden Entwickler gebeten, bei der Verwaltung von NSS-Schl�sseln und -Zertifikaten Mozilla einzusetzen. Bei Message Queue 3 2005Q1 k�nnen die Administratoren das NSS-Tool certutil verwenden, um die erforderlichen Schl�ssel und Zertifikate zu erstellen.
Weitere Informationen finden Sie im Handbuch Message Queue Developer’s Guide for C Clients.
Unterst�tzung f�r C-API Basic-Authentifizierung
Message Queue 3 2005Q1 C-API unterst�tzt die Authentifizierung basic. Bei vorherigen Versionen von Message Queue wurde der Authentifizierungstyp basic nicht unterst�tzt.
64-Bit C-API-Unterst�tzung
Message Queue bietet jetzt die 64-Bit C-API-Unterst�tzung auf der Solaris/SPARC-Plattform. Weitere Informationen zur Aktivierung der 64-Bit C-API-Unterst�tzung finden Sie im Handbuch Message Queue Developer’s Guide for C Clients.
Hardware- und Softwareanforderungen
In diesem Abschnitt wird die f�r diese Version von Message Queue erforderliche Hard- und Software angegeben bzw. beschrieben. In der Tabelle 2 sehen Sie die Hardware- und Softwareanforderungen f�r Solaris SPARC-Betriebssyteme.
In der Tabelle 3 sehen Sie die Hardware- und Softwareanforderungen f�r Solaris x86-Betriebssysteme.
In der Tabelle 4 sehen Sie die Hardware- und Softwareanforderungen f�r Linux-Betriebssysteme.
Message Queue 3 2005Q1 h�ngt auch von anderen Technologien ab. Genauere Hinweise finden Sie in Tabelle 5. Andere Versionen oder Herstellerimplementierungen k�nnen auch verwendet werden. Diese sind jedoch von Sun Microsystems nicht getestet und werden daher nicht unterst�tzt.
In der Tabelle 5 sehen Sie die zu installierenden Grundkomponenten, die f�r die Entwicklung und Ausf�hrung von Message Queue-Clients erforderlich sind, und erhalten eine Beschreibung derselben.
In der Tabelle 6 sehen Sie die Komponenten, die Sie installieren k�nnen, um zus�tzliche Unterst�tzung f�r einen Message Queue-Client bereitzustellen, und finden eine Beschreibung derselben. Wahrscheinlich ben�tigen Sie nur einige der aufgef�hrten Komponenten. Wenn Sie beispielsweise keinen C-Client in Message Queue schreiben, ben�tigen Sie keine der erforderlichen Komponenten f�r die C-Client-Unterst�tzung.
In dieser Version behobene FehlerIn Tabelle 7 sehen Sie die in Message Queue 3 2005Q1 (3.6) behobenen Fehler:
In Tabelle 8 sehen Sie die in Message Queue 3 2005Q1 (3.6 SP1) behobenen Fehler:
In Tabelle 9 sehen Sie die in Message Queue 3 2005Q4 (3.6 SP2) behobenen Fehler:
In Tabelle 10 sehen Sie die in Message Queue 3 2005Q4 (3.6 SP3) behobenen Fehler:
Wichtige InformationenIn diesem Abschnitt finden Sie die aktuellsten Informationen, die nicht in der eigentlichen Produktdokumentation enthalten sind: In diesem Abschnitt werden die folgenden Themen behandelt:
Installationshinweise
Im Handbuch Message Queue Installation Guide finden Sie Anweisungen zur Installationsvorbereitung, Upgrade-Anleitungen und alle anderen Informationen zur Installation von Message Queue Platform Edition auf den Plattformen Solaris, Linux und Windows.
Im Handbuch Sun Java Enterprise System Installation Guide finden Sie Informationen zur Installationsvorbereitung und alle weiteren Informationen zur Installation von Message Queue Enterprise Edition auf den Plattformen Solaris und Linux.
Im Handbuch Sun Java Enterprise System Upgrade and Migration Guide finden Sie Informationen zum Upgrade und der Migration f�r die Aktualisierung auf Message Queue 3 2005Q1 (3.6) auf den Plattformen Solaris und Linux.
Installation fehlender Solaris-Pakete (nur in Message Queue 3 2005Q1 Enterprise Edition (Verteilung) mit Java Enterprise System Installer)
Die Message Queue 3 2005Q1 Enterprise Edition-Distribution f�r Solaris enth�lt nicht die folgenden Pakete: SUNWtlsu (Network Security Services Utilities) und SUNWtlsux (nur Network Security Services Utilities 64-Bit SPARC).
Diese Pakete sind nur f�r die Unterst�tzung von SSL C-Clients erforderlich. Eine vorherige Version dieser Pakete ist eventuell bereits auf Ihrem System installiert. Sie sollten diese Pakete jedoch auf die in Java Enterprise System 2005Q1 enthaltene Version aktualisieren.
Umgehung
Die Versionen SUNWtlsu und SUNWtlsux im Lieferumfang von Java Enterprise System Sun Java System k�nnen Sie aus den Message Queue 3 2005Q1 Platform Edition-Bundles auf der Sun Java System-Website erhalten. Nach dem Download der Message Queue-Dateien, befolgen Sie die Anweisungen im Abschnitt „Installing Message Queue“ in Kapitel 2 „Solaris Installation“ des Handbuchs Message Queue Installation Guide. In Schritt 8 antworten Sie n (Nein) und fahren mit Schritt 9 fort. So installieren Sie nur die Pakete SUNWtlsu und SUNWtlsux auf Ihrem System.Kompatibilit�t
In diesem Abschnitt werden Kompatibilit�tsprobleme von Message Queue 3 2005Q1 (3.6) behandelt.
Probleme in Message Queue 3 2005Q1 (3.6)
In den folgenden Abschnitten werden Probleme behandelt, die folgende Plattformen betreffen: alle Plattformen, Solaris- und Linux-Plattformen und nur Linux-Plattformen.
Alle Plattformen
Oberfl�chenstabilit�t Sun Java System Message Queue verwendet viele Oberfl�chen, mit deren Hilfe ein Administrator Aufgaben automatisieren kann. In Anhang B des Handbuchs Message Queue Administration Guide werden diese Oberfl�chen nach ihrer Stabilit�t eingeordnet. Je stabiler eine Oberfl�che ist, umso geringer ist die Wahrscheinlichkeit, dass sie sich in folgenden Produktversionen ver�ndert.
Verwerfen von Passwortoptionen Folgende Optionen wurden aus Sicherheitsgr�nden verworfen:
Wenn ein Passwort als Teil eines Befehls, wie dem folgenden, angegeben wird:
imqcmd query bkr -u admin -p adminpassword
k�nnte ein Benutzer das Administratorpasswort sehen, w�hrend Computerprozesse belauscht oder abgefragt werden (z. B. mit ps auf Solaris).
Verwenden Sie stattdessen die Option -passfile. Die Option „passfile“ wird im Kapitel zur Sicherheit im Handbuch Message Queue Administration Guide genauer erl�utert.
Solaris- und Linux-Plattformen
JDK 1.3 Client-Unterst�tzung Folgende Pakete enthalten jar-Dateien zur Unterst�tzung von JNDI und JSSE zur Client-Entwicklung und zum Client-Einsatz auf JDK 1.3. Diese Pakete sind nur im Lieferumfang von Message Queue Platform Edition enthalten. In zuk�nftigen Versionen sind diese Pakete nicht mehr enthalten. Diese Pakete werden nicht standardm��ig installiert:
Weitere Informationen zur Installation und Konfiguration finden Sie im Handbuch Message Queue Installation Guide.
Linux-Plattformen
In diesem Abschnitt werden die �nderungen behandelt, die die Pakete und installierten Standorte auf der Linux-Plattform betreffen.
Neue Linux-Installationsstandorte Der Standort der Message Queue-Installationsverzeichnisse wurde unter Linux ge�ndert.
Hinweis
Es gab keine �nderungen in Bezug auf die Installationsverzeichnisse zwischen Message Queue 3 2005Q1 (3.6) und Message Queue 3 2005Q4 (3.6 SP3).
In der Tabelle 11 sehen Sie die Standardinstallationsverzeichnisse f�r Message Queue-RPMs unter Linux.
Genauere Informationen finden Sie unter „Operating System-Specific Locations of Message Queue Data“ im Handbuch Message Queue Administration Guide.
Ge�nderte Linux RPM-Paketnamen Die Namen der Message Queue Linux RPM-Paketdateien wurden ge�ndert.
Hinweis
Es gab keine �nderungen in Bezug auf die Namen der Message Queue Linux RPM-Paketnamen zwischen der Version Message Queue 3 2005Q1und Message Queue 3 2005Q4.
Tabelle 12 zeigt die neuen Namen der Message Queue 3 2005Q1-Linux RPM-Pakete.
Tabelle 12 RPM-Pakete im Linux-Bundle
RPM
Beschreibung
Hinweise
sun-mq-config
/etc-Dateien
sun-mq-var
/var-Dateien
sun-mq
/opt-Dateien
H�ngt von sun-javahelp, sun-mq-jmsclient, sun-mq-config und sun-mq-var ab.
sun-mq-ent
Enterprise Edition-Lizenzdatei.
Dieses RPM ist nur im Lieferumfang der Message Queue Enterprise Edition als Teil des Java Enterprise System enthalten.
sun-mq-jaxm
Message Queue Java API f�r XML-Messaging (JAXM): API
H�ngt von sun-saaj ab.
sun-mq-jmsclient
JMS: API und Runtime
Keine Abh�ngigkeiten
sun-mq-xmlclient
XML-Client
H�ngt von sun-jmsclient und sun-saaj ab.
sun-mq-capi
C-API
H�ngt von sun-nspr, sun-nss ab.
sun-mq-compat
Symlinks auf 3.5-Standorte.
H�ngt von sun-mq ab.
Dieses RPM wird nicht standardm��ig installiert.
Hinweis: Dieses Paket ist nur erforderlich, wenn Ihre vorhandenen Clients abh�ngig sind von Message Queue 3.5-Dateistandorten.
sun-mq-sup
Erforderlich zur Unterst�tzung von JDK 1.3.
H�ngt von sun-mq ab.
Dieses RPM wird nicht standardm��ig installiert.
Hinweis: Dieses Paket ist nur im Lieferumfang von Message Queue Platform Edition enthalten.
sun-mq-[locale]
L10N-Dateien
sun-javahelp1
JavaHelp: API und Runtime
Unterst�tzt den JavaHelp-Betrachter f�r die Hilfe der Administration Console.
sun-nss1
Network Security Services (NSS)-Bibliotheken.
Erforderlich zur Unterst�tzung der C-Language-Clients.
sun-nspr1
Netscape Portable Runtime (NSPR)-Bibliotheken
Erforderlich zur Unterst�tzung der C-Clients.
sun-saaj1
SOAP mit Anhangs-API f�r Java: API und Runtime
Erforderlich zur Unterst�tzung von Java-Clients mit SOAP/JAXM API
sun-jaxp1
Message Queue Java API f�r XML-Verarbeitung (JAXP): API und Runtime
Erforderlich zur Unterst�tzung von Java-Clients mit SOAP/JAXM API
sun-javamail1
JavaMail: API und Runtime
Erforderlich zur Unterst�tzung von Java-Clients mit SOAP/JAXM API
sun-jaf1
JavaBeans Activation Framework: API und Runtime
Erforderlich zur Unterst�tzung von Java-Clients mit SOAP/JAXM API
1Auf dieses RPM-Paket wird von einer Reihe von Sun Java System-Produkten aus zugegriffen. Es ist im Lieferumfang von Message Queue Platform Edition in der Verteilung aber nicht im Lieferumfang von Message Queue Enterprise Edition enthalten.
Symlinks-Paket f�r 3.5-Clients Die Standorte einzeln als Teil von Message Queue installierter Dateien wurden unter Linux ge�ndert. Dadurch kann es zu Problemen mit Anwendungen kommen, die sich auf den urspr�nglichen Standort einiger Message Queue-Dateien beziehen. Wenn Ihre Clients beispielsweise Skripten verwenden, um nach jar-Dateien zu suchen, die mit Message Queue 3.5 installiert wurden, k�nnen diese Clients die Dateien nicht mehr finden.
Dieses Problem beheben Sie mit dem in dieser Version enthaltenen Linux-Paket sun-mq-compat. Dieses Paket installiert Symlinks von Message Queue 3.5-Dateistandorten auf die installierten Message Queue 3 2005Q1 (3.6) -Dateistandorte. Dieses Paket ist in k�nftigen Versionen m�glicherweise nicht mehr enthalten. Alle Skripten, die sich auf fr�here Standorte von Message Queue-Dateien beziehen, sollten bearbeitet werden.
Das Paket sun-mq-compat befindet sich in den folgenden Verzeichnissen.
So installieren Sie das sun-mq-compat-Paket
Probleme mit der n�chsten gr��eren Version von Message Queue
Die n�chste gr��ere Version von Message Queue beinhaltet 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.
- Dies ist die letzte Funktionsversion von Sun Java System Message Queue, die mit Sun One Message Queue 3.0.1 abw�rtskompatibel ist. Insbesondere zuk�nftige Versionen von Sun Java System Message Queue unterst�tzen Folgendes nicht:
- Verbindung von 3.0.1-Clients mit Brokern der neuesten Version
- Aktualisierung eines 3.0.1-Speichers auf die neueste Version
- Clustering von 3.0.1-Brokern mit Brokern der neuesten Version
- Verwendung von 3.0.1-Eigenschaftsdateien, Benutzerspeichern und Zugriffssteuerungslisten usw. mit Brokern der neuesten Version
- Dies ist die letzte Version von Sun Java System Message Queue, die als „System JMS Messaging Provider“ f�r Sun Java System Application Server 7.X integriert werden kann. Zuk�nftige Versionen von Sun Java System Message Queue unterst�tzen nur Sun Java System Application Server 8.0 und h�her.
- Dies ist die letzte Version von Sun Java System Message Queue, die die SOAP-Runtime einschlie�t und verwaltete Message Queue SOAP-Objekte unterst�tzt.
- Zuk�nftige Versionen unterst�tzen SOAP nur gemeinsam mit einer Java 2 Standard Edition Platform-Version, die SOAP unterst�tzt.
- Sun Java System Message Queue-Client-Unterst�tzung f�r alle Versionen von Java 2 Standard Edition 1.3 besteht nicht mehr. Java 2 Standard Edition 1.4 wird weiterhin unterst�tzt.
- Die Standorte einzelner Dateien, die als Teil von Sun Java System Message Queue installiert wurden, �ndern sich m�glicherweise. Dadurch k�nnen in vorhandenen Anwendungen Fehler auftreten, die vom aktuellen Standort bestimmter Message Queue-Dateien abh�ngen.
- Sun Java System Message Queue -Clients, die eine �ltere Message Queue-Version als die n�chste Vollversion verwenden, k�nnen daher eventuell nicht auf die neuen Funktionen dieser Produktversion zugreifen.
Aktualisierungen der Dokumentation f�r Message Queue
In den folgenden Abschnitten werden die Aktualisierungen f�r die Dokumentation f�r Message Queue 3 2005Q1 (3.6) und Message Queue 3 2005Q4 (3.6 SP3) beschrieben.
Aktualisierung der Dokumentation f�r Message Queue 3 2005Q1 (3.6)
Die folgenden Message Queue-Dokumente wurden von der Produktversion 3.5 aktualisiert:
Installation Guide
Das Handbuch Message Queue Installation Guide wurde aktualisiert und enth�lt jetzt �nderungen bei Marken und plattformspezifische Informationen. Dieses Dokument enth�lt jetzt alle Installationsinformationen f�r Message Queue Platform Edition.
Die Installationsinformationen f�r Message Queue, Enterprise Edition wurden in das Handbuch Sun Java SystemInstallation Guide aufgenommen.
Genauere Informationen zum Upgrade und der Migration auf Message Queue 3 2005Q1 (3.6) Enterprise Edition finden Sie im Handbuch Sun Java SystemUpgrade and Migration Guide.
Technische �bersicht
Message Queue Technical Overview ist ein neues Dokument, das mit der Version Message Queue 3 2005Q1 (3.6) eingef�hrt wurde. Es wurde f�r die Version Message Queue 3 2005Q4 (3.6 SP3) neu verfasst. In ihm werden das Message Queue-Produkt, seine Funktionen, die Architektur, Technologie und Terminologie beschrieben. Dieses neue Handbuch enth�lt Informationen, die vorher in anderen Handb�chern enthalten waren, und ist f�r Benutzer von Message Queue gedacht – f�r Administratoren und Entwickler – sowie f�r Benutzer ohne Vorkenntnisse.
Administration Guide
Das Handbuch Message Queue Administration Guide wurde aktualisiert. Es enth�lt jetzt �nderungen bei Marken und neue Funktionen. Dieses Dokument wurde auch neu gegliedert, damit es von Message Queue-Administratoren besser genutzt werden kann. Die bisher in diesem Dokument enthaltenen �bersichtsinformationen wurden in das Dokument Message Queue Technical Overview �bernommen.
Message Queue Developer’s Guide for Java Clients
Das Handbuch Java Client Developer’s Guide wurde aktualisiert. Es enth�lt jetzt �nderungen bei Marken und neue Funktionen. Das Dokument wurde au�erdem umbenannt in Message Queue Developer’s Guide for Java Clients.
Das Handbuch Message Queue Developer’s Guide for Java Clients wurde neu gegliedert, damit es von Message Queue Java Client-Entwicklern besser genutzt werden kann. Die bisher in diesem Dokument enthaltenen �bersichtsinformationen wurden in das Dokument Message Queue Technical Overview �bernommen.
C Client Developer’s Guide
Das Handbuch C Client Developer’s Guide wurde aktualisiert. Es enth�lt jetzt �nderungen bei Marken und neue Funktionen. Das Dokument wurde au�erdem umbenannt in Message Queue Developer’s Guide for C Clients.
Das Handbuch Message Queue Developer’s Guide for C Clients wurde neu gegliedert, damit es von Message Queue C-Client-Entwicklern besser genutzt werden kann. Die bisher in diesem Dokument enthaltenen �bersichtsinformationen wurden in das Dokument Message Queue Technical Overview �bernommen.
Aktualisierung der Dokumentation f�r Message Queue 3 2005Q4 (3.6 SP3)
Die folgenden Message Queue-Dokumente wurden von der Produktversion 3 2005Q1 (3.6) aktualisiert:
Installation Guide
Das Handbuch Message Queue Installation Guide wurde aktualisiert und spiegelt jetzt die �nderungen im Bezug auf die Installation des Produkts wider, die seit der Version Message Queue 3 2005Q1 (3.6) eingef�hrt wurden.
Technische �bersicht
Message Queue Technical Overview ist ein neues Dokument, das mit der Version Message Queue 3 2005Q1 (3.6) eingef�hrt wurde. Es wurde f�r die Version Message Queue 3 2005Q4 (3.6 SP3) neu verfasst. In ihm werden das Message Queue-Produkt, seine Funktionen, die Architektur, Technologie und Terminologie beschrieben. Dieses neue Handbuch enth�lt Informationen, die vorher in anderen Handb�chern enthalten waren, und ist f�r Benutzer von Message Queue gedacht – f�r Administratoren und Entwickler – sowie f�r Benutzer ohne Vorkenntnisse.
Administration Guide
Das Handbuch Message Queue Administration Guide wurde neu gegliedert, damit es von Message Queue-Administratoren besser genutzt werden kann. Die bisher in diesem Dokument enthaltenen �bersichtsinformationen wurden in das Dokument Message Queue Technical Overview �bernommen.
Message Queue Developer’s Guide for Java Clients
Das Handbuch Message Queue Developer’s Guide for Java Clients enht�lt ein neues Kapitel: “Using the Java API”.
Bekannte Probleme und Einschr�nkungenDieser Abschnitt enth�lt eine Liste der bekannten Probleme in Message Queue 3 2005Q1 (3.6). Die folgenden Produktbereiche werden besprochen:
F�r eine Liste der aktuellen Fehler, deren Status und Umgehungsm�glichkeiten sollten Mitglieder der Java Developer Connection die Bug Parade der Java Developer Connection-Website besuchen. Besuchen Sie diese 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.
Die Adresse der Seite lautet wie folgt:
Wenn Sie einen neuen Fehler melden oder eine Funktionsanfrage einreichen m�chten, senden Sie eine E-Mail an imq-feedback@sun.com.
Allgemeine Probleme
In diesem Abschnitt werden allgemeine Probleme von Message Queue 3 2005Q1 (3.6) behandelt. Einige wurden durch vorherige Versionen von Message Queue eingef�hrt. Die in diesem Abschnitt erl�uterten Probleme sind in Gruppen zusammengefasst, je nachdem, ob sie auf beide oder nur auf die Enterprise Edition von Message Queue zutreffen.
Enterprise und Platform Edition
Wenn Sie sich bisher auf einen Eigenschaftswert der Beispiel-LDAP-Benutzer-Repository-Eigenschaften in der Datei default.properties verlassen haben, erh�lt Ihr JMS-Anwendungs-Client einen Sicherheitsausnahmefehler beim Versuch eine JMS-Verbindung herzustellen. Das passiert nach dem Upgrade auf Message Queue 3 2005Q1.
Wenn Ihr JMS-Client versucht, eine Verbindung mit dem Message Queue 3 2005Q1-Broker herzustellen, erhalten Sie einen Fehler im Broker-Protokoll und Ihr JMS-Client erh�lt folgenden Ausnahmefehler:
- Ein Fehler in RedHat Linux 2.1 (NSS-Fehlernr. 5078380) kann verursachen, dass die Methoden Message Queue C-API MQCreateConnection (Message Queue 3 2005Q1-C-API-Bibliothek) oder MQInitializeSSL Message Queue 3 2005Q1- oder 3.5 C-API-Bibliothek) h�ngen, falls ein Thread in der Message Queue C-API-Anwendung erstellt wurde, bevor diese beiden Methoden abgerufen werden.
Umgehung
Beim Verwenden der Message Queue 3 2005Q1-C-API-Bibliothek gibt es vier Optionen, um dieses Problem zu vermeiden:
- Aktualisieren Sie auf RedHat Linux 3.0.
- Setzen Sie die MQ_NSS_5078380_WORKAROUND-Umgebungsvariable vor dem Ausf�hren Ihrer Message Queue C-Client-Anwendung und setzen Sie die Message Queue Broker-Eigenschaft auf imq.authentication.type=basic.
- Rufen Sie MQInistializeSSL(<cert-db-path>) ab, bevor Sie einen Thread in Ihrer Message Queue C-Client-Anwendung starten. Mit dem Dienstprogramm certutil erstellen Sie die Zertifikat-DB-Dateien.
- Erstellen Sie eine Verbindung mit dem Message Queue-Broker, indem Sie MQCreateConnection abrufen, bevor Sie Threads starten. Die Konfigurationsdatei f�r eine Broker-Instanz kann nicht bearbeitet werden, ohne dass die Broker-Instanz mindestens ein Mal gestartet wurde. Der Grund hierf�r besteht darin, dass die Datei config.properties erst erstellt wird, wenn die Broker-Instanz das erste Mal gestartet wird. Wenn Sie einen Broker f�r die Verwendung austauschbarer Persistenz konfigurieren oder andere Konfigurationseigenschaften festlegen m�chten, f�hren Sie den Broker ein Mal aus (mit dem Namen der Instanz, der zum Erstellen des Brokers verwendet werden soll), um die Datei config.properties zu erstellen:
Nur Enterprise Edition
- In dieser Version werden lediglich vollst�ndig verbundene Broker-Cluster unterst�tzt. Dies bedeutet, dass jeder Broker in einem Cluster direkt mit allen anderen Brokern im Cluster kommunizieren muss. Wenn Sie Broker mithilfe des Befehlszeilenarguments imqbrokerd -cluster verbinden, stellen Sie sicher, dass alle Broker im Cluster enthalten sind.
- Ein Client, der mit einem Broker verbunden ist, der Teil eines Clusters ist, kann QueueBrowser nicht zum Durchsuchen von Warteschlangen nutzen, die sich auf Remote-Brokern in diesem Cluster befinden. Der Client kann nur die Warteschlangeninhalte durchsuchen, die sich auf dem Broker befinden, mit dem er direkt verbunden ist. Der Client sendet eventuell noch Meldungen an eine beliebige Warteschlange oder erh�lt Meldungen von einer Warteschlange oder einem Broker im Cluster. Die Einschr�nkung betrifft nur das Durchsuchen.
- Wird im Broker-Cluster kein Master-Broker verwendet, werden persistente Informationen, die in einem Broker gespeichert sind, der dem Cluster neu hinzugef�gt wird, nicht an die anderen Broker im Cluster weitergegeben.
- Ein Verbindungsdienst, der SSL verwendet, ist derzeit auf die Unterst�tzung von selbstsignierten Serverzertifikaten eingeschr�nkt, d. h. auf den beglaubigten Hostmodus.
- Wird ein JMS-Client bei Verwendung des http-Transports pl�tzlich beendet (z. B. durch den Befehl Strg-C), ben�tigt der Broker etwa eine Minute, bevor die Clientverbindung und alle damit zusammenh�ngenden Ressourcen freigegeben werden.
Wird innerhalb dieses Zeitraums eine andere Instanz des Clients gestartet, die versucht, dieselbe ClientID, Warteschlange oder dasselbe dauerhafte Abonnement zu verwenden, wird m�glicherweise der Ausnahmefehler „Client-ID ist bereits in Verwendung“ gemeldet. Dies stellt jedoch kein Problem dar, es handelt sich lediglich um eine Nebenwirkung des vorangehend beschriebenen Beendigungsvorgangs. Wenn der Client nach etwa einer Minute gestartet wird, sollte kein Fehler gemeldet werden.
Probleme bei der Verwaltung/Konfiguration
Die Dienstprogramme imqadmin und imqobjmgr geben einen Fehler aus, wenn CLASSPATH doppelte Anf�hrungszeichen auf Windows-Computern enth�lt (Fehler-ID 5060769).
Umgehung
Sie k�nnen diese Fehlermeldung ignorieren. Der Broker informiert die Konsumenten korrekt �ber m�gliche Fehler. Dieser Fehler hat keine Auswirkungen auf die Zuverl�ssigkeit des Systems.Die Option -javahome in allen solaris/win-Skripten funktioniert nicht, wenn der Wert ein Leerzeichen enth�lt (Fehler-ID 4683029).
Die Option -javahome wird von den Message Queue-Befehlen und -Programmen verwendet, um eine alternative Java 2-kompatible Runtime anzugeben. Der Pfad zur alternativen Java-Runtime darf jedoch keine Leerzeichen enthalten.
Beispiele f�r Pfade, die Leerzeichen enthalten:
Windows:
C:\jdk 1.4Solaris:
/work/java 1.4Umgehung
Installieren Sie die Java Runtime an einem Speicherort oder unter einem Pfad, der keine Leerzeichen enth�lt.Message Queue Ausgabe �berfl�ssiger Meldung an Systemprotokoll in Nicht-C-Umgebung (Fehler-ID 6193884)
Message Queue sendet �berfl�ssige Ausgabe an das Systemprotokoll, wenn der Broker in einer Nicht-C-Umgebung ausgef�hrt wird.
Umgehung
F�hren Sie den Broker in einer C-Umgebung aus.Broker-Probleme
In einem Broker-Cluster werden die Meldungen an eine entfernte Verbindung, die eventuell noch nicht gestartet wurde, in die Warteschlange gestellt (Fehler-ID 4951010).
Umgehung
Der Konsument erh�lt die Meldungen, sobald die Verbindung gestartet wurde. Die Meldungen werden an einen anderen Konsumenten gesendet, wenn die Verbindung beendet wird.HTTPS createQueueConnection verursacht zuweilen einen Ausnahmefehler unter Windows 2000 (Fehler-ID 4953348).
Umgehung
Versuchen Sie eine erneute Verbindung.Wenn Sie den Broker mit der Tastenkombination STRG+C beenden, werden die Transaktionen nach dem Schlie�en des Speichers eventuell bereinigt (Fehler-ID 4934446).
Der Broker meldet eventuell Fehler mit folgender Begr�ndung „Zugriff auf Speichermethode nach dem Schlie�en des Speichers.“, wenn der Broker heruntergefahren wird, w�hrend Meldungen oder Transaktionen verarbeitet wurden.
Umgehung
Sie k�nnen diese Fehlermeldung ignorieren. Der Broker informiert die Konsumenten korrekt �ber m�gliche Fehler. Dieser Fehler hat keine Auswirkungen auf die Zuverl�ssigkeit des Systems.Wenn der Persistenzspeicher zu viele Zielstandorte �ffnet, kann auf den Broker nicht mehr zugegriffen werden (Fehler-ID 4953354)
Umgehung
Diese Bedingung wird vom Broker verursacht, der das Deskriptor-Limit f�r die offenen Dateien im System erreicht. Unter Solaris und Linux erh�hen Sie das Dateideskriptor-Limit mit dem Befehl ulimit.Konsumenten verwaisen, wenn ein Zielstandort vernichtet wird (Fehler-ID 5060787).
Aktive Konsumenten verwaisen, wenn ein Zielstandort vernichtet wird. Sobald die Konsumenten verwaist sind, erhalten sie keine Meldungen mehr (auch wenn der Zielstandort erneut erstellt wird).
Umgehung
F�r dieses Problem gibt es keine Umgehung.Die Meldungsauswahl mit JMSMessageID funktioniert nicht (Fehler-ID 6196233).
Die Meldungsauswahl mit dem Selektor „JMSMessageID = '<message_id>'“ funktioniert nicht.
Umgehung
�ndern Sie den Selektor von:JMSMessageID = "ID:message-id-string"
in:
JMSMessageID IN ('ID:message-id-string', 'message-id-string')
Message Queue QueueBrowser zeigt ebenfalls nicht �bernommene Meldungen (Fehler-ID 6264003)
Beim Durchsuchen des Inhalts einer Warteschlange werden Meldungen, die in einer Transaktion erstellt, jedoch noch nicht �bernommen wurden, m�glicherweise in der QueueBrowser-Aufz�hlung angezeigt.
Umgehung
F�r dieses Problem gibt es keine Umgehung.
Dateien f�r NeuverteilungSun Java System Message Queue 3 2005Q1 (3.6) enth�lt folgende Dateien, die in bin�rer Form verwendet und frei verteilt werden d�rfen:
Eingabehilfen f�r Benutzer mit BehinderungenInformationen zu Eingabehilfen, die seit der Ver�ffentlichung dieses Mediums herausgegeben wurden, finden Sie in Abschnitt 508 der Produktbeurteilungen, die Sie bei Sun auf Anfrage erhalten. Sie k�nnen hiermit ermitteln, welche Versionen sich am besten f�r die Bereitstellung zug�nglicher L�sungen eignen. Aktualisierte Versionen der Anwendungen erhalten Sie unter: http://sun.com/software/javaenterprisesystem/get.html.
Informationen zum Einsatz von Sun im Bereich Eingabehilfen erhalten Sie unter http://sun.com/access.
Problemmeldungen und FeedbackWenn 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:
- Sun-Softwaresupport unter:
http://www.sun.com/service/sunone/softwareWenn Sie sich an die Kundenunterst�tzung wenden, halten Sie bitte die folgenden Informationen bereit, damit wir Sie optimal beraten k�nnen:
- Beschreibung des Problems, einschlie�lich der Situation, in der das Problem auftrat, sowie seine Auswirkungen auf Ihre Arbeit.
- Rechnertyp, Betriebssystem- und Produktversion, einschlie�lich s�mtlicher Patches und anderer Software, die mit dem Problem in Zusammenhang stehen k�nnten.
- Detaillierte Schritte zu den von Ihnen f�r die Reproduktion des Problems verwendeten Methoden.
- S�mtliche Fehlerprotokolle oder Kernspeicherausz�ge.
Sun Java System Softwareforum
Unter der nachfolgenden Adresse finden Sie ein Sun Java System Message Queue-Forum:
Wir freuen uns �ber Ihre Teilnahme.
Java Technology Forum
Unter dem Java Technology Forum finden Sie m�glicherweise ein f�r Sie interessantes JMS-Forum.
Kommentare sind willkommenSun m�chte seine Dokumentation laufend verbessern. Ihre Kommentare und Vorschl�ge sind daher immer willkommen.
Zum Mitteilen Ihrer Kommentare rufen Sie http://docs.sun.com auf und klicken Sie auf „Send Comments“. Geben Sie im Online-Formular den Dokumenttitel und die Teilenummer an. Die Teilenummer ist eine 7-stellige oder 9-stellige Zahl, die Sie auf der Titelseite des Handbuchs oder am Anfang des Dokuments finden. Der Buchtitel dieses Handbuchs lautet beispielsweise Sun Java System Message Queue 3 2005Q4 Versionshinweise und hat die Teilenummer 819-3558.
Weitere Informationen �ber SunN�tzliche Informationen �ber Sun Java System finden Sie unter den folgenden Internet-Adressen:
- Dokumentation zu Message Queue
http://docs.sun.com/coll/1307.1- Sun Java System-Dokumentation
http://docs.sun.com/prod/java.sys- Professionelle Dienste von Sun Java System
http://www.sun.com/service/sunps/sunone- Sun Java System-Softwareprodukte und -Dienste
http://www.sun.com/software- Sun Java System-Softwaresupport
http://www.sun.com/service/sunone/software- Sun Java System-Support und Knowledge Base
http://www.sun.com/service/support/software- Sun-Support und -Schulungen
http://training.sun.com- Sun Java System-Beratung und professionelle Dienste
http://www.sun.com/service/sunps/sunone- Sun Java System-Informationen f�r Entwickler
http://developers.sun.com- Sun-Supportdienste f�r Entwickler
http://www.sun.com/developers/support- Sun Java System-Softwareschulungen
http://www.sun.com/software/training- Sun-Softwaredatenbl�tter
http://wwws.sun.com/software
Copyright � 2005 Sun Microsystems, Inc. Alle Rechte vorbehalten.
Sun Microsystems, Inc. hat Rechte in Bezug auf geistiges Eigentum an der Technologie, die in dem in diesem Dokument beschriebenen Produkt enthalten ist. Diese Urherberrechte k�nnen insbesondere und ohne Einschr�nkungen eines oder mehrere der unter http://www.sun.com/patents aufgelisteten US-Patente und weitere Patente oder angemeldete Patente in den USA und anderen L�ndern einschlie�en.
SUN URHEBERRECHTLICH/VERTRAULICH.
Rechte der US-Regierung – Kommerzielle Software. Regierungsbenutzer unterliegen der standardm��igen Lizenzvereinbarung von Sun Microsystems, Inc. sowie den anwendbaren Bestimmungen der FAR und ihrer Zus�tze.
Die Verwendung unterliegt Lizenzbestimmungen.
Diese Ausgabe kann von Drittanbietern entwickelte Bestandteile enthalten.
Sun, Sun Microsystems, das Sun-Logo, Java, Solaris und Sun[tm] ONE sind Marken oder eingetragene Marken von Sun Microsystems, Inc. in den USA und anderen L�ndern.
Alle SPARC-Warenzeichen werden unter Lizenz verwendet und sind Warenzeichen oder eingetragene Warenzeichen von SPARC International, Inc. in den USA und anderen L�ndern.
UNIX ist ein eingetragenes Warenzeichen in den USA und in anderen L�ndern und exklusiv durch X/Open Company, Ltd. lizenziert.