IBM Integration Bus V9.0 工具和运行时组件的发行说明文档。
以下软件的发行说明文件:IBM Integration Bus
产品/组件发行版:9.0
更新名称:9.0.0.0
请始终使用本发行说明文件的最新版本,最新版本可在以下网站上找到(仅提供英文版本):
http://www.ibm.com/support/docview.wss?uid=swg27006917
翻译的发行说明文件可在以下位置找到:
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/
有关在安装本产品之前必须完成的任务的信息,请参阅 IBM Integration Bus 9.0 信息中心,网址为:
http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/index.jsp
请检查 IBM Integration Bus 系统需求以确保计划安装的产品修订版支持安装平台。IBM Integration Bus 系统需求网页位于:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
在 Windows 上提供给了两个版本的 IBM Integration Bus v9.0:
IBM Integration Bus 的 64 位修订版在 Windows 操作系统的一些 64 位版本上不受支持。有关更多信息,请参阅 IBM Integration Bus 系统需求网页。
如果是从 WebSphere Message Broker V6.1、V7.0 或 V8.0 迁移,请参阅位于 http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/index.jsp 的联机信息中心,此信息中心提供了如何进行迁移的详细信息。
IBM Integration Bus v9.0 的联机信息中心位于:
http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/index.jsp
总是参阅联机信息中心来获取最新信息。联机信息中心包含比随 IBM Integration Toolkit 一起提供的信息中心更新的信息。
独立信息中心可从以下地址下载:
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/V9.0/ib_help_linux.tgz(Linux 版本)
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/V9.0/ib_help_win.zip(Windows 版本)
有关使用独立信息中心的信息,请阅读 ib_help_linux.tgz 和 ib_help_win.zip 文件中 ibm_help 文件夹中包含的 using_the_infocenter.html 文件。
缺陷:此发行说明文件可能包含对缺陷编号的引用。这些编号是指 IBM 的内部问题编号;当您与 IBM 服务代表讨论问题时,您可能会发现这些编号非常有用。
技术说明:有关已知问题和可用修订的最新信息,请参阅 IBM Integration Bus 支持 Web 站点:
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_Message_Broker
要查找信息,请单击故障诊断。将显示 IBM Integration Bus 技术说明,并可以对它们进行排序和搜索。
有关从 Passport Advantage Web 站点下载 IBM Integration Bus 9.0 安装映像的信息,请参阅 Download IBM Integration Bus V9.0 from the Passport Advantage website 下载文档,位于:
http://www.ibm.com/support/docview.wss?uid=swg24034922
版本:有关 IBM Integration Bus 支持哪些操作系统版本的最新信息,请参阅系统需求页面:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
定期检查 IBM Integration Toolkit 的更新,包括英语以及其他受支持语言的文档更新。可以在以下网址找到 IBM Integration Bus 的建议修订:
http://www.ibm.com/support/docview.wss?uid=swg27006041
可以在以下网址找到 V9.0 中的新增功能的详细信息:
http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/index.jsp?topic=/com.ibm.etools.mft.doc/bb23800_.htm
本部分按组件概述了 WebSphere Message Broker 的已知问题及其变通方法(如果有的话)。
症状:
如果您运行 IBM Integration Bus 卸载程序 uninstaller.exe,并且使用的是 Windows 7 或 Windows Server 2008 R2,那么会显示一个窗口,警告卸载程序文件未经签名。
解决方案:
可以安全地忽略此警告。继续卸载过程。
Ubuntu 上支持 IBM Integration Bus,但是仅限于开发系统。生产系统不应用于在 Ubuntu 上运行 IBM Integration Bus。
有关更多信息,请参阅 IBM Integration Bus 系统需求页面:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
症状
如果尝试连接的节点具有通往其他节点的多个输出终端,那么无法创建连接。
解决方案
要绕过此问题,请完成以下一个步骤:
症状
从 WebSphere Message Broker V8.0.0.1 升级后,在 Solaris 或 HP 系统上运行的 bipbroker 和 DataFlowEngine 进程可能会多占用 204 MB 内存。 在集成节点(代理程序)进程使用的 Java 虚拟机 (JVM) 中,这是由于 ReservedCodeCacheSize 参数的增加的缺省值引起的。此内存区域与 Java 类的实时编译相关,由于第三方产品需要更多代码高速缓存空间,因此 JVM 供应端提供了该内存空间。
解决方案
如果增加内存使用引起了您的系统问题,那么在启动代理程序之前,可以通过导出代理程序的概要文件中的以下环境变量来将 ReservedCodeCacheSize 参数的值设置为它之前的值:
要将 IBM Integration Explorer 连接至队列管理器以接收发布,该队列管理器的 SVRCONN 通道上的 SHARECNV 属性的值必须大于 0。 如果希望使用 IBM Integration Explorer 中的“统计信息”视图或“统计信息图”视图,那么该值是必需的。
症状:
将资源导入到新工作空间中时,自动构建完成后可能会显示错误消息。
解决方案:
在“应用程序开发”视图中,选择项目并右键单击项目 > 清理以重建项目。清理项目后,与导入有关的错误消息会被除去。
mqsicreatebar
指定新的工作空间可能需要进行项目清理症状:
运行 mqsicreatebar
命令并指定新工作空间时,可能会显示错误消息。
解决方案:
运行 mqsicreatebar
命令以清除项目时,请使用 -cleanBuild
选项。
症状:
如果在工作空间中具有多个应用程序或库,这些应用程序或库需要具有相同名称的 Java、PHP 或“消息集”项目,那么将显示类似以下内容的错误消息:
项目 < 项目名称 > 不能是多个应用程序或库的成员。
解决方案:
要在多个应用程序或库中使用项目,那么请将该项目转换到库,然后从需要使用该项目的应用程序或库引用该项目。
症状:
在 Linux 上启动 IBM Integration Toolkit 后的很短时间内,IBM Integration Toolkit 崩溃,并显示以下错误:
JVM terminated - Exit code=160
解决方案:
安装与 Eclipse 3.6 兼容的 XULRunner 版本。
兼容的 XULRunner 版本为版本 1.8-3.6 以及关联的修订包。
已使用以下版本的 XULRunner 在 IBM 中完成测试,并且已确定该版本可以解决此问题:
http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.2.19/runtimes/xulrunner-1.9.2.19.en-US.linux-i686.tar.bz2
将下载的压缩文件在本地目录(例如,/usr/lib/xulrunner_new)中展开
将以下行添加到 mb 安装目录下的 eclipse.ini 文件中:
-Dorg.eclipse.swt.browser.XULRunnerPath=<location of unzipped download>(例如 -Dorg.eclipse.swt.browser.XULRunnerPath=/usr/lib/xulrunner_new)
症状:
使用 WebSphere ESB 转换工具来转换通过使用服务集成模板或操作映射模板创建的中介流,并且该中介流中包含单向操作,生成的子流的名称以 Request_Response 结束,而不是以 Request 结束。 WebSphere ESB 转换工具会显示转换消息(用于声明已转换响应流),但单向操作没有响应流。
解决方案:
忽略该转换消息。
问题:
如果具有两个独立的库,它们具有相同的在 ESQL 软件包中定义的名称空间前缀,并且您尝试将这两个库都部署到缺省应用程序,那么其中一个库的部署将失败。
例如:
Library 1 : MyDBLibrary
ESQL file : MyFlow_GetCustomerInfo.esql
PATH MyDBService.CUSTOMERGroup;
DECLARE ns NAMESPACE 'http://MyDBService';
Library 2: MyTestDBLibrary
ESQL file: MyFlow_Compute.esql
PATH DatabaseService.CUSTOMER_Table_Operations;
DECLARE ns NAMESPACE 'http://DatabaseService';
会导致以下错误:
BIP4128E: 未能部署“MyTestDBLibrary.mqsiLibrary\MyFlow_Compute.esql”中包含的叫做“#NS”的 ESQL“declare”,因为它已在文件“MyDBLibrary.mqsiLibrary\MyFlow_GetCustomerInfo.esql”中进行部署? ESQL 组件已在其他 ESQL 文件中进行部署。
解决方案:
ESQL 需要在 ESQL 软件包中定义唯一名称空间前缀。请确保仅在一个 ESQL 文件中声明了每个 ESQL 模块、例程或声明语句。 在其中一个库中更改名称空间前缀,从而使其在部署上下文中变得唯一。
在 z/OS 上使用 IBM Integration Bus 时,不能使用用于“基于 Web 的静态端点”模式的 Web 用户界面来上载 WSDL 文件。
问题:
Web 用户界面未能显示统计信息或管理更改。
启动 IBM Integration Bus 时,将发生以下错误:
BIP2112E: 消息代理内部错误:诊断信息“2”,“2033”。
解决方案:
将 PTF 应用于 WebSphere MQ APAR PM90120。
症状:
在执行 WebSphere Adapter for SAP Software 企业元数据发现 (EMD) 迭代式发现期间,将显示并可编辑“适配器连接”向导的服务生成和部署配置面板,但您输入的所有适配器系统连接信息不会保存在适配器组件中。
解决方案:
使用 WebSphere Adapter 编辑器更改适配器系统连接信息,以确保后续 EMD 迭代发现保留适配器系统连接信息:
症状:
如果在适配器向导中选定了确认提交复选框,那么 JDE 入站适配器部署将失败。将发出如下错误:
尝试设置适配器组件“AssuredDeliveryMSApp.IBM WebSphere Adapter for JD Edwards EnterpriseOne”上的属性“AssuredOnceDelivery”失败,因为不支持该属性。
解决方案:
当前不支持此功能,且不应该在消息流开发中使用此功能。
症状:构建包含“数据库例程转换”的图形数据映射时,如果“数据库例程转换”使用 IBM DB2 以外的数据库服务器中发现的数据库模型(.dbm 文件),那么“图形数据映射”编辑器会阻止选择完成。编辑器会显示以下说明消息:“此发行版中不支持所选例程”。
解决方案:当前从“图形数据映射”只能调用 IBM DB2 存储过程。
症状:
在使用 Z shell (zsh) 作为 shell 环境的 UNIX 系统中,调用 'source {install path}/mqsiprofile' 会导致 shell 退出。由于 zsh 的缺省行为,mqsiprofile 命令会检查不正确的参数号以确定它作为源还是直接运行。然后 mqsiprofile 脚本会显示一条警告消息并调用出口,但是 zsh 会将此调用解释为退出当前 shell 的指令。
解决方案:
要绕过此问题,请完成以下步骤:
使用 z/OS 上的用户数据库的客户需要 DB2 APAR PK99362。
在除 HP-UX on Itanium 和 z/OS 以外的所有 IBM Integration Bus 支持的平台上的 DB2 和 Oracle(Oracle RAC 除外)均支持 JDBC/XA 全局协调(“XA”)事务。
不能在同一个代理上同时包含 ODBC XA 和 JDBC/XA。
不支持 Informix 全局协调 ('XA') 事务。
代理程序配置为将 XA 与 WebSphere MQ 7.5 队列管理器配合使用作为事务管理器时,将恰当切换文件包含到
<MQ_DATA_PATH>/exits 和/或 <MQ_DATA_PATH>/exits64 目录中。不要使用切换文件的安装特定 exits 和 exits64 子目录。
症状:
使用 IBM Integration Bus v9.0,可以通过将 BPM 集成服务定义导入 IBM Integration Bus 来与 BPM 集成,从而生成 IBM Integration Bus 集成服务。.twx 文件是导出的 BPM Toolkit 快照,用于将 BPM 集成服务定义转换为 IBM Integration Bus。BPM Toolkit 必须包含具有定义的输入和输出变量的 BPM 集成服务,并可以包含对其他包含关联的业务对象的 BPM Toolkit 的引用。
BPM Toolkit 可以引用引用了其他 BPM Toolkit 的从属 BPM Toolkit。但是,从 .twx 文件创建 IBM Integration Bus v9.0 集成服务时,BPM 集成服务和业务对象之间只能存在一个级别的 BPM Toolkit 抽象。
解决方案:
将 BPM 与 IBM Integration Bus v9.0 集成时,请确保包含 BPM 集成服务的 BPM Toolkit 不包含对引用了其他 BPM Toolkit 的 BPM Toolkit 的引用。
http://www.ibm.com/legal/copytrade.shtml
本信息是为在美国提供的产品和服务编写的。
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 在美国和/或其他国家或地区的商标:
DB2、developerWorks、IBM、Informix、Passport Advantage、WebSphere 和 z/OS。
Java 和所有基于 Java 的商标和徽标是 Oracle 和/或其子公司在美国和/或其他国家或地区的商标或注册商标。
Microsoft 和 Windows 是 Microsoft Corporation 在美国和/或其他国家或地区的商标。
UNIX 是 The Open Group 在美国和其他国家或地区的注册商标。
Linux 是 Linus Torvalds 在美国和/或其他国家或地区的商标。
其他公司、产品或服务名称可能是其他公司的商标或服务标记。
IBM Integration Bus 产品页面
http://www.ibm.com/software/products/us/en/integration-bus/
DB2 修订包
如果您有当前支持合同,可以致电 DB2 支持来订购 DB2 修订包。或者,您也可以从 Web 下载 DB2 修订包,但是,有些修订包文件可能很大,因此购买 CD 版本可避免长时间的下载。
DB2 支持的联系详细信息和 DB2 修订包下载可以从以下网址获取:
http://www.ibm.com/software/data/db2/udb/support.html
WebSphere MQ 修订包
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_MQ
IBM Integration Bus 修订包
http://www.ibm.com/support/docview.wss?uid=swg27006041
IBM Integration Bus 需求
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
IBM Integration Bus 发行说明文件
http://www.ibm.com/support/docview.wss?uid=swg27006917
IBM Integration Bus v9.0 独立信息中心
对于 Linux:
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/V9.0/ib_help_linux.tgz
对于 Windows:
ftp://public.dhe.ibm.com/software/integration/integrationbus/docs/V9.0/ib_help_win.zip
IBM Integration Bus v9.0 联机信息中心
http://pic.dhe.ibm.com/infocenter/wmbhelp/v9r0m0/index.jsp
IBM Java™ 技术开发中心下载
http://www.ibm.com/developerworks/java/jdk/
Web 服务描述语言 (WSDL) 规范
http://www.w3.org/TR/wsdl
IBM Integration Bus developerWorks Zone
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html