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.
Bei diesem Thema wird vorausgesetzt, dass Sie bereits eine BAR-Datei erstellt haben. Der Abschnitt Brokerarchivdatei (BAR-Datei) erstellen enthält weitere Informationen hierzu.
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.
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.
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.
Wenn Sie eine BAR-Datei mit dem Befehl mqsideploy implementieren, führen Sie die folgenden Schritte aus.
Der Befehl meldet Antworten, die vom Broker empfangen werden. Wenn der Befehl erfolgreich ausgeführt wurde, gibt er 0 (null) zurück.
Verwenden Sie die Methode deploy der Klasse ExecutionGroupProxy, um die Implementierung unter Verwendung der CMP-API vorzunehmen.
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.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.
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.
Überprüfen Sie mithilfe der Anweisungen im Abschnitt Ergebnisse der Implementierung überprüfen die Ergebnisse der erneuten Implementierung.