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.

Brokerarchivdatei implementieren

Nach der Erstellung und dem Füllen einer Brokerarchivdatei (BAR-Datei) müssen Sie die Datei in einer Ausführungsgruppe auf einem Broker implementieren, damit die Dateiinhalte im Broker verwendet werden können.

Vorbereitungen:

Bei diesem Thema wird vorausgesetzt, dass Sie bereits eine BAR-Datei erstellt haben. Der Abschnitt Brokerarchivdatei (BAR-Datei) erstellen enthält weitere Informationen hierzu.

Wählen Sie eine der folgenden Methoden zur Implementierung einer Brokerarchivdatei aus:

Wenn Sie Änderungen an einer Brokerarchivdatei (BAR-Datei) vorgenommen haben und diese an einen oder mehrere Broker weitergeben möchten, können Sie die aktualisierte BAR-Datei erneut implementieren, indem Sie die Anweisungen im Abschnitt BAR-Datei erneut implementieren befolgen:

Der Modus, in dem der Broker betrieben wird, hat unter Umständen Einfluss auf die Anzahl der Ausführungsgruppen und Nachrichtenflüsse, die implementiert werden können, sowie auf die Knotentypen, die verwendet werden können. Weitere Informationen finden Sie unter Einschränkungen, die in jedem Betriebsmodus gelten.

Bei der Implementierung eines Nachrichtenflusses, der einen in einer .subflow-Datei definierten untergeordneten Nachrichtenfluss enthält, muss dieser untergeordnete Fluss in der derselben Ausführungsgruppe implementiert werden. Der Nachrichtenfluss kann nicht zuerst implementiert werden; Sie haben aber die Wahl, den untergeordneten Nachrichtenfluss zuerst oder aber den untergeordneten Nachrichtenfluss und den Nachrichtenfluss zusammen zu implementieren. Wenn Sie einen untergeordneten Nachrichtenfluss, der in einer .subflow-Datei definiert ist, erneut in einer Ausführungsgruppe implementieren, werden alle Nachrichtenflüsse, die den untergeordneten Nachrichtenfluss in dieser Ausführungsgruppe verwenden, gestoppt und erneut gestartet. Nach dem Neustart verwenden die Nachrichtenflüsse den aktualisierten untergeordneten Nachrichtenfluss.

WebSphere Message Broker Toolkit verwenden

Wenn Sie eine BAR-Datei mit dem WebSphere Message Broker Toolkit implementieren, führen Sie die folgenden Schritte aus. Die Implementierung kann immer nur in jeweils einer Ausführungsgruppe erfolgen.

  1. Optional: Normalerweise wird eine inkrementelle Implementierung der BAR-Datei durchgeführt. Sie können auch eine komplette BAR-Datei-Implementierung vornehmen. Klicken Sie dazu in der Ansicht Broker mit der rechten Maustaste auf die Zielausführungsgruppe und klicken Sie auf Löschen > Alle Nachrichtenflüsse und Ressourcen. Warten Sie, bis der Vorgang komplett abgeschlossen ist, bevor Sie fortfahren.

    Wenn ein oder mehrere untergeordnete Prozesse mit den Inhalten der BAR-Datei aktualisiert werden sollen, klicken Sie nicht auf die Optionen Löschen > Alle Nachrichtenflüsse und Ressourcen. Der Unterschied zwischen der vollständigen und der inkrementellen Implementierung einer BAR-Datei wird im Abschnitt Nachrichtenfluss implementieren erläutert.

  2. Implementieren Sie mit einer der folgenden Methoden eine Brokerarchivdatei in einer Ausführungsgruppe: Wenn Sie .msgflow-Dateien und .subflow-Dateien implementieren möchten, die in einer Anwendung oder Bibliothek enthalten sind, müssen Sie die betreffende Anwendung oder Bibliothek implementieren.
    • Ziehen Sie eine Anwendung, Bibliothek, .msgflow-Datei, .subflow-Datei oder BAR-Datei auf die Zielausführungsgruppe in der Ansicht Broker.
    • Klicken Sie mit der rechten Maustaste auf die Anwendung, Bibliothek, .msgflow-Datei, .subflow-Datei oder BAR-Datei und klicken Sie dann auf Implementieren. Daraufhin wird das Dialogfenster Implementieren geöffnet, in dem die Ausführungsgruppen aufgelistet werden, mit denen das WebSphere Message Broker Toolkit verbunden ist.

      Wählen Sie eine Ausführungsgruppe aus und klicken Sie anschließend auf OK.

    • Klicken Sie mit der rechten Maustaste auf die Ausführungsgruppe und klicken Sie auf Implementieren. Das Dialogfenster Ressourcen wird geöffnet. Sie können Ressourcen aus dem Arbeitsbereich oder BAR-Dateien aus dem Dateisystem wählen.
      • Geben Sie durch Auswahl des entsprechenden Optionsfelds die Art der Ressource an, die implementiert werden soll. Die verfügbaren Ressourcen für diese Kategorie werden aufgelistet.
      • Wählen Sie die Ressource aus, die Sie implementieren möchten.
      • Klicken Sie auf OK.
  3. Wenn Sie die Brokerarchivdatei seit der letzten Bearbeitung nicht gespeichert haben, müssen Sie jetzt angeben, ob Sie die Datei vor der Implementierung speichern möchten. Wenn Sie auf Abbrechen klicken, wird die BAR-Datei nicht gespeichert und es wird keine Implementierung vorgenommen.
Die BAR-Datei wird auf den Broker übertragen. Hier wird der Inhalt der Datei (beispielsweise Nachrichtenflüsse und Nachrichtengruppen) für die Ausführungsgruppe implementiert. Die implementierten Ressourcen werden in der Ansicht Broker zur entsprechenden Ausführungsgruppe hinzugefügt.

WebSphere Message Broker Explorer verwenden

Bevor Sie beginnen:

Importieren Sie eine BAR-Datei mithilfe der Anweisungen im Abschnitt Brokerarchivdatei in den WebSphere Message Broker Explorer importieren in den WebSphere Message Broker Explorer.

Wenn Sie eine BAR-Datei mit dem WebSphere Message Broker Explorer implementieren, führen Sie die folgenden Schritte aus.

  1. Erweitern Sie den Brokerressourcenordner und wählen Sie den Ordner aus, der Ihre Brokerarchivdateien enthält.
  2. Optional: Normalerweise wird eine inkrementelle Implementierung der BAR-Datei durchgeführt. Sie können auch eine komplette BAR-Datei-Implementierung vornehmen. Klicken Sie dazu in der Ansicht Broker mit der rechten Maustaste auf die Zielausführungsgruppe und klicken Sie auf Löschen > Alle Nachrichtenflüsse und Ressourcen. Warten Sie, bis der Vorgang komplett abgeschlossen ist, bevor Sie fortfahren.

    Wenn ein oder mehrere untergeordnete Prozesse mit den Inhalten der BAR-Datei aktualisiert werden sollen, klicken Sie nicht auf die Optionen Löschen > Alle Nachrichtenflüsse und Ressourcen. Der Unterschied zwischen der vollständigen und der inkrementellen Implementierung einer BAR-Datei wird im Abschnitt Nachrichtenfluss implementieren erläutert.

  3. Implementieren Sie mit einer der folgenden Methoden die Brokerarchivdatei in einer Ausführungsgruppe:
    • Ziehen Sie die Datei in Ihre Zielausführungsgruppe in der Navigatoransicht. Sie können eine Brokerarchivdatei entweder aus Ihrem WebSphere Message Broker Explorer-Arbeitsbereich oder aus Ihrem Dateisystem ziehen.
    • Klicken Sie mit der rechten Maustaste auf die BAR-Datei und anschließend auf Datei implementieren. Daraufhin wird ein Dialogfenster geöffnet, in dem die Ausführungsgruppen aufgelistet werden, mit denen der WebSphere Message Broker Explorer verbunden ist.

      Wählen Sie eine Ausführungsgruppe aus und klicken Sie anschließend auf OK.

    Bei Verwendung der Methode Datei implementieren können mehrere Ausführungsgruppen gleichzeitig (für die Implementierung) ausgewählt werden.

  4. Wenn Sie die Brokerarchivdatei seit der letzten Bearbeitung nicht gespeichert haben, müssen Sie jetzt angeben, ob Sie die Datei vor der Implementierung speichern möchten. Wenn Sie auf Abbrechen klicken, wird die BAR-Datei nicht gespeichert und es wird keine Implementierung vorgenommen.
Die BAR-Datei wird auf den Broker übertragen. Hier wird der Inhalt der Datei (beispielsweise Nachrichtenflüsse und Nachrichtengruppen) für die Ausführungsgruppe implementiert. Erweitern Sie den Broker in der Navigatoransicht, sodass die zugeordneten Nachrichtenflüsse und Nachrichtengruppen, die der entsprechenden Ausführungsgruppe hinzugefügt wurden, angezeigt werden.

Befehl mqsideploy verwenden

Wenn Sie eine BAR-Datei mit dem Befehl mqsideploy implementieren, führen Sie die folgenden Schritte aus.

  1. Öffnen Sie ein Befehlsfenster, das für Ihre Umgebung konfiguriert ist.
  2. Geben Sie den für Ihr Betriebssystem und Ihre Konfiguration relevanten Befehl ein und verwenden Sie dabei die folgenden Beispiele als Leitfaden.
    Auf verteilten Systemen:
    mqsideploy -i IP-Adresse -p Port -q WS-Manager -e Ausführungsgruppe -a Brokerarchivdatei

    Mit dem Befehl wird eine inkrementelle Implementierung ausgeführt. Fügen Sie den Parameter –m hinzu, um eine vollständige BAR-Datei-Implementierung auszuführen.

    Die Parameter -i (IP-Adresse), -p (Port) und -q (WS-Manager) für die Verbindungsdetails des WS-Managers, der dem Broker zugeordnet ist. Wenn Sie den Broker auf dem Computer erstellt haben, auf dem Sie diesen Befehl ausgeführt haben, können Sie stattdessen den Brokernamen angeben.

    Sie müssen auch die Parameter -e (Name der Ausführungsgruppe) und -a (Name der BAR-Datei) angeben.

    Unter z/OS:
    /f MQ01BRK,dp e=Ausführungsgruppe a=BAR-Datei

    Mit dem Befehl wird eine inkrementelle Implementierung ausgeführt. Fügen Sie den Parameter m=yes hinzu, um eine vollständige BAR-Datei-Implementierung auszuführen.

    In diesem Beispiel ist MQ01BRK der Name des Brokers. Sie müssen auch die Namen der Ausführungsgruppe und der Brokerarchivdatei angeben (Parameter e= und a=).

Der Befehl meldet Antworten, die vom Broker empfangen werden. Wenn der Befehl erfolgreich ausgeführt wurde, gibt er 0 (null) zurück.

CMP-API verwenden

Verwenden Sie die Methode deploy der Klasse ExecutionGroupProxy, um die Implementierung unter Verwendung der CMP-API vorzunehmen.

Der folgende Code ist ein Beispiel für eine inkrementelle Implementierung durch eine Anwendung:
import com.ibm.broker.config.proxy.*;
public class DeployBAR {

  public static void main(String[] args) {
    BrokerConnectionParameters bcp =
       new MQBrokerConnectionParameters("localhost", 2414, "MB8QMGR");
    try {
      BrokerProxy b = BrokerProxy.getInstance(bcp);
      ExecutionGroupProxy eg = b.getExecutionGroupByName("default");
      DeployResult dr = eg.deploy("MyBAR.bar", true, 30000);
      System.out.println("Result = "+dr.getCompletionCode());
    } catch(Exception e) {
      e.printStackTrace();
    }
  }
}
Die Methode deploy führt standardmäßig eine inkrementelle Implementierung durch. Verwenden Sie für eine vollständige Implementierung eine Variante der Methode, die für den booleschen Parameter isIncremental den Wert false enthält. Beispielsweise e.deploy("deploy.bar",false,0). Wird dieser Parameter auf true gesetzt, wird eine inkrementelle Implementierung angefordert.

BAR-Datei erneut implementieren

Sie können eine BAR-Datei ändern und diese Änderungen an einen oder mehrere Broker weitergeben. In diesem Fall können Sie die aktualisierte BAR-Datei mit einer der zuvor beschriebenen Implementierungsverfahren erneut für eine oder mehrere Ausführungsgruppen implementieren. Die zuvor implementierten Nachrichtenflüsse müssen nicht gestoppt werden; alle Ressourcen der Ausführungsgruppe(n), die in der erneut implementierten BAR-Datei enthalten sind, werden ersetzt und die neuen Ressourcen werden angewendet.

Wenn im Rahmen der Aktualisierung der BAR-Datei Ressourcen gelöscht wurden, werden diese bei der erneuten Implementierung nicht vom Broker gelöscht. Angenommen, Ihre BAR-Datei enthält beispielsweise die Anwendungen A1, A2 und A3. Aktualisieren Sie die Datei, indem Sie A2 entfernen und die Anwendung A4 hinzufügen. Nach einer erneuten Implementierung der BAR-Datei sind in der Ausführungsgruppe alle vier Anwendungen verfügbar. A1 und A3 werden durch den Inhalt der erneut implementierten BAR-Datei ersetzt.

Wenn Sie vor der erneuten Implementierung zuvor implementierte Ressourcen aus einer Ausführungsgruppe löschen möchten, verwenden Sie hierfür eine der oben beschriebenen Methoden.
  • Wenn Sie das WebSphere Message Broker Toolkit verwenden möchten, befolgen Sie die Anweisungen für eine vollständige Implementierung und stellen Sie sicher, dass die Optionen Löschen > Alle Nachrichtenflüsse und Ressourcen vor der Implementierung ausgewählt ist.
  • Wenn Sie den WebSphere Message Broker Explorer verwenden möchten, befolgen Sie die Anweisungen für eine vollständige Implementierung und stellen Sie sicher, dass Alle Nachrichtenflüsse und Ressourcen vor der Implementierung ausgewählt ist.
  • Wenn Sie den Befehl mqsideploy verwenden möchten, befolgen Sie die Anweisungen und stellen Sie sicher, dass der Parameter –m hinzugefügt ist, um eine vollständige BAR-Datei-Implementierung durchzuführen.
  • Wenn Sie die CMP-API verwenden möchten, befolgen Sie die Anweisungen für eine vollständige Implementierung.

Stoppen Sie bei nicht transaktionsorientierten Nachrichtenflüssen die Nachrichtenflüsse vor der erneuten Implementierung, wenn Sie sichergehen möchten, dass alle Anwendungen korrekt beendet werden und ihr Status bekannt und konsistent ist. Es ist möglich, einzelne Nachrichtenflüsse, Ausführungsgruppen oder Broker zu stoppen.

Bei transaktionsorientierten Nachrichtenflüssen ist durch die Verarbeitungslogik für Festschreibung bzw. Rollback gewährleistet, dass die Ressourcenintegrität und -konsistenz erhalten bleiben.

Nächste Schritte:

Überprüfen Sie mithilfe der Anweisungen im Abschnitt Ergebnisse der Implementierung überprüfen die Ergebnisse der erneuten Implementierung.

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 | af03890_