Benutzerdefinierten Knoten migrieren

Vorbereitungen:

Auf Ihrem System muss eine benutzerdefinierte Erweiterung installiert sein (siehe Benutzerdefinierte Erweiterung in einer Brokerdomäne installieren).

Wenn Sie das Message Brokers ToolkitVersion 5.1 verwenden, ersetzen Sie alle Verweise auf "Version 5.0" durch "Version 5.1".

Die Migration eines benutzerdefinierten Knotens kann auf eine der folgenden zwei Arten erfolgen:

Benutzerdefinierten Knoten mit Hilfe des Message Brokers Toolkits 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. Zuvor müssen Sie den Knoten aber auf Message Brokers Toolkit Version 6.0 migrieren.

Gehen Sie folgendermaßen vor, um Message Brokers Toolkit der Version 5.1 oder Version 5.1.1 auf Message Brokers Toolkit der 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).

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 im Projektstammverzeichnis in der Datei 'plugin.xml' das Element <requires> wie folgt:
    <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.

Benutzerdefinierten Knoten manuell migrieren

Gehen Sie folgendermaßen vor, um einen benutzerdefinierten Knoten manuell zu migrieren:

  1. Speichern Sie eine Kopie Ihrer kompilierten oder gepackten Datei mit benutzerdefinierten Erweiterungen auf jedem Brokersystem, auf dem Sie sie verwenden möchten.

    Wenn sich alle Broker auf demselben Maschinentyp befinden, können Sie die Datei mit den benutzerdefinierten Erweiterungen einmal erstellen und an die einzelnen Systeme . Wenn Sie über einen Cluster verfügen, der aus einem AIX-, einem Solaris- und einem Windows-Broker besteht, 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 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, auch 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 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. Auf Grund der Dateisperre, die durch das Betriebssystem eingesetzt wird, ist es unter Windows nicht möglich, eine vorhandene Datei bei aktivem Broker zu überschreiben.
    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 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, 2005 Letzte Aktualisierung: Nov 17, 2005
as10009_