将用户定义的扩展安装到代理的当前版本和过去版本

开始之前

  1. 必须如编译 Java 用户定义的节点编译 C 用户定义的扩展中所述,已对用户定义的节点进行了编译。
  2. 必须如测试用户定义的节点中所述,已对用户定义的节点进行了测试。

本主题适用于第三方用户,他们希望用户尽可能少地干预安装到 WebSphere Message Broker 的过程。

要安装用户定义的扩展,需要将扩展安装到运行时和 Message Brokers Toolkit。组件可以单独安装,也可以作为安装过程的一部分来安装。组件可能会在其他系统上,因此您应该确保最终用户在所有受影响的系统上运行安装。

Message Brokers Toolkit 安装

安装扩展前,您可能需要确定要将扩展安装到 Message Brokers Toolkit 的版本,因为特定版本的 Message Brokers Toolkit 是用户定义扩展的先决条件,或它可能需要特定的文件才能运行。

要确定 Message Brokers Toolkit 的版本,请参阅检测已安装的 WebSphere Message Broker 版本

如果该产品与其他产品共享一个 shell,则安装路径将是先安装的 RAD 程序的安装路径。使用以下步骤确定 Message Brokers Toolkit 的位置。

要确定 Message Brokers Toolkit 的安装位置,您需要查看由 RAD 设置的 cdi_ref.properties 文件。Message Brokers Toolkit 和 Rational V6.x 产品都会安装此文件:第一次安装这些产品中的某个时,将创建该文件。所有后续安装都共享该文件。如果卸载所有 Message Brokers Toolkit 和 Rational V6.x 产品,则在卸载最后一个产品后,该文件被除去。

  1. 如果您使用 Installshield Multiplatform Edition 来确定位置,则位置解析为 $D(os_main)/IBM/RAT60/.sdpinst/cdi_ref.properties

    在此示例中,$D(os_main) 是 Installshield 变量,我们所使用的 CDI 安装框架就构建在其上。

  2. 如果您不使用 Installshield Multiplatform Edition:
    1. 位置解析为 /etc/IBM/RAT60/.sdpinst/cdi_ref.properties
    2. 按以下顺序在以下两个位置查找该文件:
      1. %windir%/IBM/RAT60/.sdpinst/cdi_ref.properties
      2. %SystemRoot%/IBM/RAT60/.sdpinst/cdi_ref.properties
  3. 使用 cdi_ref.properties 文件检测 Message Brokers Toolkit 是否安装;搜索 c_wmbt_specific.products=wmbt

    对于位置,查看以下变量:c_wmbt_specifc.b_wmbt_specific.location

    例如,C:\Program Files\IBM\MessageBrokersToolkit\6.0

    例如,/opt/ibm/MessageBrokerToolkit/6.0

    对于工作台的位置,查看变量 c_wb.b_wb.location

    例如,C:\Program Files\IBM\MessageBrokersToolkit\6.0

    例如,/opt/ibm/MessageBrokerToolkit/6.0

请注意,c_wb.b_wb.location 的值可能与 c_wmbt_specifc.b_wmbt_specific.location 的值不同。如果在安装 WebSphere Message Broker 前已装有其他 RAD 产品,就会发生这种情况。

如果 cdi_ref.properties 不存在,则没有安装 Rational 产品,也没有安装 Message Brokers Toolkit

要为新的用户定义节点设置具有图标和选项的 Message Brokers Toolkit,您应该设置一个新的 Eclipse 链接文件,它指向包含 Eclipse 插件文件的目录。该链接文件应该包含一行,它是目标目录的完整路径。创建 Eclipse 链接文件时,将它放在 <c.wb.b_wb.location>/eclipse/links/ 中。例如:

名为 opt/ibm/MessageBrokerToolkit/6.0/Myextension 的文件可能包含行 path=/opt/My/Extension/Nodes。该行中指向的目录应该包含使用分发用户定义的扩展中的指示信息汇编的插件片段。

安装扩展后,使用 -clean 选项重新启动目标工作台。您可以从命令行或通过修改菜单快捷方式来执行此操作。每当更改用户定义的扩展时,都应该使用 -clean 选项,以确保所作的更改被消息流节点选用板拾取。重新启动工作台后,节点的新类别出现在流编辑器的选用板上。

运行时安装

您可能需要检测已安装的运行时版本,以确保由正确级别的代理装入正确的 .lil 文件。请参阅检测已安装的 WebSphere Message Broker 版本

要将 .jar 或 .lil 文件添加到 WebSphere Business Integration Message Broker V5.0 或更新版本上的运行时安装,更新开始请参阅在代理域上安装用户定义的扩展更新结束。对于 V2 代理,将插件添加到 <WebSphere Brokers 安装目录>/lil/ 并重新启动代理。

单个代理的扩展

如果要只能从系统上的一个代理访问扩展,则您可以在 mqsicreatebrokermqsichangebroker 命令中使用 -l 参数,来修改该代理的用户 .lil 路径。有关更多信息,请参阅 mqsicreatebroker 命令mqsichangebroker 命令

多个代理的扩展

要影响系统上的所有代理,必须修改系统 lil 路径。要这样做,可以将目录追加到 MQSI_LILPATH 环境变量,该目录包含带有扩展的目录。可以通过在 Windows 上的 %ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\profilesUNIX 上的 /var/mqsi/common/profiles 中创建定制环境脚本来执行此操作。您可以为环境脚本赋予任何名称,但是在 Windows 上文件扩展名必须为 .cmd,而在其他所有平台上则必须为 .sh。该脚本可以执行 shell 脚本的所有操作,但是您应该将范围限制为仅追加以下变量:
MQSI_LILPATH
定义搜索插件的目录
CLASSPATH
定义 Java 搜索其他类的位置
NLSPATH
定义消息目录的位置
PATH
定义可执行文件的位置。在 Windows 上,它还定义了附属库的位置。
LIBPATH / SHLIB_PATH / LD_LIBRARY_PATH
定义附属库的位置。

示例脚本

MyExtension 的环境概要文件,安装在 C:\Program Files\MyExtensions 中。该脚本称为 C:\Documents and Settings\All Users\Application Data\IBM\MQSI\common\profiles\MyExtension.cmd
REM Added by MyExtension install, do not modify
set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Program Files\MyExtension\bin"
MyExtension 的环境概要文件,安装在 /opt/MyExtension 中。该脚本称为 /var/mqsi/common/profiles/MyExtension.sh
#!/bin/ksh
# Added by MyExtension install, do not modify
export MQSI_LILPATH=/opt/MyExtension/lil${MQSI_LILPATH:+":"${MQSI_LILPATH}}

您可以在概要文件脚本中测试以下变量,例如,是否要确保用户定义的扩展只在特定版本的代理上运行。

MQSI_FILEPATH
包含到 WebSphere Message Broker 已安装文件的完整路径
MQSI_WORKPATH
包含到 WebSphere Message Broker 配置数据的完整路径
MQSI_VERSION
WebSphere Message Broker 版本,格式为 version.release.modification.fix
MQSI_VERSION_V
WebSphere Message Broker 主版本的值
MQSI_VERSION_R
WebSphere Message Broker 发行版的值
MQSI_VERSION_M
WebSphere Message Broker 修改号的值
MQSI_VERSION_F
WebSphere Message Broker 修订级别的值
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as04540_