Benutzerdefinierte Erweiterung für die aktuelle und vergangene Versionen des Brokers installieren

Die hier beschriebene Task ist für Benutzer (z. B. Drittanbieter), die benutzerdefinierte Erweiterungen mit minimalem Benutzereingriff installieren möchten.

Vor dem Start

Führen Sie folgende Task aus:

  1. Benutzerdefinierten Java-Knoten kompilieren oder Benutzerdefinierte C-Erweiterung kompilieren
  2. Darstellung der Benutzerschnittstelle eines benutzerdefinierten Knotens in der Workbench erstellen
  3. Benutzerdefinierten Knoten testen
  4. Workbench-Projekt eines benutzerdefinierten Knotens verpacken

Sie müssen benutzerdefinierte Erweiterungen auf allen passenden Brokercomputern installieren und, falls die Erweiterung ein benutzerdefinierter Knoten ist, auf den Workbench-Computern (benutzerdefinierte Parser haben keine Workbench-Komponente). Komponenten können separat oder als Teil eines Prozesses installiert werden. Die Komponenten können sich auf unterschiedlichen Systemen befinden. Stellen Sie deshalb sicher, dass die Installationen auf allen betroffenen Systemen durchgeführt werden.

WebSphere Message Broker Toolkit-Installation

Bevor Sie einen benutzerdefinierten Knoten installieren, müssen Sie die Version des Message Broker Toolkits erstellen, auf dem Sie die Installation vornehmen, da eine bestimmte Version des Toolkits die Voraussetzung der benutzerdefinierten Erweiterung sein könnte oder möglicherweise bestimmte Dateien für die Ausführung benötigt.

Informationen zur Bestimmung der Toolkit-Version erhalten Sie unter Installierte Versionen von WebSphere Message Broker ermitteln.

  1. Für die Installation des benutzerdefinierten Knotens auf Message Broker Toolkit Version 6.1 speichern Sie die JAR-Datei mit dem Knoten-Plug-in-Projekt im Verzeichnis plugins der Message Broker Toolkit-Installation. Beispiel: C:\Programme\IBM\WMBT610\plugins.
  2. Starten Sie die Workbench-Sitzung erneut, damit die Änderungen wirksam werden.

Laufzeitinstallation

Sie müssen unter Umständen die installierten Laufzeitkomponenten erkennen, um sicherzustellen, dass die korrekte LIL-Datei von der richtigen Brokerstufe geladen wird. Weitere Informationen hierzu finden Sie unter Installierte Versionen von WebSphere Message Broker ermitteln.

Weitere Informationen zum Hinzufügen von JAR- oder LIL-Dateien zur Laufzeitinstallation auf WebSphere Business Integration Message Broker Version 5.0 oder höher und auf WebSphere Message Broker Version 6.0 oder höher finden Sie unter Laufzeitdateien für benutzerdefinierte Erweiterung auf einem Broker installieren.

Einzelbrokererweiterung

Um eine 32-Bit-Erweiterung für nur einen Broker im System zugänglich zu machen, modifizieren Sie die Einstellung UserLilPath für den Broker, indem Sie den Parameter -l im mqsicreatebroker- oder mqsichangebroker-Befehl angeben. Sie finden weitere Informationen hierzu in den Abschnitten Befehl 'mqsicreatebroker' und Befehl 'mqsichangebroker'.

Mit dem Parameter -l kann der Benutzer 'LILPATH' nicht für 64-Bit-Erweiterungen modifiziert werden. Hängen Sie stattdessen das Verzeichnis, welches das Verzeichnis mit den Erweiterungsdateien enthält, an die Umgebungsvariable 'MQSI_LILPATH64' an (Details hierzu finden Sie im folgenden Abschnitt).

Mehrfache Brokererweiterung

Damit alle Broker auf einem System betroffen sind, müssen Sie 'LILPATH' modifizieren. Hängen Sie das Verzeichnis, welches das Verzeichnis mit den Erweiterungsdateien enthält, an die Umgebungsvariable 'MQSI_LILPATH ' (für 32-Bit-Erweiterungen) oder 'MQSI_LILPATH64' (für 64-Bit-Erweiterungen) an.

Hierzu können Sie ein benutzerdefiniertes Umgebungsscript in %ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\profiles auf Windows oder /var/mqsi/common/profiles auf UNIX- und Linux-Systemen erstellen. Sie können dem Umgebungsscript einen beliebigen Namen geben, aber die Dateierweiterung muss .cmd unter Windows und .sh auf allen anderen Plattformen lauten. Das Script kann alle Operationen einer Shellprozedur ausführen, aber Sie sollten den Bereich auf das Anhängen der folgenden Variablen einschränken:

MQSI_LILPATH
Definiert Verzeichnisse zum Suchen der 32-Bit-Plug-ins
MQSI_LILPATH64
Definiert Verzeichnisse zum Suchen der 64-Bit-Plug-ins
CLASSPATH
Definiert die Speicherpositionen, die Java für zusätzliche Klassen durchsuchen soll.
NLSPATH
Definiert die Speicherposition von Nachrichtenkatalogen
PATH
Definiert die Speicherposition von ausführbaren Dateien. Auf Windows definiert diese Variable auch die Speicherposition abhängiger Bibliotheken.
LIBPATH / SHLIB_PATH / LD_LIBRARY_PATH
Definiert die Speicherposition abhängiger Bibliotheken auf UNIX- und Linux-Systemen.

Beispielscript

Windows platform Umgebungsprofil für 'MyExtension', installiert in C:\Programme\MyExtensions. Das Script befindet sich unter C:\Dokumente und Einstellungen\All Users\Application Data\IBM\MQSI\common\profiles\MyExtension.cmd:
REM von MyExtension-Installation, nicht modifizieren
set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Programme\MyExtension\bin"
UNIX platform Umgebungsprofil für 'MyExtension', installiert in /opt/MyExtension. Das Script befindet sich unter /var/mqsi/common/profiles/MyExtension.sh:
#!/bin/ksh
# Von MyExtension-Installation hinzugefügt, nicht modifizieren
export MQSI_LILPATH=/opt/MyExtension/lil${MQSI_LILPATH:+":"${MQSI_LILPATH}}

Sie können die folgenden Variablen im Profilscript testen, beispielsweise um sicherzustellen, dass eine benutzerdefinierte Erweiterung ausschließlich auf einer bestimmten Brokerversion ausgeführt werden kann:

MQSI_FILEPATH
Der vollständige Pfad der installierten Datei für WebSphere Message Broker
MQSI_WORKPATH
Der vollständige Pfad der zu den Konfigurationsdaten für WebSphere Message Broker
MQSI_VERSION
WebSphere Message Broker-Version im Format version.release.modification.fix
MQSI_VERSION_V
Der Wert von WebSphere Message Broker übergeordnete Version
MQSI_VERSION_R
Der Wert von WebSphere Message Broker-Release
MQSI_VERSION_M
Der Wert von WebSphere Message Broker-Modifikationsnummer
MQSI_VERSION_F
Der Wert von WebSphere Message Broker-Fixversion
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
as04540_