Benutzerdefinierten Knoten migrieren

Migrieren Sie den benutzerdefinierten Knoten auf Version 6.1.

Die Tasks hängen von der Version ab, von der Sie die Migration ausführen:

Benutzerdefinierten Knoten von Version 6.0 und Version 5.1 migrieren

So migrieren Sie von Version 5.0 auf Version 6.1:

  1. Importieren Sie das Projekt mit dem benutzerdefinierten Knoten in Message Broker Toolkit Version 6.1.
  2. Wählen Sie im Package Explorer Ihr benutzerdefiniertes Knotenprojekt aus, und klicken Sie auf Projekt > Clean Project (Projekt bereinigen).
  3. Wenn Sie neue Version 6.1-Broker erstellt haben, kopieren Sie den Laufzeitcode zu jedem neuen Brokersystem.
    • Kompilieren Sie für benutzerdefinierte C-Erweiterungen den Code für das Zielbetriebssystem. Speichern Sie die lil- oder jar-Datei in dem Verzeichnis, das Sie für den Parameter -l beim Befehl mqsicreatebroker oder mqsichangebroker angegeben hatten.

      Speichern Sie zudem die pdb-Datei, die der lil-Datei im gleichen Verzeichnis entspricht. Die pdb-Datei stellt symbolische Informationen bereit, die in Stack-Diagnoseinformationen verwendet werden, falls unberechtigte Zugriffe oder andere Software-Ausnahmebedingungen eintreten.

    • Speichern Sie bei benutzerdefinierten Java-Knoten die lil- oder jar-Datei in dem Verzeichnis, das Sie für den Parameter -l beim Befehl mqsicreatebroker oder mqsichangebroker angegeben hatten.

Benutzerdefinierten Knoten von Version 5.0 migrieren

Um einen benutzerdefinierten Knoten von Version 5.0 nach Version 6.1 zu migrieren, müssen Sie sowohl das Toolkit als auch die Laufzeitkomponenten migrieren.

Message Brokers Toolkit-Darstellung des benutzerdefinierten Knotens migrieren

So führen Sie eine Migration vom Message Brokers Toolkit Version 5.0 zum Message Brokers Toolkit Version 6.1 durch:

  1. Importieren Sie das Projekt mit dem benutzerdefinierten Knoten in Message Brokers Toolkit Version 6.1.
  2. Wählen Sie im Package Explorer Ihr benutzerdefiniertes Knotenprojekt aus, und klicken Sie auf Projekt > Clean Project (Projekt bereinigen).
  3. Ändern Sie wie folgt im Projektstammverzeichnis des benutzerdefinierten Knotens in der Datei plugin.xml das Element <requires>:
    <requires>
            <import match="greaterOrEqual" plugin="com.ibm.etools.mft.api" version="6.0.0"/>
    </requires>
  4. Ändern Sie den Erweiterungspunkt für "org.eclipse.help.contexts" in derselben Datei plugin.xml 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.

Laufzeitcode des benutzerdefinierten Knotens migrieren

Bevor Sie mit diesem Schritt beginnen, müssen Sie die Darstellung des Message Brokers Toolkit des benutzerdefinierten Knotens migriert haben.

So migrieren Sie den Laufzeitcode 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. Speichern Sie die lil- oder jar-Datei in dem Verzeichnis, das Sie beim Befehl mqsicreatebroker oder mqsichangebroker für jeden Version 6.1-Broker angegeben haben. (Bei Version 5.0-Brokersystemen wurde die lil- bzw.jar-Datei im Installationsverzeichnis gespeichert.)
    • Wenn Sie einen benutzerdefinierten Java-Knoten migrieren, 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 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 Systemtypen besteht (z. B. einem AIX-, einem Solaris- und einem Windows-Broker), müssen Sie die Dateien separat auf jedem Systemtyp erstellen.
  2. Speichern Sie bei benutzerdefinierten C-Erweiterungen ebenfalls die pdb-Datei, die der lil-Datei im gewählten Verzeichnis entspricht. Die pdb-Datei stellt symbolische Informationen bereit, die in Stack-Diagnoseinformationen verwendet werden, falls unberechtigte Zugriffe oder andere Softwarestörungen eintreten.
  3. Stoppen und starten Sie jeden Broker, um sicherzustellen, dass das Vorhandensein einer neuen Datei erkannt wird.
    Ein Brokerneustart ist bei den folgenden beiden Szenarien nicht erforderlich:
    • Wenn Sie im Message Broker Toolkit eine Ausführungsgruppe erstellt und darin noch keine Implementierungen ausgeführt haben, können Sie die lil-, pdb- und jar-Datei dem gewählten Verzeichnis hinzufügen.
    • Falls Sie bereits Implementierungen in der Ausführungsgruppe durchgeführt haben, die Sie verwenden möchten, fügen Sie die lil-, pdb- oder jar-Datei dem gewählten Verzeichnis hinzu und verwenden Sie dann den Befehl mqsireload, um die Gruppe neu zu starten. 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, 2007 Letzte Aktualisierung: Jan 24, 2008
as10009_