WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

Dateien zu einem Brokerarchiv hinzufügen

Um Dateien in einer Ausführungsgruppe zu implementieren, müssen Sie sie in ein Brokerarchivdatei (BAR) einschließen.

Vorbereitungen:

Erstellen Sie eine Brokerarchivdatei (BAR-Datei) für jede Konfiguration, die implementiert werden soll. Nähere Informationen finden Sie unter Brokerarchivdatei (BAR-Datei) erstellen.

Sie können alle implementierbaren Ressourcen Ihres Arbeitsbereichs zu einer BAR-Datei hinzufügen. Wenn Sie Quellendateien des Arbeitsbereichsprojekts hinzufügen auswählen, werden die Quellen- und Projektdateien für alle Nachrichtenflüsse, Nachrichtenmodellschemadateien, Nachrichtengruppen oder andere implementierbare Ressourcen im Brokerarchiv hinzugefügt. Weitere Informationen zu den Dateien, die in ein Brokerarchiv eingeschlossen werden können, finden Sie im Abschnitt Brokerarchiv.

Untergeordnete Nachrichtenflüsse, die in .msgflow-Dateien definiert sind, werden in der Brokerarchivdatei nicht als separate Elemente angezeigt und automatisch hinzugefügt. Um diese untergeordneten Nachrichtenflüsse einzuschließen, müssen Sie lediglich den übergeordneten Nachrichtenfluss hinzufügen. Untergeordnete Nachrichtenflüsse, die in .subflow-Dateien definiert sind, werden in der Brokerarchivdatei als separate Elemente angezeigt und können als Einzelressourcen implementiert werden. Wird ein übergeordneter Nachrichtenfluss hinzugefügt, der diese untergeordneten Nachrichtenflüsse enthält, werden diese untergeordneten Nachrichtenflüsse der BAR-Datei bei deren Erstellung automatisch hinzugefügt.

Nachrichtenflussdateien, DLL-, ESQL-, Java™-JAR-, PHP-, MAP-, XML-, XSLT-Dateien und Nachrichtengruppen können wie im Folgenden erläutert manuell hinzugefügt werden. JAR-Dateien oder .NET-Assemblys (DLL-Dateien), die von JavaCompute-Knoten oder .NETCompute-Knoten in Nachrichtenflüssen benötigt werden, werden allerdings automatisch aus dem Java-Projekt oder Nachrichtenbrokerprojekt hinzugefügt, wenn der Nachrichtenfluss hinzugefügt wird. XML- und XSL-Dateien werden auch automatisch hinzugefügt, wenn sie vom Nachrichtenfluss benötigt werden.

Beim Hinzufügen eines Nachrichtenflusses (definiert in einer .msgflow-Datei) zu einer BAR-Datei können Sie den Nachrichtenfluss als .msgflow-Datei oder oder als kompilierten Nachrichtenfluss (definiert in einer .cmf-Datei) hinzufügen. Wählen Sie Ressourcen kompilieren und integrieren aus, um Flüsse als .cmf-Dateien hinzuzufügen. Sie können denselben Nachrichtenfluss nicht sowohl als .cmf-Datei als auch als .msgflow-Datei einer BAR-Datei hinzufügen. Wenn der Nachrichtenfluss einen der folgenden Knoten enthält, können Sie ihn nicht als .msgflow-Datei hinzufügen:
  • Einen benutzerdefinierten Knoten, der aus einem untergeordneten Nachrichtenfluss erstellt wird
  • Einen untergeordneten Nachrichtenflussknoten, der einen untergeordneten Nachrichtenfluss darstellt, der in einer .msgflow-Datei definiert ist
  • Einen WebSphere Message Broker Version 7.0 Mapping-Knoten
  • Einen MQOptimizedFlow-Knoten

Wenn Sie die Option Ressourcen kompilieren und integrieren auswählen, wird der ESQL-Code in die .cmf-Datei eingebettet, die auf ihn verweist. Wenn Sie die Option Ressourcen kompilieren und integrieren nicht auswählen, werden ESQL-Dateien als Einzelressourcen in die BAR-Datei aufgenommen.

Beachten Sie, dass nicht erwartete Ergebnisse die Folge sein können, wenn Ihre BAR-Datei eine Kombination aus kompilierten und nicht kompilierten Ressourcen enthält. Wenn Sie beispielsweise mit der Option Ressourcen kompilieren und integrieren eine BAR-Datei erstellen, die eine ESQL-Datei und einen Nachrichtenfluss enthält, wird der ESQL-Code (Extended SQL) in die kompilierte Nachrichtenflussdatei (.cmf) eingebettet. Wenn Sie dann den ESQL-Code aktualisieren und die Option Ressourcen kompilieren und integrieren bei dessen Aufnahme in die BAR-Datei inaktiviert ist, wird die ESQL-Datei zwar als Einzelressource hinzugefügt, die Datei .cmf verwendet aber dennoch den ursprünglichen ESQL-Code, da der ursprüngliche ESQL-Code weiterhin in der .cmf-Datei eingebettet ist. Um sicherzustellen, dass alle Ihre Ressourcen entweder kompiliert oder nicht kompiliert werden, müssen Sie bei einer Änderung der Option Ressourcen kompilieren und integrieren auch die Option Vor dem Build Inhalt des Brokerarchivs entfernen auswählen und die BAR-Datei erneut erstellen.

Die JAR-Dateien müssen nur nach einer Aktualisierung erneut implementiert werden. Wenn auf dem Computer, auf dem der Broker ausgeführt wird, bereits JAR-Dateien Ihrer BAR-Datei vorhanden sind, können Sie diese JAR-Dateien vor der erneuten Implementierung aus der BAR-Datei entfernen. Dem Broker stehen unter anderem die von Ihnen implementierten JAR-Dateien sowie die JAR-Dateien in den Verzeichnissen für gemeinsam genutzte Klassen oder im Unterverzeichnis classes des Installationsverzeichnisses zur Verfügung. So werden beispielsweise die Dateien com.ibm.mq.jar, ConfigManagerProxy.jar, jplugin2.jar und javacompute.jar dem Broker immer angezeigt und müssen nicht separat implementiert werden.

Implementierte Dateien, die in Ausführungsgruppen des Brokers implementiert wurden, können nicht mehr gelesen werden. Aus diesem Grund wird empfohlen, eine Kopie der implementierten BAR-Datei bzw. der darin enthaltenen Dateien zu erstellen.

Wenn Sie einer BAR-Datei mithilfe des WebSphere Message Broker Toolkits Dateien hinzufügen möchten, führen Sie die folgenden Schritte aus.

  1. Klicken Sie doppelt auf die BAR-Datei, um sie zu öffnen. Der Inhalt der BAR-Datei wird im Brokerarchiveditor angezeigt. (Wenn die BAR-Datei neu ist, ist die Ansicht leer.)
  2. Wählen Sie auf der Vorbereitungsseite des Brokerarchiveditors die implementierbaren Arbeitsbereichressourcen aus, die zu der Brokerarchivdatei hinzugefügt werden sollen.

    Wählen Sie Anwendungen aus, um eine Liste der implementierbaren Anwendungen anzuzeigen. Wenn Sie aus dieser Liste eine Anwendung auswählen, werden mit dieser Anwendung alle darin enthaltenen Ressourcen implementiert. Innerhalb einer Anwendung implementierte Ressourcen werden von den Ressourcen anderer Anwendungen isoliert. Sollen die Ressourcen direkt in der Ausführungsgruppe implementiert werden, müssen Sie auf Nachrichtenflüsse, Bibliotheken und sonstige Nachrichtenflussabhängigkeiten klicken. Nach der Implementierung dieser Ressourcen sind sie für alle anderen implementierten Ressourcen in derselben Ausführungsgruppe sichtbar.

    Sie können eine einzelne Ressource (Anwendung, Bibliothek, .NET-Anwendungsdomäne oder Projektressource) für die Aufnahme in die BAR-Datei auswählen oder durch Auswahl des entsprechenden Stammelements alle Anwendungen, Bibliotheken, .NET-Anwendungsdomänen oder Projektressourcen des Arbeitsbereichs hinzufügen. Wenn die von Ihnen gewählte Anwendung auf eine oder mehrere Bibliotheken verweist, werden diese Bibliothek der Anwendungsdatei .appzip als verschachtelte .libzip-Dateien hinzugefügt. Diese referenzierten Bibliotheken sind privat und außerhalb der Anwendung nicht für die Ressourcen zugänglich. Daher sind diese Bibliotheken auf der Vorbereitungsseite standardmäßig nicht ausgewählt. Wenn Sie eine Bibliothek als Bibliothek auf Ausführungsgruppenebene implementieren möchten, die für andere Ressourcen zugänglich ist, wählen Sie die Bibliothek aus, um sie separat zu implementieren. Für diese Bibliothek wird eine .libzip-Datei erstellt, die der BAR-Datei auf Stammebene hinzugefügt wird.

    Wenn Sie eine Bibliothek auswählen, die sich auf andere Bibliotheken bezieht, werden diese referenzierten Bibliotheken ebenfalls als .libzip-Dateien zur BAR-Datei hinzugefügt.

    Wenn die von Ihnen ausgewählte Anwendung auf eine oder mehrere .NET-Anwendungsdomänen verweist, werden diese Anwendungsdomänen der BAR-Datei auf Stammebene als .appdomainzip-Datei hinzugefügt.

  3. Optional: Wenn Quellendateien eingeschlossen werden sollen, wählen Sie Quellendateien des Arbeitsbereichsprojekts hinzufügen aus.

    Wenn Sie Quellendateien des Arbeitsbereichsprojekts hinzufügen auswählen, werden Quellenprojekte für alle Anwendungen, Bibliotheken und sonstigen kompilierten Ressourcen zum Ordner src der BAR-Datei hinzugefügt.

  4. Optional: Wenn Sie vor der Erstellung der neuen BAR-Datei den bestehenden Inhalt aus der BAR-Datei entfernen möchten, wählen Sie Vor dem Build Inhalt des Brokerarchivs entfernen aus.
  5. Optional: Wenn Sie einen Nachrichtenfluss zum zweiten Mal zu einem Brokerarchiv hinzufügen und die Nachrichtenflussparameter auf der Seite 'Verwalten' geändert haben, wählen Sie Konfigurierbare Eigenschaftswerte überschreiben aus, um die Konfigurationseinstellungen zurückzusetzen. Ist dieses Steuerelement inaktiviert, bleiben bestehende Einstellungen erhalten, wenn ein Nachrichtenfluss ersetzt wird.
  6. Optional: Um Nachrichtenflüsse als kompilierte .cmf-Nachrichtenflussdateien und den ESQL-Code direkt in die .cmf-Datei der einzelnen Nachrichtenflüsse einzuschließen, die auf eine ESQL-Datei verweisen, müssen Sie die Option Ressourcen kompilieren und integrieren auswählen. Wenn Sie einen Nachrichtenfluss zu einer BAR-Datei hinzufügen, wird sie standardmäßig als .msgflow-Datei hinzugefügt. Standardmäßig wird jede ESQL-Datei, auf die von mindestens einem Ihrer Nachrichtenflüsse verwiesen wird, als eigene Ressource implementiert, auf die von mehreren .msgflow-Dateien zugegriffen werden kann. Wenn einer der Nachrichtenflüsse, die Sie Ihrer BAR-Datei hinzufügen, einen untergeordneten Nachrichtenfluss enthält, der in einer .msgflow-Datei definiert ist, müssen Sie die Option Ressourcen kompilieren und integrieren auswählen.
  7. Klicken Sie auf Build and Save (Erstellen und speichern).

In der Seitenverwaltung werden die Dateien aufgelistet, die sich jetzt in Ihrer BAR-Datei befinden. Erweitern Sie Ihre Anwendungen und Bibliotheken, damit Sie den zugehörigen Inhalt sehen. Kompilierte Ressourcen in der BAR-Datei werden in der Baumstruktur in alphabetischer Reihenfolge angezeigt. Sie können nur Stammelemente bearbeiten; wenn Sie der BAR-Datei beispielsweise eine Anwendung hinzugefügt haben, können Sie die Datei .appzip umbenennen oder ihr Kommentare hinzufügen. Die Ressourcen in der Datei .appzip können nicht bearbeitet werden, eine Bearbeitung der konfigurierbaren Eigenschaften für diese Ressourcen ist jedoch möglich.

Sie können keine einzelnen Ressourcen aus den Dateien .appzip, .appdomainzip oder .libzip entfernen. Wenn Sie diese Ressourcen entfernen möchten, müssen Sie die Anwendung, .NET-Anwendungsdomäne oder die Bibliothek entfernen.

Sie können die Anzeige der Quellendateien unterdrücken, indem Sie die Option Erstellte Ressourcen oder Konfigurierbare Eigenschaften aus der Liste im Menü Filtern nach auswählen.

Weitere Schritte:

Wenn Sie konfigurierbare Eigenschaften verwenden, lesen Sie den Abschnitt Konfigurierbare Eigenschaften bearbeiten.

Beachten Sie die Informationen im Abschnitt Mehrere Instanzen eines Nachrichtenflusses einem Brokerarchiv hinzufügen, wenn Sie mehrere Instanzen eines Nachrichtenflusses mit unterschiedlichen Werten für die konfigurierbaren Eigenschaften haben möchten.

Um weitere Änderungen an Ihrer BAR-Datei vorzunehmen, lesen Sie Abschnitt Brokerarchivdatei manuell bearbeiten.

Sobald Ihre BAR-Datei vollständig ist, implementieren Sie diese mithilfe der Anweisungen im Abschnitt Brokerarchivdatei implementieren.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:21:16


TaskthemaTaskthema | Version 8.0.0.5 | af03880_