欢迎使用 IBM WebSphere Message Broker 和 IBM WebSphere Event Broker。这是运行时组件的修订包 10(V6.0.0.10)和工具箱组件的 V6.0.2 临时修订 018 的自述文件。
本自述文件描述了已知问题并包含了对产品文档可用级别的更新。
请始终使用本自述文件的最新版本,您可在以下地址找到最新版本(仅提供英语版本):
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
可在以下地址获取已翻译的自述文件:ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V6.0
要完成安装,请参阅《WebSphere Message Broker 安装指南》或《WebSphere Event Broker 安装指南》。这两本指南包括有关在安装该产品前必须完成的任务的信息。它们还包含对 HP-UX(Integrity 平台)的支持信息。
可以访问以下网址的 IBM 出版物中心提供的在线安装指南:
http://publib.boulder.ibm.com/epubs/pdf/c3466213.pdf(用于WebSphere Message Broker)。
http://publib.boulder.ibm.com/epubs/pdf/c3466223.pdf(用于WebSphere Event Broker)。
如《安装指南》(2006 年 12 月,第四版)中所述, 本指南不仅适用于运行时组件修订包 4(V6.0.0.4),还适用于修订包 3(V6.0.0.3)。 本《安装指南》不会为此已交付产品重新发行。有关此安装指南的最新修正,请参阅本自述文件的文档部分。
WebSphere Message Broker 和 WebSphere Event Broker 反映运行时组件的 修订包 9(V6.0.0.9)和工具组件的 V6.0.2 临时修订 017。
WebSphere Message Broker 和 WebSphere Event Broker 的独立信息中心可从以下地址进行在线访问:http://www.ibm.com/software/integration/wbimessagebroker/library/6.0/index.html
也可从以下地址下载独立信息中心:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_linux.tgz(Linux® 版本)
和
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_win.zip(Windows® 版本)
请阅读 wmb_help_linux.tgz 和 wmb_help_win.zip 文件中包含 using_the_infocenter.html 文件。
可移植文档格式(.pdf)中的信息主题集合
以及特定规则和格式化程序的文档可在以下地址找到:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V6.0/
缺陷:整个自述文件文档中,各缺陷号都有对应参考。 这些编号是指 IBM 的内部问题编号;当您与 IBM 服务代表讨论问题时,您可能会发现这些编号非常有用。
技术说明:
有关当前已知问题和可用修订的信息,请访问 WebSphere Message Broker 支持 Web 站点,网址为:
http://www.ibm.com/software/integration/wbimessagebroker/support/
要查找信息,请 单击故障诊断 > 查看所有故障诊断文档。 将显示所有相关的技术说明,可以对它们进行排序和进一步搜索。
版本:有关 WebSphere Message Broker 和 WebSphere Event Broker 支持操作系统和数据库特定版本的最新状态,请访问“系统需求和库链接”页面,网址为:
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.2 或更高版本的 Rational Product Updater(RPU)。如果您当前使用的 RPU 版本较低,必须先将其升级到 V6.0.2,然后再升级 Message Brokers Toolkit。有关升级 RPU 的信息,请参阅《WebSphere Message Broker 安装指南》,网址为:http://publib.boulder.ibm.com/epubs/pdf/c3466213.pdf。
使用 RPU,您可以直接从 Web 也可以从本地系统安装 Message Brokers Toolkit(V6.0.2.0)。使用 RPU 升级到 V6.0.2.0 的过程 在《WebSphere Message Broker 安装指南》中有说明,网址为:http://publib.boulder.ibm.com/epubs/pdf/c3466213.pdf。
如果您要使用 RPU 从本地系统(而不是直接从 Web)安装程序包,需要下载的程序包将取决于当前所安装的版本:
升级到 V6.0.2.0 后,需要完成以下步骤:
安装 RAC 时,必须在安装向导的 Java 运行时页面输入 Java™ 运行时文件 java.exe 的位置。必须指定已安装 Java 运行时文件的位置。请勿指定随 WebSphere Message Broker 一起安装的 JRE 用于此目的;必须使用备用 JRE。
提供的技术说明涵盖了一些有关将 Message Brokers Toolkit 和 Event Broker Toolkit 与 Rational Application Developer(RAD)或 Rational Software Architect(RSA)产品一起安装的重要问题。因此,强烈建议在安装 Message Brokers Toolkit 时参阅这些技术说明。本自述文件的支持部分中提供了有关如何访问这些技术说明的信息。
在 Toolkit 的 V6.0.2 累积临时修订 005 中已经解决了此问题。
第一次运行缺省配置向导时,创建侦听器失败。要解决这个问题,运行“除去缺省配置向导”,然后再次运行“创建缺省配置向导”。如果这样做也解决不了问题,就需要在 MQSI 命令窗口中输入以下命令手动启动侦听器,然后再次运行“创建缺省配置向导”:
runmqlsr -t tcp -p 1414 -m WBRK6_QUEUE_MANAGER
当使用用于静默安装的响应文件时,这些文件可能包含未正确设置的标志。因此,如果选择安装一个或多个特定组件(而非完整产品),这些选择将被忽略,并且将安装完整的产品。要解决该问题,必须编辑响应文件并修改相应的标志。 例如:
将下面一行:
-W setupTypes.selectedSetupTypeId=custom
更改为:
-W setupTypes.selectedSetupTypeId=
即,将标志设为无以避免运行安装所有组件的缺省的典型安装或定制安装。
如果您要开发的消息流将使用具有多点广播支持的 WebSphere MQ 实时传输,就必须在每个受影响的代理系统上安装 WebSphere MQ V6.0 或更高版本。您还需要应用 APAR IC47032 和 USERMOD ANPGM01。
WebSphere Message Broker 修订包 9(V6.0.0.9)添加了 WebSphere MQ V7 支持。WebSphere Message Broker 通过将代理程序队列管理器的 PSMODE 属性设为“COMPAT”来禁用 Websphere MQ V7 发布/预订支持,从而允许使用 Message Broker 的发布/预订工具取代 Websphere MQ V7 发布/预订。
有关更多信息,请参阅在线 MQ V7 信息中心,网址 为:http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp
WebSphere Message Broker 在全局区域或整个根的非全局区域中受支持,并且必须在每个区域中单独安装。
在下列平台上,如果在现有安装版本上完成修订包 9(V6.0.0.9)安装,那么所需时间会超过安装先前修订包:
修订包 9 包括一组附加的 ODBC 驱动程序和 DataDirect ODBC V5.3 驱动程序。另外,当 ISMP 安装程序执行“更新”安装时,所需时间也较长,因为它需要处理那些不存在于当前安装目录中的文件。在 AIX 和 Solaris 平台上,安装需要较长时间这一情况更明显,因为包括 32 位和 64 位驱动程序。
如果已经在一台计算机上安装了 WebSphere Message Broker 的一个或多个组件,并随后尝试安装任何其他组件,InstallShield 将检查是否有足够的可用磁盘空间来安装整个产品而不只是要安装的其他组件。因此,即使计算机上有足够的空间来安装其他组件,您可能也无法安装这些组件。如果有足够的空间来安装整个产品,就可以成功安装选定的组件。如果没有足够的空间,需要卸载先前安装的组件并重新启动。
在 Toolkit 的修订包 1(V6.0.0.1)中已经解决了此问题。
“命令助手向导”当前无法管理配置管理器组件。
如果要安装与 WebSphere Message Brokers Toolkit 结合使用的 WebSphere MQ V6 Explorer 插件,可使用 Eclipse Update Manager。但是,必须首先安装 WebSphere MQ V6 的 V6.0.1 更新包。
请从 Eclipse 工具栏中选择帮助 > 软件更新 > 查找并安装。选择新功能部件选项。添加 <WebSphere MQ 安装目录>/eclipse 作为新的本地站点,而 Explorer 功能部件将显示为可供安装。
作为 V6.0.1 更新可用之前的变通方法,您可将包含 WebSphere MQ 资源管理器功能部件和插件的目录手动复制到 WebSphere Message Brokers Toolkit 目录中。重新启动 WebSphere Message Brokers Toolkit 后,WebSphere MQ 资源管理器便可作为新的透视图打开。
使用 -options-record 标志创建供静默卸载期间使用的响应文件时,该响应文件包含一个未正确设置的标志。因此,如果选择卸载一个或多个特定组件(而非完整产品),此选项将被忽略,并且将卸载完整的产品。
要解决该问题,需要编辑响应文件并修改其中指定是否卸载个别组件的每一行。这意味着您需要将出现的以下所有字符串:
-P feature.active=true更改为以下字符串:
-P feature.activeForUninstall=true其中 feature 是要卸载的组件的名称。
您也需要将出现的以下所有字符串:
-P feature.active=false更改为:
-P feature.activeForUninstall=false其中 feature 是您不希望卸载的组件的名称。
您必须确保对于每个组件都存在一个语句(activeForUninstall=true 或 activeForUninstall=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 文件。
在运行时组件的修订包 3 (V6.0.0.3)中已经解决了此问题。
将 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 节点,就可以解决某些内存问题。
在运行时组件的修订包 3 (V6.0.0.3)中已经解决了此问题。
在 z/OS 平台上:如果高吞吐量消息流中包括 Trace 节点(其目标属性设置为“用户跟踪”),所拥有的执行组就可能会停止(异常终止 S2C1)。由于 Trace 节点始终处于活动状态,因此通常不应将这些节点包括在生产流中。为避免上述问题,请确保高吞吐量流中不包含已连接的 Trace 节点,这是因为这些节点始终处于活动状态,其 I/O 开销会很高。
要使 Mapping 节点对 MIME 域解析器起作用,必须使用 IBM 提供的 Message Brokers 消息定义中的 mime_multipart.xsd 或 mime_nested_multipart.xsd。
要使订户能接收保留出版物,您需要停止并重新启动发布/预订域中的代理。
如果要使用流调试器,无论哪种计算机语言环境,代理和执行组的名称都必须为英文字母字符。
此问题不适用于 WebSphere MQ V6。
在 AIX 上,如果未创建从 /usr/lib 到 Oracle 提供的 32 位客户机库“libclntsh.a”的链接,那么支持 XA 的 WebSphere MQ 队列管理器(在 WebSphere MQ V5 上)就无法干净地启动。
要解决该问题,请发出以下命令(作为 root 用户):
ln -s $ORACLE_HOME/lib32/libclntsh.a /usr/lib/libclntsh.a
此命令使队列管理器能够干净地启动。
如果将 Oracle9i 或 Oracle10g 与 DB2v8 安装在同一 HP-UX 系统上,那么同时使用代理与 Oracle 代理数据库时就可能会遇到问题。
代理将无法启动,并创建异常终止文件。在该文件中,看到来自 Oracle 库的在 DB2 库中解析的符号,这将导致分段违例。
如果要同时使用 Oracle 与代理程序, 并将 DB2 安装在同一台 HP-UX 计算机上,请通过重命名 imbdfdb2.lil 来禁用 <install_dir>/lib/imbdfdb2.lil 文件。 该命名操作将使代理停止获取 HP-UX 操作系统随后用于解析 Oracle 符号的 DB2 库。
在 AIX、Solaris 和 HP-UX 上,不支持带 64 位执行组的 Oracle XA。
不支持在数据库中操作 Unicode 数据。
除了信息中心中“支持的数据库”主题中描述的限制以外,仅支持 32 位 Informix Dynamic Server 和 32 位 Client SDK。不支持 64 位 Informix 服务器和客户机。
WebSphere Message Broker V6.0 附带 DataDirect V5.0 ODBC 驱动程序。对于下列平台,从 V6.0.0.9 开始,除了附带 V5.0 驱动程序之外,还附带 DataDirect V5.3 ODBC 驱动程序:
V5.0 驱动程序仍然是缺省值。需要手动重新执行一些配置,才能从 V5.0 驱动程序切换至 V5.3 驱动程序。有关详细信息,请参阅:
http://www.ibm.com/support/docview.wss?rs=171&uid=swg21372148
《WebSphere Message Broker 安装指南》和《WebSphere Event Broker 安装指南》适用于已重命名为 HP-UX(Integrity 平台)的 HP-UX(Itanium 平台)。
在《WebSphere Message Broker 安装指南》的第 1 章中,包含有关受支持的数据库(表 4)信息的表包含了有关 Informix 支持的不正确信息。有关 Informix 支持的正确详细信息是:
上面没有列出的平台不支持 Informix 数据库。
信息中心的以下主题描述了在映射编辑器中拖放元素的功能:
然而,在 Linux 中,拖放功能在映射编辑器中无法正常工作。因此,您无法将源元素从源窗格拖放到目标窗格中的目标元素,或将源元素从源窗格拖动到编辑窗格。此外,也无法通过在 MapScript 窗格中拖放元素来向上或向下移动元素。执行这些操作的备用方法在信息中心中有说明。要在 MapScript 窗格中移动元素,您可以使用“复制并粘贴”操作,也可以使用“删除并重建/填充”操作。
在有关 ACL 许可权(主题 ap12520_)的信息中心主题中,表格应该包含 ConfigManagerProxy 对象部分,如下表所示:
对象 | 许可权 | 权限 |
---|---|---|
ConfigManagerProxy | 完全控制 |
|
查看 |
|
此外,以下信息应该添加到此表的“拓扑”部分:
对象 | 许可权 | 权限 |
---|---|---|
拓扑 | 完全控制 | 用于所有代理的完全控制许可权 |
样本收藏夹中五个 JavaCompute 样本中的一个样本 - JavaCompute 节点的 GoogleAPINode 样本,现在由于它使用的 Google API 发生了变化而无法正常工作。目前您无法使用此样本。
本信息是为在美国提供的产品和服务编写的。
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、IBM、Universal Database、WebSphere、z/OS 和 zSeries。
Java 和所有基于 Java 的商标是 Sun Microsystems, Inc. 在美国和/或其他国家或地区的商标。
Microsoft 和 Windows 是 Microsoft Corporation 在美国和/或其他国家或地区的商标。
UNIX 是 The Open Group 在美国和其他国家或地区的注册商标。
Linux 是 Linus Torvalds 在美国和/或其他国家或地区的商标。
其他公司、产品或服务名称可能是其他公司的商标或服务标记。
DB2 修订包
可从 CDROM 上获取 DB2 修订包,或者从 Web 上进行下载。但是,修订包可能很大,因此使用 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/support/docview.wss?rs=849&uid=swg27006548
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://public.dhe.ibm.com/software/integration/wbibrokers/docs/V6.0/wmb_help_linux.tgz
对于 Windows:
ftp://public.dhe.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(IBM Redbooks® 出版物)
http://www.redbooks.ibm.com/abstracts/sg247137.html
迁移到 WebSphere Message Broker V6(IBM Redbooks 出版物)
http://www.redbooks.ibm.com/abstracts/sg247198.html