IBM WebSphere Business Integration Server Express V4.3.1 for Linux 发行说明

这些发行说明覆盖了 IBM(R) WebSphere(R) Business Integration Server Express V4.3.1 for Linux(R) 的发行信息。它们包含以下各节:
概述 卸载信息
硬件和软件需求 已知问题和变通方法
安装和配置信息 文档

注意:关于此产品的重要信息可以在发布这些发行说明之后公布的技术支持 Flash 中获得。这些可以在 WebSphere Business Integration 支持 Web 站点上找到,http://www.ibm.com/software/integration/wbiserverexpress/support。选择感兴趣的组件区域并搜索 flash 部分。

概述

IBM WebSphere Business Integration Server Express 和 IBM WebSphere Business Integration Server Express Plus 包含下列组件:

除了 Windows(R) 2000 上的现有支持之外,此发行版在下列操作系统上添加了对 InterChange Server Express 的支持:

硬件和软件需求

硬件和软件需求包括在产品文档中。有关指向这些指南的链接,请参阅安装、迁移、升级和配置信息

安装和配置信息

无论您是从 CD 安装该软件还是从 Passport Advantage 下载它并从本地目录安装它,参阅《WebSphere Business Integration Server Express 安装指南 Linux 版》一书。

注意:如果您将技术适配器和应用程序适配器安装在同一机器上,则通过 Server Express Plus 先安装技术适配器,然后通过 Adapter Capacity Pack 安装程序安装每一个应用程序适配器。

已知问题和变通方法

在本发行版中已经发现了下列问题:

组件名 跟踪号 描述
活动编辑器 42343 在活动编辑器中,可以从库窗口里的一系列全局变量中选择以用于定制活动。全局变量可以和 Java 变量一样简单(例如 String 类型)或者和业务对象变量一样复杂(例如 BusObj 类型)。当全局变量用在一个活动中的时候,它的赋值仅仅发生在活动的末尾,所以应避免使用在一个活动中具有相同根变量的不同变量。

但是,可以在不同的操作中执行两个子活动。如果必须使用具有相同根的变量,尝试重用单一的根变量来代替。

适配器 43586 通过 JMS 交付传输运行和使用本地连接器配置(通过 -c 命令行选项指定)的连接器的 AgentTraceLevel 属性仅可在该连接器的生存期内通过系统管理器动态更新一次。对此属性的后续动态更新尝试将失败。类似下列的消息将显示在日志中:

[类型:警告] [消息标识:14211] [消息:不允许动态更新 AgentTraceLevel。在配置文件中,连接器代理的值已经设置并且将使用先前设置的值。]

通过 JMS 交付传输运行和使用本地连接器配置的连接器的 AgentTraceLevel 属性不应通过系统管理器动态更新。如果该属性需要修改,则必须更新连接器配置文件并且重新启动连接器代理。否则,将会遇到刚才描述的错误,连接器控制器设置与连接器代理设置之间也可能发生不匹配。
JDBC 适配器 43503 当使用 ODA 从运行于 Linux 上的 DB2 数据库服务器生成业务对象时,业务对象设计器将会挂起。发生此问题是因为 DB2 JDBC Applet Server 没有启动。

要解决此问题,登录到 DB2 服务器,并运行下列命令:db2jstrt LISTENPORT。

JDBC 适配器和 Oracle 应用程序适配器 43246 OracleAppsODA 的启动脚本在 DRIVEPATH 中包括 xworacle.jar 文件,它没有按预期在 Oracle 数据库中列出所有的表。如果要在数据库中列出所有的表,可以使用 Oracle 提供的本机 JDBC 驱动程序 - classes12.zip 文件来解决此问题。根据适配器用户指南中的指示信息在启动脚本中相应地设置驱动程序路径。
JMS 适配器和 WebSphere MQ 适配器 37094 在处理来自其中一个多配置的输入队列中的一条不确定消息(来自 InProgressQueue)时,该适配器会根据特定于连接器的属性中的第一个输入队列来检索转换属性。
JMS 适配器 36438 配置元对象的特定于应用程序信息中的转换属性名称和动态元对象的名称是区分大小写的。
JMS 适配器 36128 当 InputQueue 属性没有配置的时候,适配器初始化失败。
JMS 适配器和 WebSphere MQ 适配器 34323 JMS 和 WebSphere MQ 适配器的样本是设计来提供适配器在 WebSphere InterChange Server Express 环境中的配置和使用的。使用这些样本的指示信息提供在技术说明中,它描述了如何在 WebSphere Business Integration Server Express 环境中使用这些样本来发送和接收业务对象。

JMS 适配器的技术说明可在以下位置找到:
http://www-1.ibm.com/support/docview.wss?rs=0&q1=JMS+adapter&uid=swg21174512&loc=en_US&cs=utf-8&cc=us&lang=en
WebSphere MQ 适配器的技术说明可以在以下位置找到:
http://www-1.ibm.com/support/docview.wss?rs=0&q1=WebSphereMQ+adapter&uid=swg21174510&loc=en_US&cs=utf-8&cc=us&lang=en
JMS 适配器和 WebSphere MQ 适配器 33728 在事件处理过程中,当多个转换属性与某个输入消息的 InputFormat 和\或 InputQueue 匹配时,适配器试图不正确地使用静态元对象中的最后一个匹配的业务对象属性作为输入消息的映射。在这种情况下,适配器应将消息内容传递给数据处理程序以允许数据处理程序来决定业务对象名称。

要解决此问题,为静态元对象中的每一个 BusinessObjectType_verb 属性配置唯一的 InputFormat 和 InputQueue 键。

JText 适配器 46499 如果与 MVS PDS 中的事件掩码匹配的文件多于一个,并且指定了 FTPRenameExt,则连接器仅归档一个文件且不能对第二个文件重命名和归档。要解决此问题,同时将 FTPArchiveDir 和 FTPRenameExt 指定为空白,以便在 MVS 事件文件不被重命名的情况下被删除。
JText 适配器 43454 当 JText 配置元对象 MO_JTextConnector_Default 的 EventExt 属性设置为空白时轮询 JText 适配器,轮询会失败并且适配器终止。
JText 适配器 35571 需要一个规定在二进制处理方式中指定“EOF”作为 EndBODelimiter 的值。
要解决此问题,对于 EndBODelimiter 正是 EOF 本身的所有文件,使用十六进制编辑器来包括几个字节(例如 FF02)作为定界符,并指定这些字节为 EndBODelimiter。
JText 适配器 34834 JText 需要安全的 FTP 支持。目前对 JText 系统管理员可见的密码字段,使用安全 FTP 则任何人都不可见。
WebSphere Commerce 适配器 42516 在商业服务器上使用带有修订包 4 的 WebSphere Commerce Business Edition V5.5(或更早版本)时,无法使用 WebSphere Commerce 适配器正确创建仓库用户。因为不正确的权限,仓库用户无法登录到仓库。需要 Websphere Commerce 电子修订来修正此问题。电子修订是带有修订包 4 的 WebSphere Commerce 5.5 上的 JR20090。
WebSphere MQ 适配器 34969 在同步事件处理期间,没有为数据处理程序错误发送报告消息。
Windows 上的 DB2(R) 企业版 35380 当 Windows 重新启动时,DB2 企业版不会重新启动数据库管理器。因为没有运行数据库管理器,如果在 WebSphere Business Integration Server Express 或 Express Plus 的安装过程中 Windows 重新启动,可能会发生两个问题:
  • 库创建可能失败。当这个发生时,安装程序日志包含下列消息行:
    没有发出启动数据库管理器命令。
  • InterChange Server Express 的启动可能失败,因为没有运行数据库管理器,InterChange Server Express 无法连接至 SMB_DB。当这个发生时,InterchangeSystem 日志文件消息包含下列行:
    没有发出启动数据库管理器命令。

可以采取以下步骤来解决这两个问题:

  1. 打开 DB2 控制中心。
  2. 展开所有编目的系统文件夹,然后展开对应于您的主机的那个文件夹,然后再展开实例文件夹。
  3. 实例文件夹里,右击 DB2 图标,然后单击启动
    显示下列 DB2 消息:
    DB2START 处理成功。

在执行完这些步骤后,可以创建库并成功启动 InterChange Server Express。

Windows 上的 DB2 企业版和 DB2 精简版的卸载程序 35380 如果 DB2 企业版或 DB2 精简版以及 WebSphere Business Integration Server Express 或 Express Plus 先前已经安装和卸载,则库创建会在 WebSphere Business Integration Server Express 或 Express Plus 的重新安装期间失败。发生此问题是因为 DB2 企业版和 DB2 精简版 的卸载进程没有将数据库的别名从目录 C:\DB2\aliases_directory 中移除。

因此,在 WebSphere Business Integration Server Express 或 Express Plus 的最初安装中创建的、InterChange Server Express 库的名为 SMB_DB 的别名,在 DB2 卸载后保留下来。尽管此别名的存在没有影响到 DB2 企业版或 DB2 精简版的重新安装,当 WebSphere Business Integration Server Express 或 Express Plus 重新安装后,由于系统找到旧的 SMB_DB 别名,库创建会失败。

要解决此问题,在卸载和重新安装 DB2 企业版或 DB2 精简版前手工删除 SMB_DB 数据库。删除实际的数据库会除去它的别名。

文档 44024 《WebSphere Business Integration Server Express 安装指南 Linux 版》
在『使用 Web 服务器时配置系统监视器和失败的事件管理器』一节中,示例命令是不正确的。它应该如下所示:
Home_directory/IBM/WebSphereServer/CWDashboard.sh \
"/opt/IBM/WebSphere/Express502/AppServer" \
hostname.ibm.com "Home_directory/IBM/WebSphereServer" \
"DB2_Installation_Dir/java" y
文档 44025 《WebSphere Business Integration Server Express 安装指南 Linux 版》
在『查看 WebSphere Business Integration Server Express 和 Express Plus 文件及目录』一节中,缺少了一个表条目。除了条目“logs”之外,还应有一个名为“log”的条目,它的描述如下:“此目录包括了几个与产品安装和卸载相关的日志文件,例如 InterChange Server Express
(wbi_server_exp_install_log.txt)、Adapter Capacity Pack(adapterCPInstallLog.txt)和 Collaboration Capacity Pack(collabCPInstallLog.txt)的安装程序日志。”
在『使用 GUI 安装 WebSphere Business Integration Server Express 和 Express Plus』一节中需要更正类似的错误。在安装过程之后第二段中的最后一句应为如下内容:“名为 wbi_server_exp_install_log.txt 的日志文件位于目录 ProductDir/log 中,它详细说明了安装过程。”
文档 44026 《WebSphere Business Integration Server Express 安装指南 Linux 版》 在『使用 GUI 安装 WebSphere Business Integration Server Express 和 Express Plus』一节中,在安装过程之后的项目符号列表里,有一个项目符号内容如下:“将一个名为 LD_ASSUME_KERNEL 的新系统变量添加到 /etc/profile 文件并将其值设为 2.4.19。” 安装程序仅在 Red Hat Linux 系统上创建此系统变量;它不会在 SuSE Linux 系统上创建。
文档 Data Handler Guide 指南为二进制主机数据处理程序不正确地参阅和提供了文档。二进制主机数据处理程序没有包含在产品中。
文档 MetaSolv 适配器的指南应说明 Metasolv 适配器现在支持产品服务请求(PSR)和本地服务请求(LSR)模块。
文档 对所有的指南,“本发行版中的新增内容”一节应为:
除了 Windows 2000 上的现有支持之外,此发行版在下列操作系统上添加了对 InterChange Server Express 的支持:
  • IBM OS/400 V5R2,V5R3
  • Red Hat Enterprise AS Linux 3.0,更新 1
  • 带有 SP3 的 SuSE Linux Enterprise Server 8.1
  • Microsoft Windows 2003
文档 Quick Start Guide 之中,位于“Validating your Linux installation”一章的“Starting InterChange Server Express”一节的第 1 步中的下列路径是不正确的:$cd /home/USER/IBM/WebSphereICS/bin

正确路径是:$cd/home/USER/IBM/WebSphereServer/bin 或 $cd/ProductDir/bin

下面的说明性路径信息也添加到这一节。

说明:在上面所示的脚本中:
“$”是 Linux 命令行提示符
“cd”是用来更改目录的命令
“bin”是产品安装目录中的一个文件夹
安装程序(Adapter Capacity Pack) 44001 当在 Windows 2000 上为 Metasolv 和 JD Edwards OneWorld 适配器执行一个远程的或本地的 Capacity Pack 安装并且试图启动该适配器时,它出错终止:输入行太长。这是因为 Windows 2000 上的命令行长度问题。当执行一个远程的 CP 安装时,您将看到 Siebel 和 Oracle 应用程序的 WebSphere Business Integration 适配器具有相同的问题。此问题的一个变通方法是计划在此发行版后有一个技术说明可用。
安装程序(所有) 46851 在文件传输时,来自资源束的未解析文本可能出现在窗口中。特别地,可能显示以下内容:
$L(com.ibm.wbi.install.common.i18n.WBIProductResources, businessIntegrationServerExpressPlusProduct.
displayName)
应该显示的是:
WebSphere Business Integration Server Express Plus V4.3.1
安装程序(所有) 43593 因为它的长度,标题文本在消息对话框中可能会被截断;然而,预期的消息内容还是显示了。
启动板 43688 IBM WebSphere Application Server V5.0.2.4 for Linux 不能安装在 Red Hat Enterprise Linux AS 3.0 上面。用 IBM WebSphere Application Server - Express V5.1 代替。
启动板 58560 当安装样本组件时,Toolset Express 组件是自动安装的,即使清除了管理工具和开发工具复选框。发生这个是因为启动板 GUI 没有正确刷新以重置复选框。
服务器(样本) 43775 在 \mqseries\RemoteServerSample.mqsc 文件中有一个错误。

在下列表达式中,突出显示的文本是不正确的:
DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE +
XMITQ(TO_AGENT) DESCR('Server to Agent') +
CONNAME('172.16.15.96(1415)')

该表达式应为如下内容(请参阅突出显示文本):
DEFINE CHANNEL(CH_ICS_TO_AGENT) CHLTYPE(SDR) TRPTYPE(TCP) REPLACE +
XMITQ(XMITQ_TO_AGENT) DESCR('Server to Agent') +
CONNAME('172.16.15.96(1415)')

要解决此问题,在安装后修改 \mqseries\RemoteServerSample.mqsc 文件。
系统监视器 43360 如果从创建和配置视图页创建一个超过 20 个监视器的视图,当你选择视图时可能会遇到异常。将一个视图中的监视器数量限制到少于 20。
系统监视器 42481 系统监视器支持在相同的语言环境中运行 Web 应用程序服务器和客户机。如果服务器和客户机处于不同的语言环境中,文本将以两种语言显示。如果不可能使服务器运行在和客户机相同的语言环境中,通过执行以下步骤,将 JVM 上的语言环境设成和客户机相同的语言环境:
  1. 从 WebSphere Application Server,启动 WebSphere Application Server 管理员控制台(对于 Express,必须启用控制台应用程序):
  2. 通过以下路径转至 Java 虚拟机:
    服务器 > 应用程序服务器 > ICSMonitor > 进程定义 > Java 虚拟机
  3. 添加下列自变量到通用 JVM 自变量:
    -Duser.language=language code -Duser.region=country code
    用您自己的特定语言和国家或地区代码替换 language codecountry code
  4. 重新启动 InterChange Server 监视器服务器,并将客户机浏览器设置成在前一步骤中使用的同一语言。
系统监视器 43759 如果在双字节字符语言中使用 Netscape 4.7x,字符可能在 Netscape 中不能显示。要将 Netscape 配置成启用双字节字符集字符显示,遵循这些步骤:
  1. 从 Netscape 中的查看菜单,选择字符集 > Unicode(UTF-8)
  2. 查看菜单,选择字符集 > 设置缺省字符集
  3. 打开编辑菜单并且选择首选项
  4. 首选项窗口,选择外观 > 字体
  5. 编码字段,选择 Unicode
  6. 可变宽度字体字段,选择 Lucida Sans Unicode
  7. 选择使用我的缺省字体,覆盖文档指定的字体
  8. 单击确定
工具 - 活动编辑器 36145 在活动编辑器中,Java(TM) 代码编辑器里的颜色标记不能处理字符串中的引号;然而,这个不会影响到编译。

文档

CD 或电子产品分发未包括产品文档作为产品软件包的一部分。此产品的文档可从 IBM WebSphere Business Integration Server Express InfoCenter 中找到。

下列文档可从那个 Web 站点上找到:

Map Development Guide
Business Object Development Guide
Collaboration Development Guide
Data Handler Guide
Access Development Guide
《WebSphere Business Integration Server Express 安装指南 Windows 版》
《WebSphere Business Integration Server Express 安装指南 Linux 版》
《WebSphere Business Integration Server Express 安装指南 OS/400 版》
Quick Start Guide
System Implementation Guide
System Administration Guide
Adapter for COM User Guide
Adapter for e-Mail User Guide
Adapter for Exchange User Guide
Adapter for iSeries User Guide
Adapter for JD Edwards OneWorld User Guide
Adapter for JDBC User Guide
Adapter for JMS User Guide
Adapter for JText User Guide
Adapter for Lotus Domino User Guide
Adapter for MetaSolv Applications User Guide
Adapter for mySAP.com (SAP R/3 V. 4.x) User Guide
Adapter for Oracle Applications User Guide
Adapter for PeopleSoft User Guide
Adapter for Portal Infranet User Guide
Adapter for Siebel eBusiness Applications User Guide
Adapter for SWIFT User Guide
Adapter for Telcordia User Guide
Adapter for Web Services User Guide
Adapter for WebSphere Commerce User Guide
Adapter for WebSphere MQ User Guide
Adapter for XML User Guide

Collaborations for Customer Relationship Management
Collaborations for Procurement
Collaborations for Financials and Human Resources
Collaborations for Order Management

Copyright IBM Corp. 2004