IBM^(R) WebSphere^(R) Business Integration Message Brokers Toolkit Version 5.1 README

Änderungsprotokoll:
Allgemeine Verfügbarkeit: 23. Juli 2004
Updated: 20 August 2004

(C) Copyright IBM Corporation 2004. Alle Rechte vorbehalten.

Willkommen bei IBM WebSphere Business Integration Message Brokers Toolkit Version 5.1. Diese Readme-Datei enthält Informationen, die zum Zeitpunkt der Erstellung des Onlineinformationszentrums nicht zur Verfügung standen. Sie gilt nur für die Installation von Message Brokers Toolkit Version 5.1 unter Microsoft^(R) Windows^(R) und dessen Verwendung mit WebSphere Business Integration Message Broker und WebSphere Business Integration Event Broker Version 5.0.

WARNUNG!
Installieren Sie Message Brokers Toolkit Version 5.1 nur, wenn Sie WebSphere Application Development Integration Edition (WSADIE) Version 5.1 installiert haben. Installieren Sie Version 5.1 nicht, wenn Sie über eine vorherige Version von WSADIE verfügen; in diesem Fall müssen Sie Message Brokers Toolkit Version 5.0 verwenden, das zusammen mit WebSphere Business Integration Message Broker und WebSphere Business Integration Event Broker Version 5.0 zur Verfügung gestellt wird. Die Funktionen von Message Brokers Toolkit Version 5.1 sind mit denen von Message Brokers Toolkit Version 5.0.3 (Fix Pack 3) identisch.

Weitere Informationen zu allen anderen Komponenten von WebSphere Business Integration Message Broker und WebSphere Business Integration Event Broker Version 5.0 finden Sie in der Readme-Datei der Version 5.0.

Installing Message Brokers Toolkit Version 5.1 in a team environment
WSADIE Version 5.1 is not a prerequisite for every installation of the Message Brokers Toolkit Version 5.1. However, if at least one of your Message Broker Toolkit installations integrates with WSADIE Version 5.1, all your Message Broker Toolkit installations must be at Version 5.1 to ensure data sharing and integrity.

If you are not using WSADIE Version 5.1 on any system, or you are using WSADIE Version 5.0, you must install Message Brokers Toolkit Version 5.0.

Wichtige Informationen für alle Benutzer
Es wird dringend empfohlen, die aktuellste Version der Readme-Datei zu lesen. Diese (nur englischsprachige) Version der Readme-Datei kann unter folgender Adresse aufgerufen werden:
http://www.ibm.com/software/integration/mqfamily/support/readme/

Die Datei install.html enthält Informationen zur vollständigen Installation auf.

Übersetzte Versionen der Readme-Datei und der Datei 'install.html' sind verfügbar unter: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/

Wichtige Informationen für Benutzer, die eine Migration ausführen

If you are migrating, refer to the install.html file for details of the actions that you must take before you install.

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first; the two versions cannot coexist.

The information center provides further information about migration; to view this before you install, download a stand-alone version of the information center (see the "Documentation" section for instructions).

Beachten Sie folgende Migrations- und Implementierungseinschränkungen:

• Wenn Sie Nachrichtenflüsse, Nachrichtengruppen und Nachrichtenzuordnungen mit einem Toolkit der Version 5.1 erstellen oder ändern, können Sie mit einem Toolkit der Version 5.0 nicht mehr auf diese Ressourcen zugreifen. Stellen Sie sicher, dass sich alle Benutzer, die Projekte in einer Teamumgebung gemeinsam verwenden, dieser Einschränkung bewusst sind und dass sie, falls notwendig, Sicherungskopien erstellen.
• Verwenden Sie eine migrierte Version aller benutzerdefinierter Knoten-Plug-ins des Lieferanten, um Nachrichtenflüsse, die diese Knoten-Plug-ins enthalten, erfolgreich zu implementieren.

Versionen unterschiedlicher Systeme können Ressourcen gemeinsam verwenden:

• Sie können alle unter Version 5.0 entwickelten Projekte implementieren, ohne sie ändern zu müssen.
• Sie können Broker-Archivierungsdateien, die in dieser Version erstellt wurden, in einen Arbeitsbereich der Version 5.0 importieren und erfolgreich implementieren.

Dokumentation
Das eigenständige Informationszentrum für WebSphere Business Integration Message Broker und WebSphere Business Integration Event Broker Version 5.0 wurde so aktualisiert, dass es die für Message Brokers Toolkit Version 5.1 erforderlichen Änderungen beinhält und für den Download verfügbar ist. Sie können das ZIP-Archiv von folgender Adresse herunterladen: ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V5.1_Tooling/wbimb_help.zip

Lesen Sie die Datei 'installing_and_managing.htm', die in der Datei 'wbimb_help.zip' enthalten ist.

Unterstützung
Diese Readme-Datei enthält durchgängig Verweise auf Fehlernummern. Diese Nummern beziehen sich auf interne IBM Problemnummern; unter Umständen ist es hilfreich, wenn Sie Ihrem zuständigen IBM Ansprechpartner bei der Erläuterung von Problemen diese Nummern nennen können.
Aktuelle Informationen zu bekannten Problemen und verfügbaren Fixes finden Sie für WebSphere Business Integration Message Broker unter
http://www.ibm.com/software/integration/wbimessagebroker/support/
und für WebSphere Business Integration Event Broker unter
http://www.ibm.com/software/integration/wbieventbroker/support/
.

Funktionsaktualisierungen
Sie sollten in regelmäßigen Abständen überprüfen, ob Funktionsaktualisierungen (dazu gehören auch Aktualisierungen der Dokumentation) zur Verfügung stehen.

Gehen Sie hierzu wie folgt vor:

1. Wählen Sie aus dem Toolkit Hilfe > Software Updates (Softwareaktualisierungen) > New Updates (Neue Aktualisierungen). Eclipse sucht daraufhin verfügbare Aktualisierungen.
2. Eclipse zeigt an, welche Aktualisierungen zur Verfügung stehen. Wählen Sie diejenigen aus, die Sie installieren möchten.
3. Wenn Sie Aktualisierungen zur Installation auswählen, erhalten Sie die Warnung, dass die Funktionen nicht digital signiert wurden. Diese Warnung kann ignoriert werden.
4. Nach der Installation der Funktionen werden Sie von Eclipse aufgefordert, die Workbench neu zu starten.
5. Nach dem Neustart der Workbench können die neuen installierten Funktionen verwendet werden.

Inhalt

Einschränkungen

• WebSphere Studio Application Developer Integration Edition
• Koexistenz
• Installation
• Im Anschluss an die Installation

Bemerkungen und Marken

Nützliche Webseiten

Einschränkungen

In diesem Abschnitt werden die Einschränkungen im Hinblick auf die einzelnen Komponenten von WebSphere Business Integration Message Broker und WebSphere Business Integration Event Broker beschrieben. 

WebSphere Studio Application Developer Integration Edition

Zur Erweiterung einer Workbench von WebSphere Studio Application Developer Integration Edition (WSADIE) mit diesem Produkt müssen Sie WSADIE auf die entsprechende unterstützte Stufe aktualisieren. WSADIE Version 5.1 GA mit "Interim Fix 002 - General Fixes 2.0.0" der WSADIE-Workbench kann erweitert werden.

Sie müssen außerdem den Fix "WebSphere Business Integration Message Broker v5.1.0 Interim Fix 001 - Prerequisite Fixes 1.0.0.1" anwenden, nachdem Sie WebSphere Business Integration Message Broker oder WebSphere Business Integration Event Broker installiert haben.

Die Datei install.html enthält detaillierte Anweisungen.

Koexistenz

If you install Message Brokers Toolkit Version 5.1 on a system on which you have already installed Message Brokers Toolkit Version 5.0, you must uninstall the Version 5.0 Toolkit first. The two versions cannot coexist, however you can share resources between versions on different systems:

• Sie können alle unter Version 5.0 entwickelten Projekte implementieren, ohne sie ändern zu müssen.
• Sie können Broker-Archivierungsdateien, die in dieser Version erstellt wurden, in einen Arbeitsbereich der Version 5.0 importieren und erfolgreich implementieren.

Informationen zur Migration Ihrer Ressourcen und Benutzerdaten auf Version 5.1 finden Sie im Informationszentrum im Abschnitt zur Migration.

Installation

1. Wenn Sie die Lizenzvereinbarung bei der Installation NICHT akzeptieren, wird ein Dialogfenster mit den Schaltflächen JA und NEIN angezeigt. Ganz gleich, auf welche Schaltfläche Sie klicken; Sie kehren immer zu der Seite mit der Lizenzvereinbarung zurück. Korrekterweise sollte die Installation bei Klicken auf JA abgebrochen und das Launchpad geschlossen werden.

   Wenn Sie während der Installation auf der Lizenzvereinbarungsseite auf BACK (Zurück) klicken, werden mehrere Java^TM Virtual Machine (JVM)-Fehlernachrichten angezeigt, und die Klickstartleiste blockiert.

   Fehlerumgehung: Akzeptieren Sie die Lizenzvereinbarung, wenn Sie das Produkt erfolgreich installieren möchten.

Im Anschluss an die Installation

1. Wenn Sie Message Brokers Toolkit Version 5.1 installiert und Version 5.0 ersetzt haben:
   1. Defect 34555
      Sie müssen alle Projekte wiederherstellen, die in Ihrem Arbeitsbereich definiert sind.
   2. Defect 34930
      Wenn INSTALLATIONSPFAD\eclipse\workspace\.metadata vorhanden ist, wird zwar beim Öffnen des Message Brokers Toolkits der Aktualisierungsmanager korrekt gestartet, aber alle Aktualisierungen Ihrer Plug-ins schlagen fehl. Aus diesem Grund wird Message Brokers Toolkit nicht mit den korrekten Plug-in-Ebenen geöffnet, und es können Toolkit-Fehler auftreten.
      
      Wenn Sie sich beispielsweise in der Broker Application Development-Perspektive befinden, stellen Sie unter Umständen fest, dass der Menüpunkt Nachrichtendefinitionsdatei auf der über File > New Menu (Datei > Neues Menü) aufgerufenen Liste fehlt. Das ist eine Anzeige dafür, dass Ihre Installation nicht die korrekte Ebene oder Version von Plug-ins für das Nachrichtenbroker-Toolkit beinhaltet.
      
      Sie können überprüfen, ob die von Ihnen verwendete Plug-in-Ebene korrekt ist, indem Sie im Fenster 'Nachrichtenbroker-Toolkit für WebSphere Studio' auf Help > About Message Brokers Toolkit for WebSphere Studio - Message Broker (Hilfe > Informationen zum Nachrichtenbroker-Toolkit für WebSphere Studio - Nachrichtenbroker) klicken. Unter "Nachrichtenbroker-Toolkit für WebSphere Studio" finden Sie die Versionsnummer. Die angezeigte Version ist Version 5.1.0, wenn nach der Installation von Version 5.1 die korrekten Versionen verwendet werden. Gehen Sie wie folgt vor, wenn die angezeigte Version niedriger ist:
      1. Löschen Sie das Verzeichnis .metadata.
      2. Öffnen Sie das Nachrichtenbroker-Toolkit neu.
      3. Importieren Sie Ihre vorhandenen Projekte neu in den Arbeitsbereich, indem Sie für jedes Projekt folgende Schritte durchführen:
         1. Klicken Sie auf File > Import (Datei > Importieren).
         2. Wählen Sie im daraufhin angezeigten Importassistenten die Option Existing Project into Workspace (Bestehendes Projekt in Arbeitsbereich) aus, und klicken Sie auf Next (Weiter).
         3. Klicken Sie auf Browse (Durchsuchen), und definieren Sie die Adresse des Projekts in Ihrem Arbeitsbereich.
         4. Klicken Sie auf Fertig stellen.
2. Defect 32898
   Wenn Ihre LAN-Einstellungen für den Zugriff auf den lokalen Host nicht richtig konfiguriert wurden (möglicherweise wegen der Einstellungen in Ihrem automatischen Konfigurationsscript), kann einer der folgenden Fehler auftreten:
   • Ihr Hilfe-Browser wird leer angezeigt.
   • Ihr Hilfe-Browser zeigt statt einer Hilfeseite einen HTTP-Fehler an.
   • Es kommt zu langen Verzögerungen, wenn das Information Center geladen wird.
   
   Lösung: Ihr Systemadministrator kann die LAN-Einstellungen so konfigurieren, dass die Hilfeinformationen erfolgreich vom lokalen Hilfeserver aufgerufen werden können. Dazu müssen folgende Einstellungen vorgenommen werden:
   1. Öffnen Sie in der Systemsteuerung die Internetoptionen, und klicken Sie in der Registerkarte 'Verbindungen' auf die Schaltfläche LAN-Einstellungen.
   2. Wenn Ihr Host DHCP für IP-Zuordnungen verwendet, stellen Sie sicher, dass das Kontrollkästchen Automatische Suche der Einstellungen nicht ausgewählt ist.
   3. Wenn Sie einen Proxyserver verwenden, stellen Sie sicher, dass Proxyserver für lokale Adressen umgehen ausgewählt ist.
   4. Fügen Sie in den erweiterten Einstellungen für Proxys '127.0.0.1;localhost' zu 'Ausnahmen' hinzu, wenn diese Adresse nicht aufgeführt ist.
   5. Verwenden Sie für die Proxyeinstellungen ein automatisches Konfigurationsscript und sind sich nicht sicher, ob das Script korrekt ist, deaktivieren Sie das Kontrollkästchen Automatisches Konfigurationsscript verwenden.
   
   Sollten Ihre Probleme trotz dieser Schritte nicht behoben sein, versuchen Sie den Port und die Hosteigenschaften in der Datei org.eclipse.tomcat\preferences.ini zu ändern. Legen Sie 'host=localhost' oder 'host=127.0.0.1' fest. Das sollte die Lösung sein. Wenn Sie eine Firewall haben, müssen Sie möglicherweise 'port=80' (oder einen anderen Firewall-geeigneten Wert) festlegen.
3. Defect T32243
   The mxsd file extension is not associated correctly with the Message Definition Editor. To ensure that mxsd files are opened in the Message Definition Editor as the default action, select Window > Preferences > Workbench > File Associations. Scroll down the list of file types and select *.mxsd. Then select Message Definition Editor in the list of Associated editors. Click Default then OK.
4. Defect 36422
   In the topic "Distributing a user-defined node" in the online information center, the instructions about extracting the zip file are incorrect. Step 2 of the instructions tells you to unzip the file to the install_dir\eclipse\plugins directory. Instead, the correct location to unzip the file to is the WBIMB_install_dir\evtoolkit\eclipse\plugins directory.
   In the topic "Installing a user-defined extension on a broker domain" in the online information center, the install location for Windows is ambiguous. For C user-defined nodes, the topic tells you to use the location install_dir\bin. This should be WBIMB_install_dir\bin. For Java user-defined nodes, the topic tells you to use the location install_dir\jplugin. This should be WBIMB_install_dir\jplugin.
5. Defect 36589
   If you use any of the predefined ESQL constants, such as MQMO_NONE, in ESQL code, the code is flagged as Message Brokers Toolkit Version 5.0 compatible. This means that you cannot deploy message flows referencing this ESQL code to a Version 2.1 broker, regardless of the compatibility level set in the preferences. This limitation will be lifted in the next fix pack for Message Brokers Toolkit Version 5.1.
6. Defect 36605
   The description of the property Namespace in topics "Wildcard attribute logical properties" (ad11870_) and "Wildcard element logical properties" (ad11890_) is incorrect. In the current implementation, there is no enumerated list of options and the field is initially blank. You can specify a namespace in this field; this causes a Task List warning to be displayed which explains that the broker will not use this information and will allow an element from any namespace to be used as the wildcard.
7. Defect 36638
   The Message Set Editor Preferences topic (ad15810_) describes only the options available in the Version 5.0 toolkit. The Version 5.0 options are not available for Version 5.1. In the Version 5.1 toolkit, the options are:
   • Message set editor settings, Outline view settings. These options are displayed but are not operational:
     • Group by namespace and then by collections
     • Group by collections and then by namespace
   • Message definition editor settings:
     • Show base complex types
       If you have defined one or more complex types based on other complex types, select this option if you want the content of those base complex types to be displayed in the message definition editor overview and outline views (this is selected by default).
       If you do not want them displayed, clear the check box.
8. TDS properties
   The grouping and order of TDS properties of global attribute, global element, local attribute, and local element shown in the workbench differ from the grouping and order shown in the topics that describe them. Their meaning and use is unchanged.
9. Defect 36655
   If you uninstall the toolkit by invoking uninstaller.exe with the -silent option, the uninstall program returns control immediately and runs as a background task. If you do not want the uninstall program to return until it has completed, you must invoke the uninstaller within java using this command:
   java -cp <install_dir>\_uninst\studio\uninstall.jar run -silent
   where <install_dir> is the directory in which you installed the product.
   If you do not have a jvm configured (Version 1.3.1 or above), you can use the jvm within the installed product in directory <install_dir>\_sjvm\bin\. If you do this, you might have to delete this directory manually when uninstallation is complete.