Vorbereitungen:
In dieser Task wird beschrieben, wie Sie ein Brokerarchiv (BAR) implementieren. Erstellen Sie jetzt eine BAR-Datei, falls noch nicht geschehen.
Ein Brokerarchiv kann auf drei Arten implementiert werden:
Mit diesen drei Verfahren kann auch eine erneute Implementierung einer Brokerarchivdatei erfolgen; weitere Informationen hierzu finden Sie im Abschnitt Brokerarchivdatei erneut implementieren.
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 einzusetzen:
Weitere Schritte:
Ergebnisse des Implementierungsvorgangs überprüfen.
Führen Sie folgende Schritte aus, um eine BAR-Datei mit dem Befehl mqsideploy einzusetzen:
Weitere Schritte:
Ergebnisse des Implementierungsvorgangs überprüfen.
Verwenden Sie die Implementierungsmethode der Klasse ExecutionGroupProxy. Die Implementierungsmethode führt standardmäßig eine inkrementelle Implementierung aus. Verwenden Sie für eine vollständige Implementierung eine Variante der Methode mit dem Booleschen Parameter isIncremental. Wird dieser Parameter auf false gesetzt, bedeutet dies eine vollständige Implementierung. 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();
}
}
}
Weitere Schritte:
Ergebnisse des Implementierungsvorgangs ü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 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. 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 vier Nachrichtenflüsse verfügbar. F1 und F3 werden durch den Inhalt der erneut implementierten Datei ersetzt.
Wenn Sie vor der erneuten Implementierung Ressourcen aus einer Ausführungsgruppe löschen möchten, die Sie zuvor implementiert haben (weil Sie z. B. gerade Ressourcen löschen), verwenden Sie hierfür entweder den Befehl mqsideploy mit der Option -m -complete oder die entsprechende CMP-Implementierungsmethode für die Ausführungsgruppe. Wenn Sie lieber das Message Broker Toolkit verwenden, wählen Sie die Ausführungsgruppe(n) aus, klicken Sie auf Eingesetzte untergeordnete Elemente entfernen, und nehmen Sie dann die Implementierung vor.
Bei nicht transaktionsorientierten Nachrichtenflüssen ist zu überlegen, ob diese Nachrichtenflüsse vor der erneuten Implementierung gestoppt werden sollten. Stoppen Sie die Nachrichtenflüsse, 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.