自述文件


IBM(R) WebSphere(R) Commerce
专业版
商务版
AIX(R) 版

版本 5.4


最后更新:2002 年 4 月 15 日

目录


本自述文件包含的内容

本自述文件包含关于此产品的已知问题的信息。本自述文件的更新将发布到 WebSphere Commerce 商务版的 Technical Library 页面和 WebSphere Commerce 专业版的 Technical Library 页面。您也可以检查 WebSphere Commerce 商务版的 Support 页面和 WebSphere Commerce 专业版的 Support 页面上的 Technotes 库,以获取报告出的问题以及其它产品支持信息。


文档

  1. WebSphere Commerce 商务版的 Technical Library 页面和 WebSphere Commerce 专业版的 Technical Library 页面包含已对联机帮助和《安装指南》所做的所有更新。还提供了未随 CD 附带的其它产品信息。
     
  2. 如果您在所配置的区域设置不是 en_US 的机器上使用 WebSphere Commerce 联机帮助搜索功能,可能会遇到诸如无法正确显示本地字符,或没有搜索结果的问题。升级 Java(TM) Runtime Environment 可以更正此问题。要获取更新一些的版本,请转至 java.sun.com 并搜索 Java 2 Runtime Environment。升级 Java Runtime Environment 后,必须在重新启动联机帮助前关闭所有 Internet Explorer 窗口。

安装

  1. 安装 Commerce.Docs 时,会看到系统替换现有帮助文件的警告消息。这些消息只是信息性的消息,可以忽略。

  2. 对于没有为 /usr/home 分配文件系统的机器,wc54aixpreq.sh 脚本返回以下错误:

    FREE HARD DRIVE SPACE in 1K blocks:
    No /usr directory detected  FAIL
    No /home directory detected  FAIL

    /usr/home 之间将需要总共 5 GB 的可用空间。

    注意,无论您是否具有 5 GB 的可用空间,错误消息都会出现。只要您有 5 GB 的可用空间,即可以忽略该消息。

  3. 要作为 non-root 用户启动 WebSphere Application Server(WAS),/tmp 目录的文件许可权必须设置为 777,因为 WAS 将写到此目录。
     
  4. 当运行 wcpostinstall.sh 时,如果选择现有用户标识而非缺省标识来运行 WebSphere Application Server,则该用户标识的缺省主目录必须是 /home/userID。如果选择创建新的用户标识,则该用户标识的主目录将由脚本正确创建。
     
  5. 在“实例创建”向导中,数据库管理员主目录字段是必填的。如果没有填写,则实例创建会失败。
     
  6. 先决条件检查脚本(wc54aixpreq.sh)将无法找到 WebSphere Application Server 电子修订包 PMR60732。要验证系统上是否装有此电子修订包,请检查文件 <WASDIR>/java/jre/lib/extfix/PMR60732.jar 是否存在,其中 WASDIR 是 WebSphere 安装目录。 
     
  7. 先决条件检查脚本(wc54aixpreq.sh)将无法找到 WebSphere Application Server 电子修订包 PQ57446,因为该电子修订包已经被 PQ58443 替换。要验证系统上是否装有此电子修订包,请检查 WebSphere Application Server 的 product.xml 以确定是否安装了它。提供的 WebSphere Application Server 电子修订包安装程序应当正确安装以上两个电子修订包;您可以检查位于 <WC>/logs/tmp 目录中的日志文件 wc54efixunix.log

WebSphere Application Server

  1. 在日语环境中,WebSphere Application Server 4.0 修订包 2 需要有电子修订包 PQ57024。当应用修订包后,请安装提供的电子修订包 PQ57024 以更正日语翻译的相关问题。可从以下 Web 站点下载该电子修订包:

    WebSphere Application Server Support

    关于由该电子修订包所更正问题的详细信息,请参阅与该电子修订包封装在一起的自述文件。
     
  2. 如果吞吐量不足,请检查已准备好的语句高速缓存设置。您可能希望调整高速缓存大小。调整 WebSphere Application Server 已准备好的语句高速缓存的大小时,经验性的规则如下:

    数据库连接最大数目 * 100

    这意味着每个数据库连接的语句高速缓存大小为 100。对于任何调整参数,此值应当基于应用程序和系统开销进行调整。


  3.  
  4. 当启用 WebSphere 安全性时,稍后将发生 java OutofMemory 故障,因为内存已分配但从未释放。要修正此问题,顾客需要应用 WAS 电子修订包 PQ59010。可从以下 Web 站点下载该电子修订包:

    WebSphere Application Server Support

已定制代码的部署

作为对新企业 bean 和修改过的 WebSphere Commerce 公共实体 bean 部署的一部分,必须生成一个 XML 文件来描述 WebSphere Commerce 企业应用程序中的每个 bean。此文件是通过使用带有“export”选项的 XMLConfig 工具而创建的。

此 XML 文件中每个企业 bean 的应用程序服务器全名的指定中不能包含换行符。应用此回避措施确保了该 XML 文件中的应用程序服务器全名格式正确(即,没有换行符)。

完成《WebSphere Commerce 程序员指南》中描述的以下任何任务后,必须执行该回避措施。

每个上述任务都使用 XMLConfig -export 命令来创建一个 XML 文件,该文件为企业应用程序中的企业 bean 提供配置信息。此文件的格式不正确。特别是应用程序服务器的名称分割为几行。如果没有将其重新格式化,使其只在一行上,则当该文件用作 XMLConfig -import 命令的输入时,会出现错误指出找不到应用程序服务器。

要正确格式化由 XMLConfig -export 命令生成的 XML 文件,请执行以下操作:

  1. 使用文本编辑器打开 OutputFile.xml,其中 OutputFile 是由 XMLConfig -export 命令所生成文件的名称。
  2. 对于 <application-server-full-name></application-server-full-name> 标记之间包含的每个值,请确保该值中没有换行符。如果此值中存在换行符,请将其删除以使应用程序服务器名称在一行中指定。
  3. 保存文件。
  4. 如《WebSphere Commerce 程序员指南》中所述,继续执行代码部署的后续步骤。

命令

任何重定向到另一个 HTTP 请求(例如重定向到 JavaServer Page)的命令,如果其响应属性对象大小大于 4KB,则会生成错误。要避免此错误,您必须在重定向之前修改该响应属性对象,使其包含的数据少于 4KB。减小响应属性对象大小的一种方法是从 URL 字符串中除去不必要的参数。关于此操作的信息,请参阅《WebSphere Commerce 程序员指南》中的『处理有限长度的重定向 URL』。


集成

WebSphere Commerce 无法将 Domino 作为 LDAP 服务器与 IBM Developer Kit AIX 版,Java2 技术版 v1.3 一起使用,后者是作为 WebSphere Application Server 当前版本的一部分提供的。请检查 WebSphere Commerce 商务版的 Support 页面和 WebSphere Commerce 专业版的 Support 页面以获取更新。


商店发布

为确保商店发布失败时能够正确处理错误,需要以下 java 系统属性。

请使用 WebSphere Application Server 管理控制台添加此属性:

  1. 打开 WebSphere Application Server 管理控制台。
  2. 展开节点
  3. 展开 your_node
  4. 展开应用程序服务器
  5. 单击 instance_name
  6. 单击 JVM 设置,并添加以下内容:
    com.ibm.wcm.ErrorReporterDir = /usr/WebSphere/CommerceServer/temp/instance_name/tools/devtools
  7. 单击应用,然后重新启动实例。

Catalog Manager 和装入程序

  1. 文本转换程序和 XSL 编辑器不能启动联机帮助。这些工具不启动帮助,错误消息引用 .hlp 文件。文本转换程序的 Web 页面位于 usr/WebSphere/CommerceServer/web/doc/locale/f1_fs/fdpttt.htm 文件中。对于 XSL 编辑器,请参阅相同目录中名为 fdpxtt.htm 的文件。

  2. 装入程序在提交失败时不可以回滚记录。如果发生此情况,您可在数据库中手工删除记录。还可在 Load 命令上指定 -method delete 选项以从数据库中删除记录。装入程序的输入文件必须包含在使用此选项时需要删除的记录。关于更多信息,请参阅《Catalog Manager 用户指南》。


商标和服务标记

以下是 IBM 公司在美国和其它国家或地区的商标或注册商标:
IBM      WebSphere    AIX

Java 和所有基于 Java 的商标是 Sun Microsystems, Inc. 在美国和/或其它国家或地区的商标。

Windows 和 Windows NT 是 Microsoft Corporation 在美国和/或其它国家或地区的商标。

其它公司、产品或服务名称可能是其它公司的商标或服务标记。

**************************************************************************

** COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 2002

** ALL RIGHTS RESERVED.

**************************************************************************
Note to US Government Users -- Documentation related to restricted rights -- Use, duplication, or disclosure is subject to restriction set forth in GSA ADP Schedule Contract with IBM Corp.

自述文件结束