自述文件

IBM(R) WebSphere(R) Commerce
专业版
商务版
Solaris Operating Environment(TM) software 版

版本 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. 安装期间出现很多警告消息。要防止出现这些消息，请在添加 WebSphere Commerce docs 软件包之前执行以下操作：
    1. 单击属性菜单。
    2. 单击软件包管理菜单
    3. “现有的文件”的缺省选项应当是“询问”。将其更改为“覆盖”。
    4. 单击确定
    5. 继续到添加 docs 软件包。

  2. 对于没有为 /opt 和 /export/home 分配文件系统的机器，wc54sunpreq.sh 脚本返回以下错误：

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

    在 /opt 和 /export/home 之间将需要总共 5 GB 的可用空间。

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

  3. 当运行用于启动配置管理器的脚本时，可能会出现一条错误消息，指出：“whoami not found”。请确保 root 和 wasuser 的 .profile 中存在以下两行：

    PATH=$PATH:/usr/ucb
    export PATH

    再次运行脚本启动配置管理器。

  4. 要作为 non-root 用户启动 WebSphere Application Server（WAS），/tmp 目录的文件许可权必须设置为 777，因为 WAS 将写到此目录。
     
  5. 当运行 wcpostinstall.sh 时，如果选择现有用户标识而非缺省标识来运行 WebSphere Application Server，则该用户标识的缺省主目录必须是 /export/home/userID。如果选择创建新的用户标识，则该用户标识的主目录将由脚本正确创建。
     
  6. WebSphere Commerce 支持以下代码集：
    语言 LANG 变量值
    德语 de_DE.ISO8859-1
    英语 en_US.ISO8859-1
    西班牙语 es_ES.ISO8859-1
    法语 fr_FR.ISO8859-1
    意大利语 it_IT.ISO8859-1
    巴西葡萄牙语 pt_BR.ISO8859-1
    日语 ja_JP.eucJP
    韩国语 ko_KR.EUC
    简体中文 zh_CN.GBK
    繁体中文 zh_TW.BIG5

    请确保 Solaris 机器上安装了您的语言环境支持的代码集。要检查已安装的代码集，请运行 locale -a。
    请确保已设置任何与语言环境相关的环境变量（LANG、LC_ALL），使其包含 WebSphere Commerce 支持的语言环境。要对此进行检查，请运行 locale，并检查 LANG 和 LC_ALL 变量。如果您的语言环境没有设置为支持的代码集，请作为 root 用户运行以下命令来更改语言环境属性：

    LANG=xx_XX.XXXX
    export LANG
    LC_ALL=xx_XX.XXXX
    export LC_ALL

    例如：
    LANG=en_US.ISO8859-1
    export LANG
    LC_ALL=en_US.ISO8559-1
    export LC_ALL

    在运行 wcpostinstall.sh 之前，必须确保已作为 root 用户正确设置这些值。对于 non-root 用户的配置，在运行 wcpostinstall.sh 之后，必须编辑 /export/home/wasuser/.profile 文件。在 .profile 文件中，LANG 值应当设置为支持的代码集。添加代码集扩展名。例如：从 LANG=en_US 更改为 LANG=en_US.ISO8559-1。
     

  7. 在“实例创建”向导中，数据库管理员主目录字段是必填的。如果没有填写，则实例创建会失败。
     
  8. 先决条件检查脚本（wc54sunpreq.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. 如果您正在 Sun Solaris 机器上安装 WebSphere Application Server 高级单服务器版，则需要将 converter.properties 文件中的 GB2312 键更改为 GBK，以避免出现乱码页面。converter.properties 文件位于以下目录中：WebSphere/AppServer/properties。 

已定制代码的部署

作为对新企业 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』。

商店发布

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

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

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

Catalog Manager 和装入程序

  1. 文本转换程序和 XSL 编辑器不能启动联机帮助。这些工具不启动帮助，错误消息引用 .hlp 文件。文本转换程序的 Web 页面位于 opt/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.

自述文件结束