Nach der Erstellung und dem Füllen einer Brokerarchivdatei (BAR-Datei) ist die Implementierung der Datei in einer Ausführungsgruppe auf einem Broker erforderlich, so dass sie in der Brokerdomäne wirksam werden kann.
Vorbereitungen:
Sie müssen eine BAR-Datei erstellt haben. Weitere Informationen hierzu finden Sie unter Neues Brokerarchiv erstellen.
Ist der Zugriff auf eine Ausführungsgruppe, für die Sie eine Implementierung vornehmen möchten, durch eine Zugriffssteuerungsliste eingeschränkt, benötigen Sie für diese Task die entsprechenden Zugriffsberechtigungen.
Führen Sie folgende Schritte aus, um eine BAR-Datei unter Verwendung des Workbenchs zu implementieren:
Weitere Schritte:
Überprüfen Sie die Ergebnisse der Implementierung (siehe Ergebnisse der Implementierung überprüfen).
Führen Sie folgende Schritte aus, um eine BAR-Datei unter Verwendung des Befehls mqsideploy zu implementieren.
Weitere Schritte:
Überprüfen Sie die Ergebnisse der Implementierung (siehe Ergebnisse der Implementierung überprüfen).
Verwenden Sie die Methode deploy der Klasse ExecutionGroupProxy. Die Methode deploy führt standardmäßig eine inkrementelle Implementierung (Delta) durch. Verwenden Sie zur Implementierung der vollständigen Hierarchie eine Variante der Methode, bei der der boolesche Parameter isIncremental auf false gesetzt ist. Wird für den Parameter dagegen true angegeben, bedeutet dies eine inkrementelle Implementierung.
import com.ibm.broker.config.proxy.*; import java.io.IOException; public class DeployBar { public static void main(String[] args) { ConfigManagerConnectionParameters cmcp = new MQConfigManagerConnectionParameters("localhost", 1414, "QM1"); try { ConfigManagerProxy cmp = ConfigManagerProxy.getInstance(cmcp); TopologyProxy t = cmp.getTopology(); BrokerProxy b = t.getBrokerByName("BROKER1"); ExecutionGroupProxy e = b.getExecutionGroupByName("default"); e.deploy("deploy.bar"); } catch (ConfigManagerProxyException cmpe) { cmpe.printStackTrace(); } catch (IOException ioe) { ioe.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 für den Parameter dagegen true angegeben, bedeutet dies eine inkrementelle Implementierung.
Weitere Schritte:
Überprüfen Sie die Ergebnisse der Implementierung (siehe Ergebnisse der Implementierung überprüfen).
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 für eine oder mehrere Ausführungsgruppen erneut implementieren. Hierfür sind die oben beschriebenen Implementierungsverfahren anwendbar. 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 neue 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. Ein Beispiel: Angenommen, eine BAR-Datei enthält die Nachrichtenflüsse F1, F2 und F3. Sie aktualisieren die Datei, indem Sie F2 entfernen und Nachrichtenfluss F4 hinzufügen. Nach einer erneuten Implementierung der BAR-Datei sind in der Ausführungsgruppe alle drei Nachrichtenflüsse verfügbar. F1 und F3 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.
Weitere Schritte:
Prüfen Sie die Ergebnisse der erneuten Implementierung. Weitere Informationen hierzu finden Sie unter Ergebnisse der Implementierung überprüfen.