Benutzerdefinierten Knoten migrieren

Führen Sie folgende Schritte aus, um einen benutzerdefinierten Knoten auf WebSphere Message Broker Version 6.0 zu migrieren:
  1. Message Brokers Toolkit-Darstellung des benutzerdefinierten Knotens migrieren
  2. Code des benutzerdefinierten Knotens migrieren

Message Brokers Toolkit-Darstellung des benutzerdefinierten Knotens migrieren

Sie können einen benutzerdefinierten Knoten, der in Message Brokers Toolkit Version 5.0 erstellt wurde, auf Message Brokers Toolkit Version 6.0 implementieren. Bevor Sie den benutzerdefinierten Knoten implementieren können, müssen Sie die Message Brokers Toolkit-Darstellung des benutzerdefinierten Knotens auf Message Brokers Toolkit Version 6.0 migrieren.

So migrieren Sie das Message Brokers Toolkit der Version 5.1 oder Version 5.1 zur Version 6.0 Message Brokers Toolkit:

  1. Importieren Sie das Projekt mit dem benutzerdefinierten Knoten in Message Brokers Toolkit Version 6.0.
  2. Wählen Sie im Package Explorer Ihr benutzerdefiniertes Knotenprojekt aus, und klicken Sie auf Projekt > Clean Project (Projekt bereinigen).

Gehen Sie folgendermaßen vor, um Message Brokers Toolkit Version 5.0 auf Message Brokers Toolkit Version 6.0 zu migrieren:

  1. Importieren Sie das Projekt mit dem benutzerdefinierten Knoten in Message Brokers Toolkit Version 6.0.
  2. Wählen Sie im Package Explorer Ihr benutzerdefiniertes Knotenprojekt aus, und klicken Sie auf Projekt > Clean Project (Projekt bereinigen).
  3. Ändern Sie das Element <requires> in der Datei 'plugin.xml' im Stammverzeichnis des benutzerdefinierten Knotenprojekts folgendermaßen:
    <requires>
            <import match="greaterOrEqual" plugin="com.ibm.etools.mft.api" version="6.0.0"/>
    </requires>
  4. Ändern Sie die Erweiterung "org.eclipse.help.contexts" in derselben Datei wie folgt:
    <extension point="org.eclipse.help.contexts">
    	<contexts file="HelpContexts.xml"/>
    </extension>

Nach der Migration Ihrer benutzerdefinierten Knoten ist keine Migration von Nachrichtenflüssen, die den Knoten enthalten, notwendig.

Nun müssen Sie den Schritt Code des benutzerdefinierten Knotens migrieren ausführen.

Code des benutzerdefinierten Knotens migrieren

Dieser Schritt setzt voraus, dass zunächst der unter Message Brokers Toolkit-Darstellung des benutzerdefinierten Knotens migrieren beschriebene Schritt ausgeführt wurde.

So migrieren Sie den Code des benutzerdefinierten Knotens:

  1. Speichern Sie eine Kopie Ihrer kompilierten oder gepackten Datei mit benutzerdefinierten Erweiterungen auf jedem Brokersystem, auf dem Sie sie verwenden möchten.
    • Wenn Sie einen benutzerdefinierten Java-Knoten migrieren, können Sie die Datei mit den benutzerdefinierten Erweiterungen einmal erstellen und an die einzelnen Systeme .
    • Wenn Sie einen benutzerdefinierten C-Knoten migrieren und sich alle Broker auf demselben Maschinentyp befinden, können Sie die Datei mit den benutzerdefinierten Erweiterungen einmal erstellen und an die einzelnen Systeme verteilen.
    • Wenn Sie einen benutzerdefinierten C-Knoten migrieren und über einen Cluster verfügen, der aus verschiedenen Maschinentypen besteht (z. B. einem AIX-, einem Solaris- und einem Windows-Broker), müssen Sie die Dateien separat auf jedem Maschinentyp erstellen.
  2. Geben Sie das Verzeichnis, in dem die Datei gespeichert werden soll, entweder mit dem Befehl mqsichangebroker oder mit dem Befehl mqsicreatebroker an.

    In früheren Versionen wurde die LIL- oder JAR-Datei im Installationsverzeichnis gespeichert. Speichern Sie die LIL- oder JAR-Datei nicht im WebSphere Message Broker-Installationsverzeichnis.

    Bei benutzerdefinierten C-Erweiterungen wird empfohlen, die PDB-Datei, die der LIL-Datei entspricht, ebenfalls im gewählten Verzeichnis zu speichern. Die PDB-Datei enthält symbolische Informationen, die WebSphere Message Broker im Falle von Zugriffsverletzungen oder anderen Softwarestörungen für die Anzeige von Stack-Diagnoseinformationen verwendet.

  3. Stoppen und starten Sie jeden einzelnen Broker. Dadurch wird das Vorhandensein einer neuen Datei festgestellt.
    In zwei Fällen ist ein Brokerneustart nicht erforderlich:
    • Sie haben im Message Brokers Toolkit eine Ausführungsgruppe erstellt, und darin wurden noch keine Implementierungen ausgeführt. Sie können die LIL-, PDB- und JAR-Datei in Ihrem gewählten Verzeichnis hinzufügen.
    • In der Ausführungsgruppe wurden bereits Implementierungen ausgeführt, die Sie verwenden möchten. Fügen Sie die LIL-, PDB- bzw. JAR-Datei in Ihrem gewählten Verzeichnis hinzu, und starten Sie anschließend die Gruppe mit dem Befehl mqsireload neu. Eine vorhandene Datei kann unter Windows bei aktivem Broker auf Grund der Dateisperre, die durch das Betriebssystem eingesetzt wird, nicht überschrieben werden.
    Diese zwei Verfahren sollten mit Vorsicht verwendet werden, da eine Ausführungsgruppe, die mit demselben Broker verbunden ist, die neuen LIL-, PDB- und JAR-Dateien auch feststellen wird, wenn diese Ausführungsgruppe neu gestartet wird oder darin die ersten Implementierungen stattfinden. Mit der konventionelleren Methode, einem Brokerneustart, stellen Sie sicher, dass alle Benutzer, die an einer bestimmten Ausführungsgruppe interessiert sind, darauf aufmerksam gemacht werden, dass Änderungen am Broker vorgenommen worden sind.

    In diesen beiden Fällen wird davon ausgegangen, dass Sie den vorherigen Schritt bereits ausgeführt haben und somit entweder den Befehl mqsichangebroker oder den Befehl mqsicreatebroker verwendet haben, um dem Broker das Verzeichnis, in dem die Datei mit den benutzerdefinierten Erweiterungen gespeichert wurde, anzugeben.

    Nach der Installation eines benutzerdefinierten Knotens wird er wie ein Nachrichtenfluss über sein Schema und seinen Namen angesprochen.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as10009_