欢迎使用 IBM WebSphere Message Broker 和 IBM WebSphere Event Broker。这是运行时组件 V6.0.0.3(修订包 3)及 Toolkit V6.0.0.2 的自述文件。
本自述文件描述了一些已知问题,并且包含未能及时在在线信息中心中提供的文档更新。
请始终使用本自述文件的最新版本,您可在以下地址找到最新版本(仅提供英语版本):
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
在以下地址可找到自述文件的翻译版本:ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0
要完成安装,请参阅《WebSphere Message Broker 安装指南》或《WebSphere Event Broker 安装指南》。 这两本指南包含有关在安装该产品之前必须完成的任务的信息。同时还包含 HP-UX(Itanium 平台)支持的有关信息。
您可以访问以下地址的 IBM 出版物中心中的在线安装指南:
http://publib.boulder.ibm.com/epubs/pdf/c3466213.pdf(对于 Message Broker)
http://publib.boulder.ibm.com/epubs/pdf/c3466223.pdf(对于 Event Broker)
WebSphere Message Broker 和 WebSphere Event Broker 信息中心反映运行时组件 V6.0.0.3 和工具组件 V6.0.2.0 的相关信息。
Toolkit 中包含的某些增强功能在此版本的信息中心中没有记载。主题“V6.0 中的新增功能”概述了信息中心中描述的新功能,但也还有以下几方面的 Toolkit 增强功能尚未记载:
即将推出其中包含这些增强功能相关新信息的信息中心更新版本。
可从以下地址访问 WebSphere Message Broker 和 WebSphere Event Broker 的独立信息中心:http://www.ibm.com/software/integration/wbimessagebroker/library/
也可从以下地址下载此信息中心:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_lin.tgz(Linux 版本)
和
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_win.zip(Windows 版本)。
请阅读 wmb_help_lin.tgz 和 wmb_help_win.zip 文件中包含的 installing_and_managing.htm 文件。
打印格式的信息主题集合以及 Rules and Formatter 的所有文档均可在以下地址找到:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/
缺陷:本自述文件文档通篇引用了缺陷编号。这些编号是指 IBM 的内部问题编号;当您与 IBM 服务代表讨论问题时,您会发现这些编号非常有用。
技术说明:有关当前已知问题和可用修订的信息,请访问:
http://www.ibm.com/software/integration/wbimessagebroker/support/
您可以使用以下任何一种方法查找信息:
版本:有关 WebSphere Message Broker 和 WebSphere Event Broker 支持的操作系统和数据库特定版本的最新状态,请访问位于以下地址的“WebSphere MQ 系列产品支持软件”页面:
http://www.ibm.com/support/docview.wss?uid=swg27007065
本部分按组件概述 WebSphere Message Broker 和 WebSphere Event Broker 的限制和局限。
在《安装指南》和信息中心主题“V6.0 修订包中的新增功能”中描述的 WebSphere Message Broker 扩展、样本和演示 CD 只在 Windows XP 上可用。
在任何 UNIX 平台上,如果在没有安装代理组件的情况下安装配置管理器组件,然后将代理安装到同一个目录中,则代理的 lil 和 lil64 目录中将缺少几个文件符号链接。 要避免发生此问题,请执行以下某个操作:
要将 Message Brokers Toolkit(从 V6.0、V6.0.0.1 或 V6.0.0.2)升级到 V6.0.2.0,必须使用级别为 6.0.1 或更高级别的 Rational Product Updater(RPU)。如果您当前使用的 RPU 版本较低,则必须先将其升级到 V6.0.1,然后再升级 Message Brokers Toolkit。有关对 RPU 升级的信息,请参阅 《WebSphere Message Broker 安装指南》。
使用 RPU,您可以直接从 Web 也可以从本地系统安装 Message Brokers Toolkit(V6.0.2.0)。使用 RPU 升级到 V6.0.2.0 的步骤在《WebSphere Message Broker 安装指南》中有说明。
如果您要使用 RPU 从本地系统(而不是直接从 Web)安装程序包,则需要下载的程序包取决于当前所安装的产品版本:
升级到 V6.0.2.0 之后,需要执行以下操作:
提供的技术说明涵盖了一些有关将 Message Brokers Toolkit 和 Event Broker Toolkit 与 Rational Application Developer(RAD)或 Rational Software Architect(RSA)产品一起安装的重要问题。因此,强烈建议在安装 Message Brokers Toolkit 时参阅这些技术说明。本自述文件的支持部分中提供了有关如何访问这些技术说明的信息。
当使用用于静默安装的响应文件时,这些文件可能包含未正确设置的标志。因此,如果选择一个或多个要安装的特定组件(而非完整产品),这些选择将被忽略,而安装完整产品。要解决该问题,需要编辑响应文件并如下所示修改相应的标志:
应将以下行:
-W setupTypes.selectedSetupTypeId=custom
更改为:
-W setupTypes.selectedSetupTypeId=
(即,设为无)以避免运行缺省的典型安装或定制安装(安装所有组件)。
如果您要开发的消息流将使用具有多点广播支持的 WebSphere MQ 实时传输,则必须在每个受影响的代理系统上安装 WebSphere MQ V6.0 或更高版本。您还需要应用 APAR IC47032 和 USERMOD ANPGM01。
Message Broker 在全局区域或整个根的非全局区域中受支持,并且必须在每个区域中单独安装。
如果已经在一台计算机上安装了 WebSphere Message Broker 的一个或多个组件,并随后尝试安装任何其他组件,则 InstallShield 将检查并确认是否有足够的磁盘空间来安装整个产品而不只是要安装的其他组件。因此,即使计算机有安装其他组件的足够空间,可能也无法安装这些组件。如果有足够的空间来安装整个产品,则可以成功安装选定的组件。但是,如果没有足够的空间,则需要卸载先前安装的组件然后再次开始安装。
“命令助手向导”当前无法管理配置管理器组件。 日后将会发布更正该问题的修订。
如果要安装与 WebSphere Message Brokers Toolkit 结合使用的 WebSphere MQ V6 Explorer 插件,可使用 Eclipse 更新管理器。但是,必须首先安装 WebSphere MQ V6 的 V6.0.1 更新包。
从 Eclipse 工具栏中选择帮助 > 软件更新 > 查找并安装。选择新功能部件选项。 添加 <WebSphere MQ 安装目录>/eclipse 作为新的本地源,而 Explorer 功能部件将显示为可安装。
作为在 V6.0.1 更新可用之前的变通方法,您可将包含 WebSphere MQ Explorer 功能部件和插件的目录手动复制到 WebSphere Message Brokers Toolkit 目录中。重新启动 WebSphere Message Brokers Toolkit 后,WebSphere MQ Explorer 便可作为新的透视图打开。
使用 -options-record 标志创建供静默卸载期间使用的响应文件时,该响应文件包含一个未正确设置的标志。因此,如果选择卸载一个或多个特定组件(而非完整产品),此选项将被忽略,并且将卸载完整的产品。
要解决该问题,需要编辑响应文件并修改其中指定是否卸载个别组件的每一行。这意味着您需要将出现的以下所有字符串:
-P feature.active=true更改为:
-P feature.activeForUninstall=true其中 feature 是要卸载的组件的名称。
您也需要将出现的以下所有字符串:
-P feature.active=false更改为:
-P feature.activeForUninstall=false其中 feature 是您不希望卸载的组件的名称。
您必须确保对于每个组件都存在这其中一个语句(activeForUninstall=true 或 ctiveForUninstall=false)。
但是,在生成的响应文件中,也可以存在与尚未安装的组件相关联的 activeForUninstall 语句。如果存在这样的语句,请确保对于每个组件,都将 activeForUninstall 选项设置为 true。如果对于这些组件将 activeForUninstall 选项设置为 false,则卸载程序会失败。
以下 Dublin Adapter 解决方案的所有用户应联系 Dublin Adapters Support(dubadsup@ie.ibm.com),获取已在 Message Broker V6 上经过测试的解决方案版本。不要仅仅迁移 V5 解决方案,因为这会导致与 V5 功能的细小差别:
在尝试将解决方案迁移至 V6 之前,以下 Dublin Adapter 解决方案的所有用户应联系 Dublin Adapters Support(dubadsup@ie.ibm.com)以检查是否有已在 Message Broker V6 上经过测试的解决方案版本,以及是否还有任何其他问题:
如果要将某个消息集从 WebSphere MQ Integrator V2.1 进行迁移,而且该消息集包含业界标准 TDS 物理格式(如,SWIFT),并且如果要将该消息集部署到 V2.1 代理(或部署到服务级别低于修订包 3 的 V5 代理),则可能需要在使用 mqsimigratemsgsets 命令后完成以下步骤。
如果未进行此更新,则在将消息集添加到 BAR 文件时,将显示以下消息(此消息中的 CSD3 指修订包 3):
BIP0202W 该字典需要 V5 CSD3 或更高版本的代理。TDS 格式“SWIFT”使用“严格数字检查”。版本低于 V5 CSD 3 的代理不支持该选项。
必须更正该错误,然后才能成功部署 BAR 文件。
在将 Real-timeInput 节点与发布/预订应用程序结合使用时,所有分布式平台上的 DataFlowEngine 进程中可能存在内存泄漏。根据平台和发布/预订客户机的数目,DataFlowEngine 进程使用的内存将不断增加。
如果 DataFlowEngine 进程内存不足,该进程将停止。在 Windows 上,将在“errors”文件夹中生成 ABEND 文件和转储。在其他系统上,将生成 ABEND 文件以及核心文件。DataFlowEngine 进程随后会重新启动。
例如,在具有一个执行组的一个代理中使用单个消息流(不带其他实例),并且在一台运行 Windows 的 4 路 4GB 计算机上有 80 台发布/预订客户机,DataFlowEngine 进程将于大约 1.5 小时后停止。
在系统事件日志中可能会看到如下错误消息:
发生 Java 虚拟机内存不足错误。 JVM 已报告了内存不足错误。
ABEND 文件可能包含以下错误:
文件:F:\build\S000_P\src\DataFlowEngine\JavaNodeLibrary\ImbJmsIpJNIJmsIpNode.cpp 行:417 函数:Java_com_ibm_broker_server_JmsIpNode_logFatalError 异常终止行为:3
要解决该问题,可能需要停止并重新启动代理,并增加 Java 虚拟机堆大小。如果使用 Real-timeOptimizedFlow 节点,而非 Real-timeInput 节点,则可以避免某些内存问题。
在 z/OS 平台上:如果高吞吐量消息流中包括 Trace 节点(其目标属性设置为“用户跟踪”),则所拥有的执行组可能会停止(异常终止 S2C1)。由于 Trace 节点始终处于活动状态,因此通常不应将这些节点包括在生产流中。但为避免出现上述问题,请确保高吞吐量流中不包含已连接的 Trace 节点,这是因为这些节点始终处于活动状态,其 I/O 开销会很高。
为了使 Mapping 节点能够与 MIME 域解析器一起工作,必须使用 IBM 提供的 Message Brokers 消息定义中的 mime_multipart.xsd 或 mime_nested_multipart.xsd。
如果要使用流调试器,则无论计算机设置为哪种语言环境,代理和执行组的名称都必须为英文字母字符。
在 AIX 上,如果没有从 /usr/lib 到 Oracle 提供的 32 位客户机库“libclntsh.a”的链接,则支持 XA 的 WebSphereMQ 队列管理器(在 WebSphere MQ V5 上)就无法干净地启动。
要解决该问题,请发出以下命令(作为 root 用户):
ln -s $ORACLE_HOME/lib32/libclntsh.a /usr/lib/libclntsh.a
此命令使队列管理器能干净地启动。
请注意,这不适用于 WebSphere MQ V6。
如果将 Oracle9i 或 Oracle10g 与 DB2v8 安装在同一 HP-UX 系统上,则在将代理与 Oracle 代理数据库结合使用时可能会遇到问题。
代理将无法启动,并创建异常终止文件。在该文件中,会看到来自 Oracle 库却是在 DB2 库中解析的符号,这将导致发生分段违例。
如果要将 Oracle 与代理结合使用,并将 DB2 安装在同一台(HP-UX)计算机上,请禁用 <install_dir>/lib/imbdfdb2.lil 文件。实现该操作的最简便方法是将 imbdfdb2.lil 文件重命名。这样将使代理无法获得 HP-UX 操作系统随后用于解析 Oracle 符号的 DB2 库。
在 AIX、Solaris 和 HP-UX 上,不支持带 64 位 EGs 的 Oracle XA。
不支持对数据库中 Unicode 数据的处理。
除了信息中心中“支持的数据库”主题中描述的限制之外,还请注意当前仅支持 32 位 Informix Dynamic Server 和 32 位客户机 SDK。当前不支持 64 位 Informix 服务器或客户机。
Informix 客户机的最低版本要求是带有 UC4X8 修订包的 SDK V2.90;请联系 Informix 以获取此修订包。
在描述 ROUND 函数的信息中心主题中,示例中在 MODE 和 RoundingMode 之间显示有下划线字符,这是错误的。下划线字符应该用空格替换。例如:
ROUND(5.5, 0 MODE_ROUND_UP); returns 6是错误的,正确的格式为:
ROUND(5.5, 0 MODE ROUND_UP); returns 6
在 Linux 和 Windows 上,某些样本有可用性较差的问题。使用这些样本之前,请参阅以下技术说明:
http://www.ibm.com/support/docview.wss?rs=849&context=SSKM8N&context=SSKMAB&q1=samples&uid=swg21239255&loc=en_US&cs=utf-8&lang=en
本信息是为在美国提供的产品和服务编写的。
IBM 可能在其他国家或地区不提供本信息中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息,请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权,任何同等功能的产品、程序或服务,都可以代替 IBM 产品、程序或服务。但是,评估和验证任何非 IBM 产品、程序或服务,则由用户自行负责。
IBM 公司可能已拥有或正在申请与本信息内容有关的各项专利。提供本信息并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往:
有关双字节(DBCS)信息的许可查询,请与您所在国家或地区的 IBM 知识产权部门联系,或用书面方式将查询寄往:
以下条款不适用于英国或此类条款与当地法律不一致的任何其他国家或地区:
International Business Machines Corporation“按现状”提供本出版物,不附有任何种类的(无论是明示的还是暗含的)保证,包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。
本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改;这些更改将编入本资料的新版本中。IBM 可以随时对本信息中描述的产品和/或程序进行改进和/或更改,而不另行通知。
本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的,不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分,使用那些 Web 站点带来的风险将由您自行承担。
IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。
本程序的被许可方如果要了解有关程序的信息以达到如下目的:(i)允许在独立创建的程序和其他程序(包括本程序)之间进行信息交换,以及(ii)允许对已经交换的信息进行相互使用,请与下列地址联系:
只要遵守适当的条件和条款,包括某些情形下的一定数量的付费,都可获得这方面的信息。
本信息中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。
涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试,也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。
本信息包含日常业务经营中使用的数据和报告的示例。为了尽量完整地说明它们,示例中包含了个人、公司、商标和产品的名称。所有这些名称都是虚构的,任何与实际企业使用的名称和地址的类似纯属巧合。
版权许可:
本信息包括源语言形式的样本应用程序,这些样本应用程序说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口(API)进行应用程序的开发、使用、经销或分发为目的,您可以任何形式对这些样本程序进行复制、修改、分发,而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此,IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。用户如果是为了按照 IBM 应用程序编程接口开发、使用、经销或分发应用程序,则可以任何形式复制、修改和分发这些样本程序,而无须向 IBM 付费。
以下术语是 International Business Machines Corporation 在美国和/或其他国家或地区的商标:
AIX、DB2、Everyplace、IBM、Universal Database、WebSphere、z/OS、zSeries。
Java 和所有基于 Java 的商标是 Sun Microsystems, Inc. 在美国和/或其他国家或地区的商标。
Microsoft 和 Windows 是 Microsoft Corporation 在美国和/或其他国家或地区的商标。
UNIX 是 The Open Group 在美国和其他国家或地区的注册商标。
Linux 是 Linus Torvalds 在美国和/或其他国家或地区的商标。
其他公司、产品或服务名称可能是其他公司的商标或服务标记。
DB2 修订包
可在 CD-ROM 中或者从 Web 进行下载来获取 DB2 修订包。但是,请注意,修订包可能很大,因此使用 CD-ROM 版本的修订包可避免耗时的下载。
如果有当前支持合同,则可以致电 DB2 支持中心来定购 CD-ROM 版本的 DB2 修订包。
以下地址提供了详细的联系信息:
http://www.ibm.com/software/data/db2/udb/support.html
也可以从该 Web 站点进行下载。
WebSphere MQ 修订包
http://www.ibm.com/software/integration/wmq/support/
WebSphere Message Brokers 修订包
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006367
WebSphere Message Broker 和 WebSphere Event Broker 需求
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
和
http://www.ibm.com/software/integration/wbieventbroker/requirements/
WebSphere Message Broker 和 WebSphere Event Broker 自述文件
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
WebSphere Message Broker 和 WebSphere Event Broker 独立信息中心
对于 Linux:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_lin.tgz
对于 Windows:
ftp://ftp.software.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_win.zip
WebSphere Message Brokers V6 联机帮助
http://publib.boulder.ibm.com/infocenter/wmbhelp/v6r0m0/index.jsp
IBM Java 技术开发中心下载
http://www.ibm.com/developerworks/java/jdk/
Web 服务描述语言(WSDL)规范
http://www.w3.org/TR/wsdl
WebSphere Message Broker Basics(红皮书)
http://www.redbooks.ibm.com/abstracts/sg247137.html
迁移到 WebSphere Message Broker V6(红皮书)
http://www.redbooks.ibm.com/abstracts/sg247198.html