Brokerarchivdatei einsetzen

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.

Message Broker Toolkit verwenden

Führen Sie folgende Schritte aus, um eine BAR-Datei unter Verwendung des Workbenchs einzusetzen:

  1. Wechseln Sie in die Ansicht 'Brokerverwaltung'.
  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 Domänenansicht mit der rechten Maustaste auf die Zielausführungsgruppe, und wählen Sie Eingesetzte untergeordnete Elemente entfernen aus. Warten Sie, bis der Vorgang komplett abgeschlossen ist, bevor Sie fortfahren.

    Es ist nicht erforderlich, eingesetzte untergeordnete Elemente zu entfernen, wenn nur eine Aktualisierung eines oder mehrerer dieser Elemente mit dem Inhalt der BAR-Datei vorgenommen werden soll. Der Unterschied zwischen einer vollständigen und einer inkrementellen Implementierung einer BAR-Datei wird im Abschnitt Nachrichtenflussanwendungen implementieren erläutert.

  3. Klicken Sie in der Navigatoransicht auf die BAR-Datei, um sie zu markieren.
  4. Verschieben Sie die Datei in Ihre Zielausführungsgruppe in der Domänenansicht.

    Klicken Sie alternativ mit der rechten Maustaste auf die BAR-Datei und anschließend auf Datei einsetzen. Ein Dialogfeld wird geöffnet und zeigt alle Domänen sowie Ausführungsgruppen in den Domänen an, mit denen die Workbench verbunden ist. Ein Dialogfeld zeigt die Ausführungsgruppen (in ihrer Domäne) an, in die Sie die BAR-Datei einsetzen können. Wählen Sie eine Ausführungsgruppe aus und klicken auf OK, um die BAR-Datei einzusetzen. (Wenn Sie eine Brokertopologie auswählen, die nicht mit einer Domäne verbunden ist, wird versucht, eine Verbindung herzustellen. Wenn Sie auf Abbrechen klicken, bleibt die Brokertopologie weiterhin ohne Domänenverbindung.)

    Unabhängig von der verwendeten Methode können Sie immer nur jeweils eine Ausführungsgruppe auswählen (und für diese eine Implementierung vornehmen).

  5. Wenn Sie die BAR-Datei seit der letzten Bearbeitung nicht gespeichert haben, müssen Sie jetzt angeben, ob Sie sie 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 Konfigurationsmanager übertragen. Hier wird der Inhalt der Datei (z. B. Nachrichtenflüsse und Nachrichtengruppen) für die Ausführungsgruppe implementiert. Die zugewiesenen Nachrichtenflüsse und Nachrichtengruppen werden in der Domänenansicht zur entsprechenden Ausführungsgruppe hinzugefügt.

Weitere Schritte:

Ergebnisse des Implementierungsvorgangs überprüfen.

Den Befehl 'mqsideploy' verwenden

Führen Sie folgende Schritte aus, um eine BAR-Datei mit dem Befehl mqsideploy einzusetzen:

  1. Öffnen Sie ein Befehlsfenster, das für Ihre Umgebung konfiguriert ist.
  2. Geben Sie unter Berücksichtigung der nachfolgenden Beispiele den entsprechenden Befehl ein:
    Auf verteilten Plattformen:
    mqsideploy -i IP-Adresse -p Port -q WS-Manager -b Broker -e Ausführungsgruppe -a BAR-Datei

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

    Bei den Parametern -i (IP-Adresse), -p (Port) und -q (WS-Manager) handelt es sich um die Verbindungsdetails für den WS-Manager-Computer.

    Die Parameter -b (Brokername), -e (Name der Ausführungsgruppe) und -a (Name der BAR-Datei) müssen ebenfalls angegeben werden.

    Unter z/OS
    /f MQ01CMGR,dp b=Broker e=Ausführungsgruppe a=BAR-Datei

    Mit diesem 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 MQ01CMGR der Name der Konfigurationsmanagerkomponente. Sie müssen auch die Namen des Brokers, der Ausführungsgruppe und der BAR-Datei angeben (Parameter b=, e= und a=).

Weitere Schritte:

Ergebnisse des Implementierungsvorgangs überprüfen.

Konfigurationsmanager-Proxy-API verwenden

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.

Beispiel:
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.

Brokerarchivdatei erneut implementieren

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.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
af03890_