Benutzerdefinierte Erweiterungen, die Sie selbst entwickelt oder von unabhängigen Anbietern erworben haben, können Sie mit minimalem Benutzereingriff installieren.
Führen Sie folgende Task aus:
Sie müssen benutzerdefinierte Erweiterungen auf allen passenden WebSphere Message Broker-Computern installieren und, falls die Erweiterung ein benutzerdefinierter Knoten ist, auf den WebSphere Message Broker Toolkit-Computern (benutzerdefinierte Parser haben keine WebSphere Message Broker 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.
Überprüfen Sie vor der Installation eines benutzerdefinierten Knotens die Version des WebSphere Message Broker Toolkits, in dem die Installation erfolgen soll, da möglicherweise eine bestimmte Version des WebSphere Message Broker Toolkits vorausgesetzt wird oder bestimmte Dateien ausgeführt werden müssen.
Im Abschnitt Installierte Versionen von WebSphere Message Broker ermitteln wird erläutert, wie Sie die Version feststellen können.
Gegebenenfalls müssen Sie die installierten Versionen von WebSphere Message Broker ermitteln, um sicherzustellen, dass von der richtigen Brokerversion die richtige LIL-Datei geladen wird. Weitere Informationen finden Sie im Abschnitt Installierte Versionen von WebSphere Message Broker ermitteln.
Informationen zum Hinzufügen von JAR- oder LIL-Dateien zu Brokerinstallationen in WebSphere Message Broker Version 8.0 oder höher finden Sie im Abschnitt Laufzeitdateien für benutzerdefinierte Erweiterung auf einem Broker installieren.
Sie finden weitere Informationen hierzu in den Abschnitten Befehl mqsicreatebroker und Befehl mqsichangebroker.
Nehmen Sie diese Änderung vor, indem Sie im Arbeitsverzeichnis ein benutzerdefiniertes Umgebungsscript erstellen:
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:
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:
Der Inhalt des Windows-Scripts lautet wie folgt:
REM von MyExtension-Installation, nicht modifizieren
set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Programme\MyExtension\bin"
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: