Benutzerdefinierte Erweiterung für aktuelle und frühere Versionen von IBM Integration Bus installieren

Benutzerdefinierte Erweiterungen, die Sie selbst entwickelt oder von unabhängigen Anbietern erworben haben, können Sie mit minimalem Benutzereingriff installieren.

Vor dem Start

Führen Sie folgende Task aus:

  1. Benutzerdefinierten Java-Knoten kompilieren, Benutzerdefinierte C-Erweiterung kompilieren oder Benutzerdefinierten Knoten aus einem untergeordneten Nachrichtenfluss erstellen
  2. Darstellung der Benutzerschnittstelle eines benutzerdefinierten Knotens in der IBM Integration Toolkit erstellen
  3. Benutzerdefinierten Knoten testen
  4. Projekt für benutzerdefinierten Knoten paketieren und verteilen

Sie müssen benutzerdefinierte Erweiterungen auf allen passenden IBM Integration Bus-Computern installieren und, falls die Erweiterung ein benutzerdefinierter Knoten ist, auf den IBM Integration Toolkit-Computern (benutzerdefinierte Parser haben keine IBM Integration Toolkit-Komponente). Wenn Ihre Erweiterung ein benutzerdefinierter Knoten ist, der einen angepassten Compiler enthält, müssen Sie die kompilierte benutzerdefinierte Erweiterungsdatei und das benutzerdefinierte Knoten-Plug-in auf den Brokern installieren, in denen Sie den Knoten implementieren möchten. 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.

Wenn von einer Erweiterung Nachrichten in den Benutzertrace geschrieben werden, muss die Umgebungsvariable MQSI_CONSOLE_NLSPATH (bei Windows-Systemen) bzw. NLSPATH (bei allen anderen Systemen) entsprechend aktualisiert werden, dass mit dem Befehl mqsiformatlog der Nachrichtenkatalog gefunden werden kann.

IBM Integration Toolkit-Installation

Überprüfen Sie vor der Installation eines benutzerdefinierten Knotens die Version des IBM Integration Toolkits, in dem die Installation erfolgen soll, da möglicherweise eine bestimmte Version des IBM Integration Toolkits vorausgesetzt wird oder bestimmte Dateien ausgeführt werden müssen.

Im Abschnitt Installierte Versionen von IBM Integration Bus ermitteln wird erläutert, wie Sie die Version feststellen können.

  1. Kopieren Sie die Dateien in ein Verzeichnis, auf das das IBM Integration Toolkit zugreifen kann, damit der benutzerdefinierte Knoten in der IBM Integration Toolkit-Sitzung angezeigt werden kann. Entscheiden Sie sich für eine der folgenden Möglichkeiten:
    • Fügen Sie die neue Plug-in-JAR-Datei direkt in das Verzeichnis dropins ein, in dem das IBM Integration Toolkit installiert ist. Fügen Sie die Datei beispielsweise unter Windows (32-Bit) zum Verzeichnis C:\Programme\IBM\IntegrationToolkit90\dropins hinzu.

      Bei dieser Methode ist eine sichere Verwaltung der Plug-in-Dateien unter Umständen schwieriger, wenn diese Dateien später entfernt oder ersetzt werden. Möglicherweise soll außerdem bei Computern, die von mehreren Benutzern verwendet werden, die Sicherheit und der Zugriff vom Systemadministrator kontrolliert werden. Es kann sein, dass den Benutzern nicht die Berechtigung zum Schreiben in die primären Installationsverzeichnisse erteilt wird.

    • Erstellen Sie Eclipse-Verknüpfungsdateien zu den Verzeichnissen, in denen die Plug-in-Dateien verwaltet werden.
      Einzelheiten zum Erstellen von Verknüpfungsdateien finden Sie im developerWorks-Artikel zu unter Verwendung von Eclipse-Komponenten (Abschnitt "Using link files to manage an Eclipse install").
      1. Linux platform Unter Linux: Löschen Sie alle .eclipse-Verzeichnisse aus Ihrem Ausgangsverzeichnis und starten Sie IBM Integration Toolkit erneut. Entfernen Sie beispielsweise das folgende Verzeichnis (dabei steht Benutzer-ID für Ihre Benutzer-ID): /home/Benutzer-ID/.eclipse
      2. Erstellen Sie ein Verzeichnis namens eclipse an einer geeigneten Position im Dateisystem. Es ist dabei nicht relevant, in welcher Verzeichnisstruktur das Verzeichnis eclipse enthalten ist.
      3. Erstellen Sie im Verzeichnis eclipse die Verzeichnisse features und plugins.
      4. Windows platform Unter Windows: Erstellen Sie unter C:\Programme\IBM\IntegrationToolkit90 einen neuen Verknüpfungsordner und darin eine Datei mit dem Namen Name.link. Dabei steht Name für einen Namen Ihrer Wahl. Geben Sie in die Datei Name.link folgenden Text ein: path=C:/Pfad/zu/Ihrem/Verzeichnis/. Dabei ist Pfad/zu/Ihrem/Verzeichnis/ der Pfad zu Ihrem Verzeichnis.

        Beispiel: Wenn Sie die Plug-ins in das Verzeichnis C:\Temp\MyPlugins\eclipse\plugins\ eingefügt haben, hat die Verknüpfungsdatei folgenden Inhalt: path=C:/Temp/MyPlugins.

  2. Starten Sie die IBM Integration Toolkit-Sitzung erneut, damit die Änderungen in Kraft treten.

Brokerinstallationen

Gegebenenfalls müssen Sie die installierten Versionen von IBM Integration Bus ermitteln, um sicherzustellen, dass von der richtigen Brokerversion die richtige LIL-Datei geladen wird. Weitere Informationen finden Sie im Abschnitt Installierte Versionen von IBM Integration Bus ermitteln.

Informationen zum Hinzufügen von JAR- oder LIL-Dateien zu Brokerinstallationen in IBM Integration Bus Version 9.0 oder höher finden Sie im Abschnitt Laufzeitdateien für benutzerdefinierte Erweiterung auf einem Broker installieren.

Benutzerdefinierte Erweiterung für einen einzelnen Broker installieren

Version 7.0, Version 8.0 und Version 9.0
  • Um eine 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.
Version 6.1 und früher
  • 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.
  • Wenn nur ein Broker im System zum Zugriff auf eine 64-Bit-Erweiterung berechtigt sein soll, ist die Einstellung UserLilPath64 für den Broker zu ändern. Hierfür wird im Befehl mqsicreatebroker bzw. mqsichangebroker der Parameter -r angegeben.

Sie finden weitere Informationen hierzu in den Abschnitten Befehl mqsicreatebroker und Befehl mqsichangebroker.

Benutzerdefinierte Erweiterung für mehrere Broker installieren

Version 7.0, Version 8.0 und Version 9.0
  • Damit alle Broker auf einem System betroffen sind, müssen Sie 'LILPATH' modifizieren. Hängen Sie das Verzeichnis, in dem sich das Verzeichnis mit den Erweiterungsdateien befindet, an die Umgebungsvariable MQSI_LILPATH an. MQSI_LILPATH64 ist bei dieser Version nicht gültig.
Version 6.1 und früher
  • 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.

Nehmen Sie diese Änderung vor, indem Sie im Arbeitsverzeichnis ein benutzerdefiniertes Umgebungsscript erstellen:

  • Linux platformUNIX platform Auf Linux- und UNIX-Systemen: /var/mqsi/common/profiles
  • Windows platform Unter Windows: %APPLICATIONDATA%\IBM\MQSI\common\profiles. Dabei ist %APPLICATIONDATA% die Umgebungsvariable, die das Arbeitsverzeichnis des Systems definiert. Das Standardverzeichnis ist betriebssystemabhängig:
    • Unter Windows 7 und Windows Server 2008: C:\ProgramData\IBM\MQSI\common\profiles
    Möglicherweise weicht der tatsächliche Wert auf Ihrem Computer von diesen Angaben ab.

Sie können dem Umgebungsscript einen beliebigen Namen geben, aber die Dateierweiterung muss .cmd bei Windows und .sh bei allen anderen Plattformen lauten. Das Script kann alle Operationen eines Shell-Scripts ausführen, allerdings muss es auf die folgenden Variablen beschränkt werden:

MQSI_LILPATH
Definiert Verzeichnisse zum Suchen von Plug-ins
CLASSPATH
Definiert die Pfade, die Java nach weiteren Klassen durchsucht.
MQSI_CONSOLE_NLSPATH
Unter Windows: Definiert die Speicherposition von Nachrichtenkatalogen (DLL-Dateien).
NLSPATH
Unter Linux und UNIX: Definiert die Speicherposition von Nachrichtenkatalogen (CAT-Dateien).
PATH
Definiert die Speicherposition von ausführbaren Dateien. Unter Windows: Diese Variable definiert auch die Speicherposition abhängiger Bibliotheken.
LIBPATH / SHLIB_PATH / LD_LIBRARY_PATH
Unter UNIX und Linux: Definiert die Speicherposition abhängiger Bibliotheken.

Beispielscripts

Windows platform Unter Windows: Dieses Beispiel zeigt das Umgebungsprofil für MyExtension, das unter Windows (32-Bit) im Verzeichnis C:\Programme\MyExtensions bzw. unter Windows (64-Bit) im Verzeichnis C:\Programme(x86)\MyExtensions installiert ist.

Das Script trägt die Bezeichnung MyExtension.cmd und ist im Arbeitsverzeichnis gespeichert. Die Standardposition lautet %APPLICATIONDATA%\IBM\MQSI\common\profiles, wobei die Standardeinstellung für die Umgebungsvariable %APPLICATIONDATA% betriebssystemabhängig ist:

  • Unter Windows 7 und Windows Server 2008: C:\ProgramData\IBM\MQSI\common\profiles.
Möglicherweise weicht der tatsächliche Wert auf Ihrem Computer von diesen Angaben ab.

Der Inhalt des Windows-Scripts lautet wie folgt:

REM von MyExtension-Installation, nicht modifizieren
set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Programme\MyExtension\bin"

Linux platformUNIX platform Unter Linux und UNIX: Dieses Beispiel zeigt das Umgebungsprofil für "MyExtension", das im Verzeichnis /opt/MyExtension installiert ist. Das Script trägt die Bezeichnung MyExtension.sh und wird im Arbeitsverzeichnis /var/mqsi/common/profiles/ gespeichert.

Der Inhalt des Linux-Scripts lautet wie folgt:

#!/bin/ksh
# Von MyExtension-Installation hinzugefügt, nicht modifizieren
export MQSI_LILPATH=/opt/MyExtension/lil${MQSI_LILPATH:+":"${MQSI_LILPATH}}

Die folgenden Variablen im Profilscript können getestet werden, beispielsweise um sicherzustellen, dass eine benutzerdefinierte Erweiterung nur auf einer bestimmten Brokerversion ausgeführt werden kann:

MQSI_FILEPATH
Der vollständige Pfad der installierten Datei für IBM Integration Bus
MQSI_WORKPATH
Der vollständige Pfad der zu den Konfigurationsdaten für IBM Integration Bus
MQSI_VERSION
IBM Integration Bus-Version im Format version.release.modification.fix
MQSI_VERSION_V
Der Wert von IBM Integration Bus übergeordnete Version
MQSI_VERSION_R
Der Wert von IBM Integration Bus-Release
MQSI_VERSION_M
Der Wert von IBM Integration Bus-Modifikationsnummer
MQSI_VERSION_F
Der Wert von IBM Integration Bus-Fixversion
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-07-18 03:06:07


TaskthemaTaskthema | IBM Integration Bus Version 9.0.0.0 | as04540_