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 Neues Brokerarchiv erstellen.

Sie können alle implementierbaren Ressourcen Ihres Arbeitsbereichs zu einer BAR-Datei hinzufügen. Wenn Sie Quellendateien einschließen auswählen, werden die Quellendateien für alle Nachrichtenflüsse, Nachrichtenmodellschemadateien, Nachrichtensätze 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, ESQL-, MAP-, XML-, XSLT-, Java-JAR-, PHP-Dateien und Nachrichtensätze können wie folgt manuell hinzugefügt werden. JAR-Dateien, die von JavaCompute-Knoten in Nachrichtenflüssen benötigt werden, werden jedoch beim Hinzufügen des Nachrichtenflusses automatisch aus dem Java-Projekt hinzugefügt. XML- und XSL-Dateien werden auch automatisch hinzugefügt, wenn sie vom Nachrichtenfluss benötigt werden.

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 im Verzeichnis 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 Toolkit 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 oder Projektressource) für die Aufnahme in die BAR-Datei auswählen oder durch Auswahl des entsprechenden Stammelements alle Anwendungen, Bibliotheken 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.

  3. Optional: Wählen Sie Quellendateien einschließen aus, wenn Quellendateien eingeschlossen werden sollen.

    Wenn Sie Quellendateien einschließen auswählen, werden dem Ordner src der BAR-Datei alle Anwendungen, Bibliotheken und sonstigen kompilierten Ressourcen 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: Soll ESQL-Code direkt in die kompilierte .cmf-Nachrichtenflussdatei aller Nachrichtenflüsse eingefügt werden, die auf eine ESQL-Datei verweisen, wählen Sie die Option ESQL bei Kompilierung von .msgflow integrieren aus. Standardmäßig wird jede ESQL-Datei, auf die von mindestens einem Ihrer Nachrichtenflüsse verwiesen wird, als eigene Ressource implementiert, auf die von mehreren .cmf-Dateien zugegriffen werden kann. Enthält die BAR-Datei einen untergeordneten Nachrichtenfluss, der in einer .subflow-Datei definiert ist, kann der ESQL-Code nicht direkt in die kompilierten Nachrichtenflussdateien eingefügt werden.
  7. Klicken Sie auf 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. Die kompilierten 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 innerhalb der Datei .appzip können nicht bearbeitet werden, die Bearbeitung der konfigurierbaren Eigenschaften für diese Ressourcen ist jedoch möglich.

Sie können keine einzelnen Ressourcen aus den Dateien .appzip oder .libzip entfernen; wenn Sie diese Ressourcen entfernen möchten, müssen Sie die Anwendung oder 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, 2011Copyright IBM Corporation 1999, 2011.

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-01-20 09:48:32


TaskthemaTaskthema | Version 8.0.0.0 | af03880_