WebSphere Product Center:安装指南

 

版本 5.2

 

 

 

 

 

 


注意!在使用本资料及其支持的产品之前,请阅读本文档末尾处的『声明』中的信息。

2005 年 3 月 23 日

本文档的此版本适用于 WebSphere Product Center(5724-I68)V5.2 及所有后续发行版和修订版,直到在新版本中另有声明为止。

Copyright International Business Machines Corporations 2001, 2005. All rights reserved.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

目录

第 1 章 - 简介

   读者
   文档结构
   相关文档
   印刷约定

第 2 章 - 概述

    体系结构
    信息流和 HA 配置

第 3 章 - 安装需求

    安装需求
        AIX 需求
        Linux 需求
        HP-UX 需求
        Solaris 需求
        对 WebSphere Product Center 进行客户机访问时的需求
        小组需求

第 4 章 数据库设置和配置

    DB2 设置和配置
    Oracle 设置和配置

第 5 章 WebSphere Product Center 安装

    满足先决条件
    准备安装介质
    使用安装介质的一般过程 
    安装 WebSphere Product Center
    设置环境变量
    配置运行时属性
    应用程序服务器配置
    设置数据库模式
    设置要测试的公司
    测试安装
    创建新公司

第 6 章 - 卸载 WebSphere Product Center 

    调用图形卸载程序
    使用图形卸载程序
    执行静默卸载

第 7 章 - 管理 WebSphere Product Center 服务

    服务类型 

第 8 章 启用外部功能

LDAP 集成
拼写检查程序启用

附录 A - 配置参考 

    文件名:common.properties 
    文件名:admin_properties.xml 
    文件名:docstore_mount.xml 
    文件名:data_entry_properties.xml 

声明 

第 1 章 - 简介


读者

本文档供规划、安装、部署和管理 WebSphere Product Center 的顾问、开发者和系统管理员阅读。


文档结构

标题 描述
1 简介 文档简介
2 概述 体系结构和功能部件简要概述
3 安装需求 多个平台的安装需求
4 数据库配置和设置 使用 WebSphere Product Center 时需要进行的配置和设置
5 安装 WebSphere Product Center 安装 WebSphere Product Center 的步骤
6 卸载 WebSphere Product Center WebSphere Product Center 的卸载指示信息
7 管理 WebSphere Product Center WebSphere Product Center 的管理
8 启用外部功能 启用拼写检查程序或 LDAP 集成
附录 A 配置参考 配置属性列表

相关文档

IBM 的因特网站点
(http://www-306.ibm.com/software/integration/wpc/library/documentation.html)也提供了下列相关的 WebSphere Product Center 文档:


印刷约定

本文档使用了下列约定:

Courier New 表示命令、目录名、用户名、路径名和文件名。

Courier New

表示示例
粗体 表示要在 GUI 中执行的操作

第 2 章 概述

WebSphere Product Center 提供了高度可伸缩的企业“产品信息管理”(PIM)解决方案。“产品信息管理”是一个中间件,它为企业内和企业外的产品或服务信息建立单一、集成并且一致的视图。随着客户转变为全球的随需应变企业,他们需要优良的产品和服务信息来源来满足企业需求,如全球数据同步、电子商务、供应链管理和贸易伙伴管理。

通过使用“产品信息管理”中间件,公司就能够以内部方式和外部方式对商品、位置、组织、贸易伙伴和贸易方式进行管理、链接和同步。使用 WebSphere Product Center 进行的产品信息管理解决方案提供了:

通过使用 WebSphere Product Center 的企业解决方案,公司能够显著加快新产品的市场推广速度、通过与贸易伙伴进行更紧密的协作来提高市场份额以及提高客户满意度并降低成本。


体系结构

WebSphere Product Center 的可伸缩体系结构使您能够方便地在提供了安全性、数据归档和操作冗余的生产环境中实现其功能。图 1 举例说明了两层体系结构,图 2 举例说明了三层体系结构。

 

图 1 - 两层体系结构

图 2 - 三层体系结构

信息流和高可用性配置

信息流的若干组件相互依赖。图 3 提供了客户机、Web/应用程序服务器(安装了 WebSphere Product Center)与数据库之间的安全性和信息流的示例。根据负载需求的不同,调度程序服务可以位于应用程序服务器上,也可以位于单独的服务器上。如果将调度程序放在单独的服务器上,WebSphere Product Center 就可以将调度程序服务与特定 RMI(远程方法调用)端口绑定。

 

图 3 - 信息流

总结

以下列表是图 3 中举例说明的信息流的结果。

第 3 章 安装需求

在安装 IBM WebSphere Product Center 软件之前,确保已满足本章概述的所有必需先决条件。本章中的各节提供了对系统硬件和软件需求、小组需求以及运行 WebSphere Product Center 所需的应用程序服务器/数据库配置的简要概述。

为了获得最佳的性能,建议您在专用系统上运行 WebSphere Product Center。系统应该对访问权进行限制以维护安全性。

硬件

提供的硬件需求建议仅供参考。本节列示了 WebSphere Product Center 的最低硬件需求。但是,系统的实际需求可能更高,这取决于您的特定 WebSphere Product Center 环境的复杂性、吞吐量以及数据对象大小。以下信息仅针对 WebSphere Product Center 系统。如果在同一系统上运行其它应用程序,则请进行适当的调整。

其它服务器硬件需求

软件

WebSphere Product Center 的软件需求取决于正在使用产品组件的哪些元素以及是在特定服务器上单独使用还是组合使用。建议您使用专用服务器来安装数据库。

注意:对于捆绑的产品,WebSphere Application Server Network Deployment 5.1.1 和 DB2 II 8.2 高级版提供了受限制的 WebSphere Product Center 使用许可证。

注意:要使用 WebSphere Product Center 中的拼写检查程序功能部件,需要 Wintertree Sentry Spelling Checker Engine Java SDK 5.10。


AIX 需求

本节概述了以下平台的硬件和软件需求:

操作系统 应用程序服务器 数据库服务器
AIX 5L 5.2(32 位和 64 位) WebSphere Application Server Network Deployment 5.1.1 IBM DB2 II 版本 8.2 高级版

或者

Oracle 9.2.0.5 Enterprise Edition

AIX 5L 5.3(32 位和 64 位) WebSphere Application Server Network Deployment 5.1.1 IBM DB2 II 版本 8.2 高级版

AIX 5L 5.2 上的 WebSphere Application Server/DB2

注意:这是用于 WebSphere Product Center 的主要平台

 应用程序服务器
 软件
  • WebSphere Application Server Network Deployment 5.1.1
  • AIX 5L 5.2(32 位和 64 位)
  • IBM HTTP Server 2.0
  • 与 WebSphere Application Server Network Deployment 5.1.1 捆绑在一起的 IBM JDK
硬件
  • 服务器类型 - IBM p630 Model 6C4
  • 处理器 - 4 x 64 位 POWER4+ 1.45 GHz
  • 内存 - 8 GB
  • 磁盘子系统 - 144 GB SCSI
数据库服务器
  软件
  • DB2 II 8.2 高级版
  • AIX 5L 5.2
硬件
  • 服务器类型 - IBM p630 Model 6C4,PE2650
  • 处理器 - 4 x 64 位 POWER4+ 1.45 GHz
  • 内存 - 8 GB
  • 磁盘子系统 - 420 GB SCSI

其它软件

此首选配置还与下列软件捆绑在一起:
  • WebSphere MQ Series V5.3(1)
  • WebSphere Business Integration Adapter for WebSphere MQ V2.5.0(1,2)
  • WebSphere Business Integration Adapter Framework V2.4.0(1,2)

(1)WebSphere Product Center 附带提供了一个受限制的使用许可证

(2)当与处理集线器集成时的必需产品 

AIX 5L 5.2 上的 WebSphere Application Server/Oracle

 应用程序服务器
 软件
  • WebSphere Application Server Network Deployment 5.1.1
  • AIX 5L 5.2
  • IBM HTTP Server 2.0
  • 与 WebSphere Application Server Network Deployment 5.1.1 捆绑在一起的 IBM JDK
硬件
  • 服务器类型 - IBM p630 Model 6C4
  • 处理器 - 4 x 64 位 POWER4+ 1.45 GHz
  • 内存 - 8 GB
  • 磁盘子系统 - 144 GB SCSI
数据库服务器
  软件
  • Oracle 9.2.0.5 Enterprise Edition
  • AIX 5L 5.2
硬件
  • 服务器类型:与 Intel 兼容
  • 处理器:双 Intel,XEON 2.8 GHz
  • 内存:6 GB
  • 磁盘子系统:365 GB 10K RPM SCSI 驱动程序

AIX 5L 5.3 上的 WebSphere Application Server/DB2

 应用程序服务器
 软件
  • WebSphere Application Server Network Deployment 5.1.1
  • AIX 5L 5.2(32 位和 64 位)
  • IBM HTTP Server 2.0
  • 与 WebSphere Application Server Network Deployment 5.1.1 捆绑在一起的 IBM JDK
硬件
  • 服务器类型 - IBM p630 Model 6C4
  • 处理器 - 4 x 64 位 POWER4+ 1.45 GHz
  • 内存 - 8 GB
  • 磁盘子系统 - 144 GB SCSI
数据库服务器
  软件
  • DB2 II 8.2 高级版
  • AIX 5L 5.2
硬件
  • 服务器类型 - IBM p630 Model 6C4,PE2650
  • 处理器 - 4 x 64 位 POWER4+ 1.45 GHz
  • 内存 - 8 GB
  • 磁盘子系统 - 420 GB SCSI

Linux 需求

操作系统 应用程序服务器 数据库服务器
Red Hat Enterprise Linux AS 3.0 Update 3 WebLogic Server 8.1 Service Pack 2 Oracle 9.2.0.5 Enterprise Edition
Red Hat Enterprise Linux AS 3.0 Update 3 WebSphere Application Server Network Deployment 5.1.1 IBM DB2 II 版本 8.2 高级版

或者

Oracle 9.2.0.5 Enterprise Edition

Linux 上的 WebLogic/Oracle

 应用程序服务器
 软件
  • WebLogic Server 8.1 Service Pack 2
  • Apache HTTP Server 2.0
  • Red Hat Enterprise Linux AS 3.0 Update 3
  • 与 WebLogic Server 8.1 Service Pack 2 捆绑在一起的 WebLogic JDK
硬件
  • 服务器类型:与 Intel 兼容
  • 处理器:双 Intel,XEON 2.8 GHz
  • 内存:6 GB
  • 磁盘子系统:365 GB 10K RPM SCSI 驱动程序
数据库服务器
  软件
  • Oracle 9.2.0.5 Enterprise Edition
  • Red Hat Enterprise Linux AS 3.0 Update 3
硬件
  • 服务器类型:与 Intel 兼容
  • 处理器:双 Intel,XEON 2.8 GHz
  • 内存:6 GB
  • 磁盘子系统:365 GB 10K RPM SCSI 驱动程序

Linux 上的 WebSphere Application Server/DB2

 应用程序服务器
 软件
  • WebSphere Application Server Network Deployment 5.1.1
  • IBM HTTP Server 2.0
  • Red Hat Enterprise Linux AS 3.0 Update 3
  • 与 WebSphere Application Server Network Deployment 捆绑在一起的 IBM JDK
硬件
  • 服务器类型:与 Intel 兼容
  • 处理器:双 Intel,XEON 2.8 GHz
  • 内存:6 GB
  • 磁盘子系统:365 GB 10K RPM SCSI 驱动程序
数据库服务器
  软件
  • DB2 II 8.2 高级版
  • Red Hat Enterprise Linux AS 3.0 Update 3
硬件
  • 服务器类型:与 Intel 兼容
  • 处理器:双 Intel,XEON 2.8 GHz
  • 内存:6 GB
  • 磁盘子系统:365 GB 10K RPM SCSI 驱动程序

Linux 上的 WebSphere Application Server/Oracle

 应用程序服务器
 软件
  • WebSphere Application Server Network Deployment 5.1.1
  • IBM HTTP Server 2.0
  • Red Hat Enterprise Linux AS 3.0 Update 3
  • 与 WebSphere Application Server Network Deployment 5.1.1 捆绑在一起的 IBM JDK
硬件
  • 服务器类型:与 Intel 兼容
  • 处理器:双 Intel,XEON 2.8 GHz
  • 内存:6 GB
  • 磁盘子系统:365 GB 10K RPM SCSI 驱动程序
数据库服务器
  软件
  • Oracle 9.2.0.5 Enterprise Edition
  • Red Hat Enterprise Linux AS 3.0 Update 3
硬件
  • 服务器类型:与 Intel 兼容
  • 处理器:双 Intel,XEON 2.8 GHz
  • 内存:6 GB
  • 磁盘子系统:365 GB 10K RPM SCSI 驱动程序

HP-UX 需求

操作系统 应用程序服务器 数据库服务器
HP UX 11i WebLogic Server  8.1 Service Pack 2 Oracle 9.2.0.5 Enterprise Edition

HP-UX 上的 WebLogic/Oracle

 应用程序服务器
 软件
  • WebLogic Server 8.1 Service Pack 2
  • Apache HTTP Server 2.0
  • HP/UX 11i
  • 与 WebLogic Server 8.1 Service Pack 2 捆绑在一起的 WebLogic JDK 
硬件
  • 服务器类型:HP RP 4440
  • 处理器:双 CPU
  • 内存:4 GB
  • 磁盘子系统:HP MSA 1000
数据库服务器
  软件
  • Oracle 9.2.0.5 Enterprise Edition
  • HP/UX 11i
硬件
  • 服务器类型:HP RP 4440
  • 处理器:双 CPU
  • 内存:4 GB
  • 磁盘子系统:HP MSA 1000

Solaris 需求

操作系统 应用程序服务器 数据库服务器
Solaris 9 WebLogic Server 8.1 Service Pack 2

或者

WebSphere Application Server Network Deployment 5.1.1

Oracle 9.2.0.5 Enterprise Edition

Solaris 上的 WebLogic/Oracle

 应用程序服务器
 软件
  • WebLogic Server 8.1 Service Pack 2
  • Apache HTTP Server 2.0
  • HP/UX 11i
  • 与 WebLogic Server 8.1 Service Pack 2 捆绑在一起的 WebLogic JDK 
硬件
  • 服务器类型:HP RP 4440
  • 处理器:双 CPU
  • 内存:4 GB
  • 磁盘子系统:HP MSA 1000
数据库服务器
  软件
  • Oracle 9.2.0.5 Enterprise Edition
  • HP/UX 11i
硬件
  • 服务器类型:HP RP 4440
  • 处理器:双 CPU
  • 内存:4 GB
  • 磁盘子系统:HP MSA 1000

Solaris 上的 WebSphere Application Server/Oracle

 应用程序服务器
 软件
  • WebSphere Application Server Network Deployment 5.1.1
  • IBM HTTP Server 2.0
  • Solaris 9
  • 与 WebSphere Application Server Network Deployment 5.1.1 捆绑在一起的 IBM JDK
硬件
  • 服务器类型:Sun Enterprise V440
  • 处理器:4 路 UltraSPARC IIIi @ 1.062 GHz
  • 内存:4 GB 
  • 磁盘子系统:Sun StorEdge 3510
数据库服务器
  软件
  • Oracle 9.2.0.5 Enterprise Edition
  • Solaris 9
硬件
  • 服务器类型:Sun Enterprise V440
  • 处理器:4 路 UltraSPARC IIIi @ 1.062 GHz
  • 内存:4 GB 
  • 磁盘子系统:Sun StorEdge 3510 

对 WebSphere Product Center 进行客户机访问时的需求

下面提供对 WebSphere Product Center 进行客户机访问时的最低客户机硬件需求:

客户机需求
软件

Microsoft Windows 2000 Professional Service Pack 3

或者

Microsoft Windows XP Professional Service Pack 1

以及

浏览器:Microsoft Internet Explorer V6.0 Service Pack 1

硬件 处理器:带有 Pentium 3 处理器的基于 Intel 的系统,最低处理器速度为 750 MHz

内存:256 MB


小组需求

安装和维护 WebSphere Product Center 需要下列人员。

第 4 章 数据库设置和配置 


DB2 设置和配置

本节阐述数据库配置指南,数据库管理员使用本指南来为 WebSphere Product Center 创建和配置 DB2 数据库。

满足先决条件

在满足上述先决条件之后,使用本节概述的下列指南来创建和设置 WebSphere Product Center 数据库。

创建 WebSphere Product Center 数据库实例

为 WebSphere Product Center 数据库创建一个名为 db2inst1 的实例。如果有需要的话,为该数据库创建一个 64 位实例。在 DB2 软件安装期间提供了一个用来创建实例的选项。 

创建新数据库

建议不要在具有 WebSphere Product Center 中间件数据库的机器上共享现有数据库。请为 WebSphere Product Center 模式创建新数据库。可以在安装 DB2 软件时创建所需的数据库、缓冲池和表空间。

注意:必须使用 CODESET UTF-8 来创建数据库。本指南的示例中使用的数据库名称是 WPCDB

创建新的缓冲池

由于 WebSphere Product Center 中的表非常大,所以用来创建缓冲池的页大小是 16KB。

表空间需要使用下列缓冲池。

下表列示了每个缓冲池的建议大小。

缓冲池 大小(16KB 页)*
USERSBP 30000
INDXBP 30000
BLOBBP 1000
TEMPUSRBP 10000
TEMPSYSBP 10000

* 这些数值是针对使用 4 GB 内存的服务器标定的。数据库服务器内存每增加 1 GB,这些大小可能增加 0.25 倍。

* 在创建新的表空间之前,有必要使用 db2stop 和 db2start 命令来重新启动实例以激活缓冲池。

控制中心创建的样本 SQL:

db2 CONNECT TO wpcdb
db2 CREATE BUFFERPOOL USERSBP SIZE 30000 PAGESIZE 16384
db2 CREATE BUFFERPOOL INDXBP SIZE 30000 PAGESIZE 16384
db2 CREATE BUFFERPOOL BLOBBP SIZE 1000 PAGESIZE 16384
db2 CREATE BUFFERPOOL TEMPUSRBP SIZE 10000 PAGESIZE 16384
db2 CREATE BUFFERPOOL TEMPSYSBP SIZE 10000 PAGESIZE 16384

创建新的表空间

由于 WebSphere Product Center 中的表非常大,所以用来创建表空间的页大小是 16KB。

WebSphere Product Center 需要下列表空间。

下表列示了对表空间指定的类型、缓冲池和节点组。

表空间

类型

管理

缓冲池

USERS

REGULAR

数据库

USERSBP

INDX

REGULAR

数据库

INDXBP

BLOB_TBL_DATA

REGULAR

数据库

BLOBBP

TEMP_USER

USER TEMPORARY

系统

TEMPUSRBP

TEMP_SYSTEM

SYSTEM TEMPORARY

系统

TEMPSYSBP

注意:如果将“数据库管理的表空间”投入使用,则确保为每个表空间创建并分配足够的容器。请确保创建 TEMP_USER 作为用户临时表空间并创建 TEMP_SYSTEM 作为系统临时表空间,这两个表空间都由系统管理。

控制中心创建的样本 SQL:

注意:在下列示例中,用来创建表空间的目录路径为 /u01/db2data/wpcdb/

db2 CONNECT TO wpcdb; 
db2 CREATE REGULAR TABLESPACE USERS PAGESIZE 16K MANAGED BY DATABASE 
USING (file '/u01/db2data/wpcdb/users01' 90000) 
EXTENTSIZE 32 PREFETCHSIZE 64 BUFFERPOOL USERSBP 
OVERHEAD 24.100000 TRANSFERRATE 0.900000 DROPPED TABLE RECOVERY ON;

db2 CREATE REGULAR TABLESPACE INDX PAGESIZE 16K MANAGED BY DATABASE
USING (file '/u01/db2data/wpcdb/indx01' 190000) 
EXTENTSIZE 32 PREFETCHSIZE 64 BUFFERPOOL INDXBP 
OVERHEAD 24.100000 TRANSFERRATE 0.900000 DROPPED TABLE RECOVERY ON;

db2 CREATE REGULAR TABLESPACE BLOB_TBL_DATA PAGESIZE 16K MANAGED BY DATABASE
USING (file '/u01/db2data/wpcdb/blob01' 60000)
EXTENTSIZE 32 PREFETCHSIZE 64 BUFFERPOOL BLOBBP
OVERHEAD 24.100000 TRANSFERRATE 0.900000 DROPPED TABLE RECOVERY ON;

db2 CREATE USER TEMPORARY TABLESPACE TEMP_USER PAGESIZE 16K MANAGED BY SYSTEM
USING ('/u01/db2data/wpcdb/usertemp01')
EXTENTSIZE 32 PREFETCHSIZE 64 BUFFERPOOL TEMPUSRBP
OVERHEAD 24.100000 TRANSFERRATE 0.900000;

db2 CREATE SYSTEM TEMPORARY TABLESPACE TEMP_SYSTEM PAGESIZE 16K MANAGED BY SYSTEM
USING ('/u01/db2data/wpcdb/systemtemp01')
EXTENTSIZE 32 PREFETCHSIZE 64 BUFFERPOOL TEMPSYSBP
OVERHEAD 24.100000 TRANSFERRATE 0.900000;

创建 AIX 用户

WebSphere Product Center 数据库模式需要一个在服务器级别进行用户认证的数据库用户。 

注意:建议您使用 AIX 5L 的“SMIT 管理实用程序”来创建新的 AIX 用户。

添加数据库用户和授予许可权

在操作系统级别创建用户之后,使用实例所有者登录(缺省实例所有者登录是 db2inst1)来创建数据库用户 WPC 并将下列许可权授予此用户:

控制中心创建的样本 SQL:

db2 CONNECT TO wpcdb

GRANT DBADM, CREATETAB, BINDADD, CONNECT, CREATE_NOT_FENCED, IMPLICIT_SCHEMA, LOAD ON DATABASE TO USER WPC;

除此之外,对所有特定于 WebSphere Product Center 的表空间授予空间使用许可权。

控制中心创建的样本 SQL:

GRANT USE OF TABLESPACE USERS TO WPC;
GRANT USE OF TABLESPACE INDX TO WPC;
GRANT USE OF TABLESPACE BLOB_TBL_DATA TO WPC;
GRANT USE OF TABLESPACE TEMP_USER TO WPC;

创建新模式

为用户 WPC 创建新模式 WPC。

控制中心创建的样本 SQL:

CREATE SCHEMA WPC AUTHORIZATION WPC;

注意:如果您还需要一个数据库模式用户来用于 WebSphere Product Center 的另一个实例,则重复上一节中从“创建 AIX 用户”到“创建新模式”的步骤。例如,如果要在应用程序服务器上运行需要同一数据库中的数据库模式的另一个 WebSpehere Product Center 测试实例,则需要在该数据库中创建名为 WPCTEST 的数据库用户和模式。这将需要名为 WPCTEST 的操作系统用户。

在应用程序服务器上对节点和数据库进行编目

在不同服务器上运行 WebSphere Product Center 和数据库

在另一台服务器上运行 WebSphere Product Center 时,对该数据库进行编目以便能够从 WebSphere Product Center 连接至该数据库。在应用程序服务器上运行下列命令

db2 "catalog tcpip node <nodename> remote <dbhostname> server <sname/port#>"
db2 terminate
db2 "catalog database<dbname> as<dbname> at node <nodename>"
db2 terminate

其中:

注意:要标识正确的连接端口,请参阅数据库管理器(DBM)的 SVCNAME 参数值。
Db2 get dbm cfg|grep “SVCNAME”

示例:

db2 "catalog tcpip node NODE0001 remote trigprd server 50000/tcp"
db2 terminate
db2 "catalog database wpcdb as wpcdb at node NODE0001"
db2 terminate

当在同一台服务器上运行 WebSphere Product Center 和数据库时

当在 AIX 上同时运行 DB2 和 WebSphere Product Center 时,存在一个问题。需要安装下列两个修订来使 WebSphere Product Center 能够工作。

1. 在 DB2 数据库实例所有者的 .profile 文件和 .bashrc 文件及用来安装 WebSphere Product Center 应用程序的用户的 .profile 文件和 .bashrc 文件中指定 export EXTSHM=ON。

    export EXTSHM=ON

2. 作为创建数据库的 DB2 实例所有者使用 db2set 命令设置 DB2ENVLIST

    db2set DB2ENVLIST=EXTSHM

发出“db2stop force”和“db2start”

DB2 数据库概要文件注册表更新

WebSphere Product Center 需要使用下列概要文件注册表变量:

其它概要文件注册表变量不是必需的,但如果存在特定的需求,则可以设置它们。

DB2_RR_TO_RS

描述:“下一个键锁定”通过为所有 INSERT 和 DELETE 语句自动锁定下一个键并为 SELECT 语句锁定结果集外的下一个更大键值来保证可重复读(RR)隔离级别。

对于改变索引的键部分的 UPDATE 语句,将删除原始索引键并插入新的键值。对键插入和键删除都进行“下一个键锁定”。跳过行为影响 RR、读稳定性(RS)和游标稳定性(CS)隔离级别。(对于未落实的读(UR)隔离级别,不锁定行。)当 DB2_RR_TO_RS 为 ON 时,对于对用户表执行的扫描,由于在索引键插入和删除期间不锁定下一个键,所以不能保证 RR 行为。

此选项不影响目录表。另一项行为更改是:当 DB2_RR_TO_RS 为 ON 时,扫描将跳过已删除但尚未落实的行,即使那些行可能符合此扫描亦如此。

值:将其设置为 ON。

示例:

db2set db2_rr_to_rs=ON

DB2CODEPAGE

描述:代码页用来指定在 DB2 中导出和导入数据期间使用的字符集。将其设置为 1208。

值:将其设置为 1208。

示例:

db2set db2codepage=1208

DB2COMM

描述:db2comm 注册表变量确定启动数据库管理器时将启用哪种协议的连接管理器。可以为多个通信协议设置此变量,用逗号分隔各关键字。

值:将其设置为 tcpip

示例:

db2set db2comm=tcpip

DB2 数据库管理器配置

必须设置下列数据库管理器配置参数以便在 WebSphere Product Center 中使用。

描述 示例
MON_HEAP_SZ 维护数据库系统监视器数据的专用视图所需的内存是从监视器堆中分配的。它的大小是由 mon_heap_sz 配置参数控制的。 将其设置为 30000
SHEAPTHRES 专用排序和共享排序使用来自两个不同内存来源的内存。共享排序内存区域的大小是在第一次连接至数据库时根据 sheapthres 值以静态方式预先确定的。此大小必须是 DB2 实例主管的任何数据库的排序堆大小的两倍。 将其设置为 20000
ASLHEAPSZ 应用程序支持层堆表示本地应用程序与其相关代理程序之间的通信缓冲区。此缓冲区是由所启动的每个数据库管理器代理程序以共享内存形式分配的。 将其设置为 4200
QUERY_HEAP_SZ 此参数指定可以为查询堆分配的最大内存量。查询堆用来存储代理程序的专用内存中的每个查询。应该将 query_heap_sz 设置为至少比 aslheapsz 大 5 倍的值。 将其设置为 524280
MAXAGENTS 此参数指示在任何给定时间可以接受 WebSphere Product Center 请求的数据库管理器代理程序(无论是协调代理程序还是子代理程序)的最大数目。maxagents 值应该至少是允许并发访问的每个数据库中的 maxappls 值之和。如果数据库数目大于 numdb 参数,则最安全的做法是使用 numdb 与最大的 maxappls 值的乘积。 将其设置为 400

示例脚本:

update dbm cfg using MON_HEAP_SZ 30000;

update dbm cfg using SHEAPTHRES 20000;

update dbm cfg using QUERY_HEAP_SZ 524280;

update dbm cfg using ASLHEAPSZ 4200;

update dbm cfg using MAXAGENTS 400;

 

DB2 数据库配置参数

必须设置下列数据库配置参数以便在 WebSphere Product Center 中使用。

  描述
DFT_QUERYOPT 查询优化类用来指示优化器在编译 SQL 查询时使用不同的优化等级。此参数通过设置缺省查询优化类来提供更多灵活性。 将其设置为 9
DBHEAP

每个数据库都有一个数据库堆,数据库管理器代表所有已连接至该数据库的 WebSphere Product Center 实例来使用该数据库堆。数据库堆包含表、索引、表空间和缓冲池的控制块信息。数据库堆还包含日志缓冲区空间(logbufsz)和目录高速缓存空间(catalogcache_sz)。因此,堆的大小将依赖于在给定时间存储在堆中的控制块的数目。在 WebSphere Product Center 的所有实例与该数据库断开连接之前,控制块信息存储在堆中。

启动数据库管理器所需的最小容量是在第一次连接时分配的。根据需要,将把数据区扩展为达到 dbheap 指定的最大大小。

将其设置为 65448
CATALOGCACHE_SZ 此参数指示目录高速缓存在数据库堆(dbheap)中可以使用的空间的最大容量。 将其设置为 6000
LOGBUFSZ 此参数允许您指定在将日志记录写至磁盘前用作日志记录缓冲区的数据库堆(由 dbheap 参数定义)容量。此参数还必须小于或等于 dbheap 参数。 将其设置为 4096

UTIL_HEAP_SZ

此参数指示 BACKUP、RESTORE 和 LOAD 以及装入恢复实用程序可以同时使用的内存的最大容量。 将其设置为 5000
BUFFPAGE buffpage 参数控制着当 NPAGES 为 -1 时运行 CREATE BUFFERPOOL 或 ALTER BUFFERPOOL 语句时使用的缓冲池的大小;否则,忽略 buffpage 参数,并且使用 NPAGES 参数指定的页数来创建缓冲池。 将其设置为 22000
LOCKLIST 此参数指示分配给锁定列表的存储器的容量。每个数据库都有一个锁定列表,该列表包含由并发连接至该数据库的所有 WebSphere Product Center 实例拥有的锁。根据数据库大小的不同,可能需要增大此参数。 将其设置为 6000
APP_CTL_HEAP_SZ 此参数确定应用程序控制共享内存的最大大小,以 4 KB 页计。应用程序控制堆是从这个共享内存中分配的。 将其设置为 4500
SORTHEAP 此参数定义要用于专用排序的专用内存页的最大数目或者要用于共享排序的共享内存页的最大数目。 将其设置为 2650
STMTHEAP 在 SQL 语句的编译期间,语句堆被用作 SQL 编译器的工作空间。此参数指定此工作空间的大小。 将其设置为 30000
APPLHEAPSZ 此参数定义数据库管理器可以代表特定代理程序或子代理程序使用的专用内存页的数目。 将其设置为 45000
STAT_HEAP_SZ 此参数指示在使用 RUNSTATS 命令收集统计信息时使用的堆的最大大小。 将其设置为 22000
MAXLOCKS 锁定升级是指将行锁定替换为表锁定(从而减少列表中的锁的数目)的过程。此参数定义在数据库管理器执行升级前,应用程序拥有的锁定列表必须满足的百分比。 将其设置为 30
LOCKTIMEOUT 此参数指定 WebSphere Product Center 将等待获取锁的秒数。 将其设置为 8
NUM_IOCLEANERS 此参数允许您指定数据库的异步页清除器的数目。在数据库代理程序需要缓冲池中的空间之前,这些页清除器将缓冲池中已更改的页写至磁盘。 将其设置为 7
NUM_IOSERVERS 使用 I/O 服务器代替数据库代理程序来执行实用程序(如 BACKUP 和 RESTORE)执行的预取 I/O 和异步 I/O。此参数指定数据库的 I/O 服务器的数目。 将其设置为 8
MAXAPPLS 此参数指定可以连接至数据库(本地数据库和远程数据库)的并发 WebSphere Product Center 实例的最大数目。 将其设置为 400
AVG_APPLS SQL 优化器使用此参数来帮助估计在运行时将有多少缓冲池可供所选存取方案使用。 将其设置为 2
MAXFILOP 此参数指定可以为每个数据库代理程序打开的文件句柄的最大数目。 将其设置为 640

示例脚本:(使用的数据库的名称是 WPCDB)

db2 connect to wpcdb
update db cfg for wpcdb using DFT_QUERYOPT 9;
update db cfg for wpcdb using DBHEAP 65448;
update db cfg for wpcdb using CATALOGCACHE_SZ 6000;
update db cfg for wpcdb using LOGBUFSZ 4096;
update db cfg for wpcdb using UTIL_HEAP_SZ 5000;
update db cfg for wpcdb using BUFFPAGE 22000;
update db cfg for wpcdb using LOCKLIST 6000;
update db cfg for wpcdb using APP_CTL_HEAP_SZ 4500;
update db cfg for wpcdb using SORTHEAP 2650;
update db cfg for wpcdb using STMTHEAP 30000;
update db cfg for wpcdb using APPLHEAPSZ 45000;
update db cfg for wpcdb using STAT_HEAP_SZ 22000;
update db cfg for wpcdb using MAXLOCKS 30;
update db cfg for wpcdb using LOCKTIMEOUT 8;
update db cfg for wpcdb using NUM_IOCLEANERS 7;
update db cfg for wpcdb using NUM_IOSERVERS 8;
update db cfg for wpcdb using MAXAPPLS 400;
update db cfg for wpcdb using AVG_APPLS 2;
update db cfg for wpcdb using MAXFILOP 640;

 

       为 WebSphere Product Center 数据库设置事务日志文件

日志文件的存在目的是提供使环境恢复到一致状态并保持数据完整性的能力。日志文件存储器需要进行优化,这是因为日志文件不仅仅是按顺序被写入,数据库管理器还需要在数据库恢复期间读取它们。

建议您将日志放置在文件系统中,它们应该始终驻留在它们自己的物理磁盘上,与数据库表空间和数据库软件分开。理想的情况是使用专用磁盘来存储 DB2 日志记录,以避免任何其它进程访问或写这些磁盘的可能性。日志的理想放置位置是在磁盘的外边缘,那里每个磁道有更多数据块。强烈建议通过使用 RAID 10 或 RAID 5 阵列来保护日志不受单个磁盘故障影响。

描述 示例
NEWLOGPATH

此参数用来更改日志路径,以在不同于缺省卷的单独分区/卷或者用于数据库表空间容器的卷上创建事务日志文件。

将其设置为日志文件的目标目录。确保在设置该目录之前先创建它。在设置新日志路径之前,确保目标上有足够的空间。

 

update db cfg for wpcdb using NEWLOGPATH /u02/db2data/logs

 

LOGFILSIZ  此参数定义每个主日志文件和辅助日志文件的大小。这些日志文件的大小限制了写入的日志记录的数目,达到该数目后,日志文件就已写满并且需要新日志文件。对于开发/测试数据库,请将此参数设置为 30000,否则设置为 60000。大小为每页大小为 4 KB 的页数。 update db cfg for wpcdb using LOGFILSIZ 30000
LOGPRIMARY  主日志文件建立固定容量的存储器,此存储器被分配给恢复日志文件。此参数允许您指定要预先分配的主日志文件的数目。对于开发数据库,请将此参数设置为 20,否则设置为 40。 update db cfg for wpcdb using LOGPRIMARY 20
LOGSECOND  此参数指定创建的并且用作恢复日志文件(仅当有需要时才这样做)的辅助日志文件的数目。当主日志文件写满时,将根据需要每次分配一个辅助日志文件(大小为 logfilsiz),直到达到此参数控制的最大数目为止。对于开发/测试数据库,请将此参数设置为 10,否则设置为 20。 update db cfg for wpcdb using LOGSECOND 10

使用 db2stop 和 db2start 命令进行数据库配置更改之后重新启动数据库

  db2stop force
  db2start

       在 Application Server 上安装 DB2 管理/开发/运行时客户机

       在 WAS 上创建 DB2 实例

注意:如果数据库和应用程序服务器安装在同一台机器上,则不需要执行此步骤

在 WebSphere Application Server 上创建一个 db2 实例。db2inst1 用户或 WebSphere Product Center 中间件用户可以拥有该实例。必须在应用程序服务器上创建 32 位实例,以使 WebSphere Product Center 应用程序能够连接至数据库。在连接至数据库服务器上的 64 位实例的应用程序服务器上,可以有 32 位实例。

注意:如果该实例归 db2inst1 用户(或者除 WebSphere Product Center 中间件用户以外的任何其他用户)拥有,则在 $HOME/sqllib 位置为 WebSphere Product Center 中间件用户创建指向实例所有者的目录的软链接。

示例:

从 WebSphere Product Center 中间件用户主目录中执行以下命令

ln -s /home/db2inst1/sqllib/ sqllib

       DB2 数据库设置核对表

使用以下核对表来验证是否已正确地设置了必需的 DB2 数据库以便在 WebSphere Product Center 中使用。

X

DB2 设置核对表

  检查 DB2 服务器发行版 确保 DB2 服务器发行版与本文档中概述的安装需求相符。
  检查数据库代码集

字符集和国家字符集应该是 UTF8。请作为系统用户进行连接并检查数据库的字符集。

(在数据库服务器上,作为实例所有者登录)

$db2 get db cfg for <database name>

这应该会将“数据库代码集”设置为 UTF-8。

  检查参数文件条目 按照本章中 DB2 配置部分的内容执行操作,确保已经对 DB2 注册表变量、数据库管理器和数据库作了必需的参数更改。
  检查表空间设置 确保在数据库中设置了必需的表空间。
  检查事务日志设置

确保在一个单独分区上创建事务日志。 

  检查数据库用户设置 查看 $TOP/etc/default/common.properties 文件中的数据库用户名和密码,确保已创建数据库用户并且已将所有必需特权授予该用户。
  检查与数据库服务器的连接

必须在应用程序服务器上对数据库服务器和数据库服务器节点进行编目,并且必须能够从应用程序服务器访问数据库。

  • 使用 $TOP/bin/ test_db.sh 来检查数据库连接
  • 使用 $TOP/bin/ test_java_db.sh 来检查 JDBC 连接

必须能够从应用程序服务器访问数据库。


Oracle 数据库设置和配置        

Oracle 的操作系统设置

Oracle 建议了一些 System V 信号量和共享内存的设置。这些设置随平台和数据库大小变化。请参阅 Oracle 手册或咨询数据库管理员以了解正确的设置。

下列各节定义 Oracle 数据库操作系统的建议参数:

Linux 上的 Oracle

编辑以下文件:

        /etc/sysctl.conf

设置参数:

fs/file-max=16384
kernel/msgmni=1024
kernel/shmmax=3221225472

注意:如果有 4GB 的可用内存,则建议使用为 kernal/shmmax 设置的值。大小取决于可用内存量。

       Oracle 9i 配置

本节阐述用来正确安装 WebSphere Product Center 的 Oracle 数据库配置准则。

满足先决条件

在创建和设置 WebSphere Product Center 数据库时使用下列准则。

创建新数据库

建议为 WebSphere Product Center 应用程序设置独立的数据库。一个很好的理由就是 WebSphere Product Center 数据库不必依赖于正在使用的其它数据库的可用性和现有配置(从性能调整角度看)。

可以使用现有 Oracle 数据库实例来存储 WebSphere Product Center 数据,但是由于 WebSphere 模式中某些主键较长,所以块大小必须为 8192 KB 或更大。

字符集和国家字符集

WebSphere Product Center 使用 UTF8 字符集。因此,必须在创建 WebSphere Product Center 数据库时将数据库字符集和国家字符集设置为 UTF8。 

       特定于 WebSphere Product Center 的 Oracle 参数文件条目(init.ora)

Oracle 使用配置参数来找到文件并指定所有 Oracle 产品共用的运行时参数。当 Oracle 程序或应用程序需要转换特定配置变量时,Oracle 会参阅相关联的参数。所有 Oracle 参数都存储在注册表中。 

设置了下列参数以便在 WebSphere Product Center 中使用:

  描述
DB_BLOCK_SIZE  此参数设置 Oracle 数据库块的大小(以字节计)。此值是在数据库创建时设置的,以后不能进行更改。DB BLOCK SIZE 对于 Trio 模式十分关键,它至少必须是 8192。如果 db_block_size 太小,模式创建将失败。 对于 WebSphere Product Center 数据库,将此参数设置为 8192。

示例:

db_block_size = 8192

QUERY_REWRITE_ENABLED 用来对具体化视图启用或禁用查询重写。 此参数必须设置为 true。

示例:

query_rewrite_enabled = true

COMPATIBLE  此参数允许您在保证向后兼容较早发行版的情况下使用新发行版。 将此参数设置为 9.2.0.0.0 或更高版本。

示例:

Compatible = 9.2.0.0.0

PROCESSES 此参数指定可以同时连接至 Oracle 服务器的操作系统用户进程的最大数目。 至少将此参数设置为 500。

示例:

Processes = 500

OPEN_CURSORS 此参数指定一个会话可以同时拥有的打开游标的最大数目并约束 PL/SQL 游标高速缓存的大小,PL/SQL 使用此大小来避免对用户重新执行的语句进行重新解析。 将此参数设置为 600。

示例:

Open_cursors = 600

MAX_ENABLED_ROLES 指定用户可以启用的数据库角色的最大数目(包括子角色)。 将此参数设置为 60。

示例:

Max_enabled_roles = 60

DB_CACHE_SIZE 此参数指定缓冲区高速缓存中 Oracle 块的数目。此参数极大地影响实例的 SGA 总大小。 根据可用内存的总量设置此参数的值。至少将值设置为 1048576000。  

示例:

Db_cache_size = 1048576000

SHARED_POOL_SIZE 此参数指定共享池的大小(以字节计)。共享池包含一些对象,例如共享游标、存储过程、控制结构和并行执行消息缓冲区。 根据数据库服务器内存大小设置此值。

示例:

如果数据库服务器的内存大小为 2 GB,则 Shared_pool_size = 209715200 # 200 MB

LOG_BUFFER 指定在 LGWR 将重做条目写入重做日志文件之前用来缓冲重做条目的内存大小(以字节计)。重做条目记录对数据库块所作的更改。 将此参数的值设置为 5242880。

示例:

Log_buffer = 5242880

SORT_AREA_SIZE 此参数指定用于排序的内存的最大数量(以字节计)。排序完成后,将会返回行并释放内存。增加大小将提高大型排序的效率。如果超过内存大小,则将使用用户临时表空间中的临时磁盘段。 根据可用的主存储器将此参数设置为 5MB 与 10 MB 之间的值。将 sort_area_size 设置得较大时,如果只剩下太少的内存供其它进程使用,就会引起交换。

示例:

Sort_area_size = 5242880

OPTIMIZER_INDEX_CACHING  调整基于成本的优化器的以下假设:缓冲区高速缓存中期望将多少索引块百分比用于嵌套循环连接。这将影响执行嵌套循环连接(其中使用了索引)的成本。将此参数设置为较大的值会使得嵌套循环连接对优化器来说显得成本没那么高。值的范围为 0% 到 100%。 值:将此参数设置为 90

示例:

Optimizer_index_caching = 90

OPTIMIZER_INDEX_COST_ADJ 当太少或太多索引存取路径被考虑时,此参数用来调整优化器性能。较小的值使得优化器更可能选择索引。即,将此参数设置为 50% 将使得索引存取路径的成本看上去只有正常情况下的一半。值的范围为 1 到 10000。 将此参数设置为 50。

示例:

optimizer_index_cost_adj=50

OPTIMIZER_FEATURES_ENABLE 允许改变 init.ora 参数,此参数控制优化器的行为。 将此参数设置为 8.1.7

示例:

optimizer_features_enable=8.1.7

       表空间设置

必须在 WebSphere Product Center 数据库中创建下列表空间:

注意:确保数据文件的大小未超过 1500 MB。添加至表空间的数据文件越多,分配的空间就越多。

表空间 描述
SYSTEM 这是在 Oracle 数据库中自动创建的缺省表空间。系统表空间用来存储数据字典和系统用户创建的对象。这是永久表空间。 

建议:system 表空间的最小大小为 400MB。

USERS 此表空间用来存储所有 WebSphere Product Center 数据库表(用来存储大对象(LOB)的表除外)。使用“Oracle 数据库配置助手”(ODCA)创建数据库时会自动创建此表空间。这是在本地管理的永久表空间。 

建议:users 表空间的最小大小为 15 GB。

INDX

此表空间用来存储所有 WebSphere Product Center 数据库索引。使用 ODCA 创建数据库时会自动创建此表空间。这是在本地管理的永久表空间。 

建议:indx 表空间的最小大小为 40 GB。

BLOB_TBL_DATA  此表空间用来存储包含大对象(如目录和图像等)的 WebSphere Product Center 数据库表。创建数据库时 Oracle 数据库配置助手不会自动创建此表空间。因此,确保在创建数据库之后手工创建此表空间。这是在本地管理的永久表空间。 

建议:blob_tbl_data 表空间的最小大小为 5 GB。

UNDOTBS1 此表空间用来将回滚段存储在 Oracle 数据库中。ODCA 自动在数据库中创建此表空间。 

建议:undotbs1 表空间的最小大小为 15 GB。

TEMP 这个表空间用来临时存储数据库操作(如排序和分组)使用的对象。这个表空间也是由 ODCA 自动创建的。这是一个临时表空间。 

建议:temp 表空间的最小大小为 6 GB。

       Oracle 表空间信息

表空间

最小大小

建议的存储器参数

SYSTEM 400 MB 缺省值
USERS 5 GB EXTENT MANAGEMENT 

LOCAL SEGMENT SPACE MANAGEMENT AUTO

INDX 20 GB EXTENT MANAGEMENT 

LOCAL SEGMENT SPACE MANAGEMENT AUTO

BLOB_TBL_DATA 2 GB  EXTENT MANAGEMENT LOCAL

SEGMENT SPACE MANAGEMENT AUTO

UNDOTBS1 10 GB UNDO TABLESPACE

LEAVE DEFAULT VALUES

TEMP 5 GB TEMPORARY TABLESPACE

LEAVE DEFAULT VALUES

重做日志文件设置

Oracle 依靠联机重做日志文件来记录事务。每次对数据库执行事务时,都会将一个条目添加至重做日志文件。通过正确调整重做日志文件的大小可以提高数据库性能。未落实的事务也会生成重做日志条目。创建 6 个重做日志文件,每个日志文件的大小为 300 MB。 

在数据库服务器上为此数据库设置侦听器 

WebSphere Product Center 通过在应用程序服务器上使用 JDBC 瘦客户机来连接至数据库。在应用程序服务器上还将使用一些 WebSphere Product Center SQL 脚本来完成诸如创建 WebSphere Product Center 模式等任务。在数据库服务器上设置侦听器,以便客户机可以使用 JDBC 或 SQL Plus 连接至数据库。

创建数据库模式用户

为 WebSphere Product Center 创建数据库用户,将在 common.properties 文件中引用该用户。 

以下是需要的用户信息:

例如,在 SQL 提示符处执行以下 SQL 命令:

SQL> Create user WPC identified by WPC default tablespace users temporary tablespace temp;
SQL> Grant connect, resource, unlimited tablespace, select any dictionary, query rewrite to WPC

在应用程序服务器上安装 Oracle 9i 客户机 

在应用程序服务器上安装 Oracle 9i 客户机并确保在安装了 Oracle 客户机的应用程序服务器的 tnsnames.ora 文件中有数据库条目。可以在“$ORACLE_HOME/network/admin”目录中找到文件 tnsnames.ora。在应用程序服务器上使用 tnsping 和/或 SQLPlus 检查应用程序服务器与数据库服务器之间的连接。

X

Oracle 设置核对表

  检查 Oracle 9i 服务器发行版 Oracle 服务器应该是 Oracle 9.2.0.5 标准/企业版数据库服务器。
  检查数据库字符集 字符集和国家字符集应该是 UTF8。请作为系统用户进行连接并检查数据库的字符集。

SQL>select * from nls_database_parameters where PARAMETER in ('NLS_CHARACTERSET',’ NLS_NCHAR_CHARACTERSET’);

  检查初始参数文件条目 请阅读本章中的『Oracle 配置』一节并确保设置了必需的参数文件条目。
  检查表空间设置 确保在数据库中设置了必需的表空间。
  检查回滚段状态 确保所有回滚段都处于联机状态。作为系统用户进行连接并检查回滚段的状态。

SQL> select SEGMENT_NAME, STATUS from dba_rollback_segs;

  检查重做日志文件 确保在数据库中创建了足够的重做日志文件。要了解有关数据库中现有重做日志文件的信息,请作为系统用户进行连接并发出以下查询:

SQL> select * from v$log;

  检查数据库用户设置 查看 $TOP/etc/default/common.properties 文件中的数据库用户名和密码,确保已创建数据库用户并且已将所有必需特权授予该用户。
  检查数据库的 tnsnames.ora 文件条目 确保在安装了 Oracle 客户机的应用程序服务器上的 tnsnames.ora 文件中有数据库条目。可以在以下目录中找到 tnsnames.ora 文件:$ORACLE_HOME/network/admin 目录。

注意:由于模式安装限制,tnsnames.ora 中的服务名称必须与数据库的 SID 匹配;换而言之,OCI 实用程序(如 sqlplus)必须能够使用与 SID 相同的服务名称来进行连接。

  检查数据库服务器上的侦听器 必须能够从应用程序服务器访问数据库。

第 5 章 安装 WebSphere Product Center

要安装和配置 WebSphere Product Center,请执行本章列示的任务。


满足先决条件


准备安装介质

使用 Passport Advantage

如果您的 WebSphere Product Center 产品是从 Passport Advantage 获取的,则从 Passport Advantage 下载压缩的 WebSphere Product Center 文件,然后将安装文件解压缩到期望的安装目录中。 


使用安装介质的一般过程

本节描述使用安装介质的一般过程。

调用图形 WebSphere Product Center 安装程序

图形 WebSphere Product Center 安装程序提供了一个向导,该向导允许用户选择有关安装 WebSphere Product Center 的各个方面。通过从其中一个安装介质安装程序目录中运行可执行文件来调用安装程序。

操作系统 安装程序目录
AIX  WPC_AIX
Linux  WPC_Linux
HP-UX WPC_HP
Solaris WPC_Solaris

AIX 上的示例:

此示例描述如何为 AIX 环境调用 WebSphere Product Center 安装程序。

在 AIX 计算机上运行 CDE:如果直接在 AIX 计算机上运行并使用公共桌面环境(CDE),则浏览安装介质并双击所需的 bin 文件(*.bin)以调用安装程序。

另一种方法是从命令行浏览安装介质并执行 bin 文件(*.bin)。

通过 X 仿真软件连接至 AIX 计算机:如果使用 Windows 计算机来通过 X 仿真软件连接至 AIX 计算机,则执行下列操作来调用安装程序:

1. 为 X 仿真软件配置环境。

2. 执行特定于操作系统的 .bin 文件(.bin)。以下示例显示如何在 AIX 计算机上执行此操作。

./setupAIX.bin

图形安装程序将在您用来连接至 AIX 计算机的 Windows 计算机上启动。

执行静默安装

可以执行 WebSphere Product Center 静默安装,对于这种安装,您在一个文件中提供安装选项,而不是在安装向导的屏幕上提供那些选项。当执行多次完全相同的安装时,这种安装方式对您特别有帮助。

执行静默安装时,可以使用选项文件,也可以不使用它。选项文件存放静默安装使用的安装参数。通过下列其中一种方法来从命令行运行安装程序可执行文件: 

手工执行静默安装设置选项

当执行静默安装时,需要下列选项:

安装位置 -P installLocation=<dir>

注意:当指定 <dir> 名称时,要使用全路径名。

应用程序服务器和数据库组合 提供用于特定操作系统的应用程序服务器与数据库组合选择。可将这些选项作为手工设置的安装选项的一部分或选项文件的一部分来提供。

对于 AIX

-W adapterFeatures_aix.selectedFeature=<index>

Index 值

  • WebSphere/DB2 = 0
  • WebSphere/Oracle= 1

对于 Linux

-W adapterFeatures_linux.selectedFeature=<index>

Index 值

  • WebSphere/DB2 = 0
  • WebSphere/Oracle= 1
  • WebLogic/Oracle= 2

对于 HPUX

  • WebLogic/Oracle

对于 Solaris

  • WebSphere/Oracle

对于只有一个应用程序服务器和数据库组合选项的情况,只需要包括安装位置选项。

./<installer file> -P installLocation=<dir> -silent

注意:请参阅本文档的软件需求部分以了解每个应用程序服务器和数据库组合的受支持版本。

要使用必需的选项进行静默安装,请使用以下命令行: 

./<name of installer file> -W adapterFeatures_<operating system>.selectedFeature=<index> –P installLocation=<dir> -silent

示例

以下示例显示如何在 AIX 计算机上使用 WebSphere/DB2 组合执行此操作:

./setupAIX.bin -W adapterFeatures_aix.selectedFeature=0 –P installLocation=/opt/IBM/WPC –silent

使用选项文件执行静默安装

通过使用以下命令行,可使用选项文件执行静默安装:

./<name of installer file> –P -options <options file name > -silent

选项文件必须包含静默安装的必需选项,就如在上一节中讨论的那样。

示例

以下示例显示如何在 AIX 计算机上执行此操作。

./setupAIX.bin –P –options /home/WPC/install.txt –silent

记录用户选择

安装程序可以用户在交互式安装期间进行的选择记录到文件中。此文件是在安装完成时生成的。可以将此文件用作其它机器上的静默安装响应文件(将记录的用户选择应用于这些安装)。 

./<name of installer file> –options –record <file name>


安装 WebSphere Product Center

本节提供有关安装 WebSphere Product Center 的指示信息。您可以选择使用图形安装程序来安装软件产品,也可以从命令行以静默方式进行安装。

使用图形安装程序来安装 WebSphere Product Center

执行下列操作以安装 WebSphere Product Center:

1. 按照“调用图形 WebSphere Product Center 安装程序”中的描述来调用安装程序。

2. 选择安装向导要使用的语言,然后单击“确定”。

3. 在“欢迎”屏幕上,单击下一步

4. 在“IBM 软件许可协议接受”屏幕上,单击“我接受许可协议中的条款”,然后单击下一步

5. 从可用的组合列表中选择应用程序服务器和数据库组合,然后单击下一步

6. 在产品目录屏幕上,执行下列其中一项任务:

7. 总结屏幕列示将要安装的功能部件、指定的产品目录以及所需的磁盘空间容量。单击下一步

8. 在安装程序成功完成之后,单击完成

注意:日志详细信息是在“log.txt”文件中提供的,此文件位于 <install location>/log.txt


设置环境变量

设置 TOP 变量

用途:将 shell 变量 TOP 设置为指向 WebSphere Product Center 安装目录。

编辑以下文件:

$HOME/.bash_profile

注意:上面使用的概要文件名可能随配置的不同而不同。建议使用“.bash_profile”。 

UNIX 上的示例:

如果 WebSphere Product Center 安装在以下目录中:

/home/user/john/WPCV50

则从命令行:

export TOP=/home/user/john/WPCV520

源 $TOP/setup/init_ccd_vars.sh

用途:定义 WebSphere Product Center 初始化脚本的位置。

$TOP/setup/init_ccd_vars.sh

注意:应该修改缺省 shell 初始化脚本 .bash_profile 以设置 TOP 和源 init_ccd_vars.sh。确保对 ~/.bash_profile 进行修改。根据 bash 安装的不同,该文件的位置可能会有所变化。  

编辑 .bash_profile 以包括以下内容:

# WPC init

export TOP=<path to WPC{VERSION} directory>

WPC_INIT_VARS=$TOP/setup/init_ccd_vars.sh

 

if [ -f $WPC_INIT_VARS ]; then

. $WPC_INIT_VARS

else

echo "Error: file '$WPC_INIT_VARS' not found"

fi

编辑初始化脚本(init_ccd_vars.sh)

以“init_ccd_vars.sh 文件”为基础以初始化 WebSphere Product Center shell 变量。要使 WebSphere Product Center 能够正确地运行,必须在“init_ccd_vars.sh”文件中设置几个关键变量,本节列示了这些变量。如果未设置这些变量,启动 WebSphere Product Center 时就会发生错误。

文件的位置:$TOP/setup/init_ccd_vars.sh

Set JDK_HOME

用途:定义 Java 运行时安装的位置。此参数必须位于 TOP 参数前面。

UNIX 上的示例:

export JDK_HOME=/usr/java131

设置公共 Unix 实用程序

用途:将属性设置为 WebSphere Product Center 脚本使用的公共 UNIX 实用程序。

为下列实用程序设置属性:

AWK
CP
ECHO
GREP
MKDIR
RM
SED
TOUCH
TR
BC
CAT

UNIX 上的示例:

export CP=cp
export RM="rm –rf"
export ECHO=echo
export TOUCH=touch
export MKDIR="mkdir –p"
export TR=tr
export GREP=grep
export AWK=awk
export SED=sed
export CAT=cat
export BC=bc

设置配置以便在 WebSphere Application Server 中使用

用途:配置 WebSphere Product Center 以使用 WebSphere Application Server

注意:本节仅适用于 WebSphere Application Server。

设置下列变量:

WAS_HOME 

 WebSphere 的安装目录

WAS_NODENAME 

 WebSphere Application Server 的节点名。通常,这是本地主机名。

WAS_APPSERVERNAME 将要(在 Websphere 中)使用的应用程序服务器的名称。此名称必须是唯一的。

WAS_VHOST 

要与 WebSphere Product Center 中间件绑定的 WebSphere 虚拟主机的名称。仅当要在同一个 WebSphere 实例上运行多个 WebSphere Product Center 中间件服务器时,才需要此变量。注意:此虚拟主机与 HTTP Server 虚拟主机不同。

为不同的模块设置内存标志

所有不同的 WebSphere Product Center 模块都是使用 Java 虚拟机运行的。用户可以通过更改为此目的提供的内存标志来指定这些模块使用的内存。

例如,以下条目:

export SCHEDULER_MEMORY_FLAG='-Xmx1024m -Xms48m'

指定 SCHEDULER 模块的初始内存设置(由选项 -Xms 指定)是 48MB,最大内存设置(由选项 -Xmx 指定)是 1024MB。

注意:请参阅 $TOP/setup/init_ccd_vars.sh 中的注释以了解更多信息。

建议您将下列内存标志设置用于 WebSphere Product Center 服务:

export ADMIN_MEMORY_FLAG='-Xmx64m -Xms48m'
export APPSVR_MEMORY_FLAG='-Xmx512m -Xms64m'
export EVENTPROCESSOR_MEMORY_FLAG='-Xmx64m -Xms48m'
export QUEUEMANAGER_MEMORY_FLAG='-Xmx64m -Xms48m'
export SCHEDULER_MEMORY_FLAG='-Xmx1024m -Xms48m'
export WORKFLOWENGINE_MEMORY_FLAG='-Xmx256m –Xms64m'


配置运行时属性

下列步骤配置系统使用的运行时属性,这些属性是在文件 common.properties 中定义的。

编辑以下文件:

$TOP/etc/default/common.properties

设置数据库信息

用途:设置信息,以允许访问数据库。Tomcat 使用此信息来登录到数据库和设置连接池。

设置属性:

db_userName

db_password

db_url

示例:

假定用户名是“wpcapp”,密码是“track1”,数据库服务器的主机名是“jupiter”,Oracle 数据库实例的 SID 是“pauprd”。

设置下列属性:

db_userName=wpcapp

db_password=track1

db_url=jdbc:oracle:thin:@jupiter:1521:pauprd

注意:引用的端口是侦听器端口。在上面的示例中,端口是 1521。

设置属性:

db_userName

db_password

db_url

示例:

假定用户名是“wpcapp”,密码是“track1”,数据库服务器的主机名是“jupiter”,数据库实例是“pauprd”。

设置下列属性:

db_userName=wpcapp

db_password=track1

db_url=jdbc:db2:pauprd

设置时区

用途:定义时区属性。

设置属性:timezone

值:设置以小时或秒计的时差

示例:

要设置(GMT-08:00)太平洋时间(美国和加拿大);Tijuana(以小时计)为:

timezone=-8

要设置(GMT-08:00)太平洋时间(美国和加拿大);Tijuana(以分钟计)为:

timezone=-480

设置 FTP 目录

用途:定义使用 ftp 将数据文件传送到的目录(对于导入)。如果进行数据导入时不使用 FTP,则可以保持此属性设置为缺省值。

设置属性:

ftp_root_dir

注意:存储在 /u01/ftp/COMPANY_CODE/files 中的文件将显示在文档库的 ftp 部分中。如果文件被放到 /u01/ftp 中,则它们不会显示。因此,必须将此属性设置为组织的 ftp 目录。

例如,/u01/ftp/wpc/files。

UNIX 上的示例:

ftp_root_dir=/u01/ftp/

注意:ftp 目录以正斜杠“/”结尾。

WebSphere Product Center 将读写这个 FTP 目录

设置此目录以允许 WebSphere Product Center 用户有读/写权限。

设置 Tmp 目录

用途:此设置标识服务器上的临时目录。

设置属性:

tmp_dir

UNIX 上的示例:

tmp_dir=/tmp/

注意:tmp 目录以正斜杠“/”结尾。

设置此目录以允许 WebSphere Product Center 用户有读/写权限。


应用程序服务器配置

本节提供将 WebSphere Product Center 与 WebSphere Application Server 配合运行所需的指示信息。

IBM WebSphere Application Server 配置

为了将 WebSphere Product Center 与 WebSphere Application Server 配合使用,请遵循下列各节中描述的配置指示信息。

验证配置设置

除了标准变量以外,验证是否在 $TOP/setup/init_ccd_vars.sh 中定义了下列配置设置:

名称

WAS_HOME

WebSphere 的主目录。即 /usr/WebSphere/AppServer。

WAS_APPSERVERNAME

将要(在 WebSphere 中)使用的应用程序服务器的名称。此名称必须是唯一的。

WAS_NODENAME

正在运行 WebSphere Application Server 的节点的名称。通常,此名称与系统的主机名相同。

WAS_VHOST

要与 WebSphere Product Center 中间件绑定的 WebSphere 虚拟主机的名称。仅当要在同一个 WebSphere 实例上运行多个 WebSphere Product Center 中间件服务器时,才需要此变量。注意:此虚拟主机与 HTTP Server 虚拟主机不同。

启动缺省服务器和管理控制台

要启动 WAS 缺省服务器,请作为 root 用户发出以下命令:

${WAS_HOME}/bin/startServer.sh server1

添加 WAS 组

在 AIX 上,可以使用 SMIT 管理工具来添加组。

注意:确保 CCD 用户是 WAS 组的成员。

# chgrp –R wasgroup ${WAS_HOME}

# chmod –R g+w ${WAS_HOME}

运行 WAS 脚本

在完成上述 WebSphere Product Center 安装步骤之后,按列示的顺序运行下列脚本:

  1. $TOP/bin/websphere/create_appsvr.sh
  2. $TOP/bin/websphere/create_vhost.sh
  3. $TOP/bin/websphere/install_war.sh

在同一 WebSphere 服务器上运行 WebSphere Product Center 的多个实例

要使用一台 WebSphere 服务器来运行 WebSphere Product Center 的多个实例,必须执行下列任务:

  1. $TOP/bin/websphere/create_vhost.sh
  2. $TOP/bin/websphere/create_appsvr.sh
  3. $TOP/bin/websphere/install_war.sh

BEA WebLogic 配置

本节描述为 Websphere Product Center 环境正确配置 WebLogic 的必需任务。

对于本文档,本节中的 WebLogic  设置指示信息按如下所示配置:

设置缺省主目录

要设置 WebLogic 的缺省主目录,在 $TOP/setup/init_ccd.vars.sh 中配置以下参数:

示例:

export WPC_WL_DOMAIN_DIR="/wpc/envs/wl_username/wl_domain/wpc_domain"
export WPC_WL_DOMAIN=wpc_domain
export WPC_WL_SERVER=wpc_server
export WPC_WL_PW=wl_password
export WPC_WL_USER=wl_username

创建新的 WebLogic  域

要创建新的 WebLogic  域,使用以下目录中的 dmwiz.sh 向导:

$WL_HOME/common/bin/dmwiz.sh

1. 运行 $WL_HOME/common/bin/dmwiz.sh

2. 选择域类型 (3) WLS 域

3. 选择服务器类型 (1) 单个服务器(独立的服务器)

4. 选择域名 (1) 修改当前选择

5. 配置单个服务器

6. 修改服务器名 wpc_server

7. 修改服务器侦听端口 7507

8. 选择创建域的位置 > 修改当前选择 /wpc/envs/wl_username/wl_domain

9. 输入用户名 wl_username

10. 输入密码 wl_password

11. 输入验证密码 wl_password

12. 按 Enter 键以创建域并遵循提示退出向导。

完成 dmwiz 向导时,将会显示以下消息:域配置向导成功创建了 "wpc_domain"

既然在“/wpc/envs/wl_username/wl_domain/wpc_domain”中创建了 WebLogic  域,就可以通过编辑“/wpc/envs/wl_username/wl_domain/wpc_domain/config.xml”来配置它了

配置 config.xml

1. 除去下面各部分

2. 添加下面的“应用程序”和“启动类”部分:

  • 应用程序(在域 xml 参数中添加)

<Application Deployed="true" Name="suppliers"

Path="{ACTUAL_PATH_TO_PUBLIC_HTML}" TwoPhase="false">

<WebAppComponent Name="suppliers" Targets="wpc_server" URI="suppliers"/>

</Application>

<Application Deployed="true" Name="ccd" Path="./applications"

StagedTargets="" TwoPhase="false">

<WebAppComponent Name="ccd" Targets="wpc_server" URI="ccd.war"/>

</Application>

  • 启动类(在域 xml 参数中添加)

<StartupClass ClassName="austin.appsvr.current.admin.RemoteWeblogic"

FailureIsFatal="true" Name="RemoteWeblogic" Targets="wpc_server"/>

3. 更改 DefaultWebApp

将 WebServer 字段中的 DefaultWebApp 由 "DefaultWebApp" 更改为 "ccd"

4.  WebLogic 记录 - 如果需要的话,更改日志参数以将 weblogic.log 文件重定向至另一个位置。

配置之后的样本 config.xml 文件

<!--如果域是活动的,则请不要编辑 config.xml 文件。当域活动时,对该文件作出的任何更改都将不会对域的配置产生任何影响并且很有可能会丢失。如果域不活动,则可使用 XML 编辑器编辑此文件。如果进行编辑,则请参阅 BEA  Server Configuration Reference 文档,可以从 http://e-docs.bea.com/wls/docs61/config_xml/index.html 中获取该文档。总之,我们建议通过管理控制台更改配置文件-->

<Domain Name="wpc_domain">

 <Server
  Name="wpc_server"
  NativeIOEnabled="true"
  ListenAddress=""
  ListenPort="7507" >

    <WebServer
    DefaultWebApp="ccd"
    LogFileName="access.log"
    LoggingEnabled="true"
    Name="wpc_server"
    />

  <Log   
  FileName="weblogic.log"
  />
  </Server>

  <Application Deployed="true" Name="suppliers"
  Path="/wpc/envs/wl_username/phtml" TwoPhase="false">
  <WebAppComponent Name="suppliers" Targets="wpc_server" URI="suppliers"/>
  </Application>
  <Application Deployed="true" Name="ccd" Path="./applications"
  StagedTargets="" TwoPhase="false">
  <WebAppComponent Name="ccd" Targets="wpc_server" URI="ccd.war"/>
  </Application>

  <Security
  Name="wpc_domain"
  GuestDisabled="false"
 />

  <Log
  FileName="wl-domain.log"
  />

  <StartupClass ClassName="austin.appsvr.current.admin.RemoteWeblogic"
  FailureIsFatal="true" Name="RemoteWeblogic" Targets="wpc_server"/>

</Domain>

WebLogic 域 applications 目录

将 WebLogic 域 applications 目录($TOP/etc/default/weblogic81/config/wpc_domain/applications/ 目录)复制到新的域目录中。

要创建指向 applications 目录的符号链接,删除应用程序目录,替换为指向 WebSphere Product Center 代码库的符号链接。

例如(使用上一节中的示例 -(/wpc/envs/wl_username/wl_domain/wpc_domain/applications):

wl_username@app02:~/wl_domain/wpc_domain$ mv applications applications.bk/

wl_username@app02:~/wl_domain/wpc_domain$ ln -s /wpc/envs/wl_username/code/wpc42010009/etc/default/weblogic700/config/wpc_domain/applications/ .

wl_username@app02:~/wl_domain/wpc_domain/applications$ ls -l

total 28896

-rw-r--r-- 1 wl_username envs 29553587 Dec 31 13:36 ccd.war

wl_username@app02:~/wl_domain/wpc_domain/applications$

验证公用文件目录

验证定义为“suppliers”应用程序的目录是否与 WebSphere Product Center 用于 public_html 的目录相同。例如,创建从 $TOP/public_html 到 ~/phtml 的符号链接

wl_username@app02:~/code/wpc42010009$ mv public_html/ public_html.bk

wl_username@app02:~/code/wpc42010009$ ln -s ~/phtml/ public_html

wl_username@app02:~/code/wpc42010009$

WebLogic 问题

WebSphere Product Center 消失不见了

如果 applications 目录的位置不正确,则 WebLogic 会自动除去 WebSphere Product Center。解决方案是在 config.xml 文件中重新添加 WebSphere Product Center 并将缺省 Web 应用程序重新设置为 WebSphere Product Center。

嵌入式 LDAP 锁定错误

启动会产生以下错误 -

(...)ldap/ldapfiles/EmbeddedLDAP.lok, No locks available,errno=37

这种锁定问题的解决方案是将 wpc_server 目录移至本地磁盘。这可从 NFS wpc_domain 建立符号链接。


设置数据库模式

注意:在创建数据库模式之前,必须设置 common.properties 文件。(请参阅本章中的『配置运行时属性』一节。)

验证数据库用户

验证 common.properties 中引用的数据库用户在数据库中是否存在并且是否具有正确的特权。

执行以下 shell 脚本以测试 WebSphere Product Center 能否与数据库通信:

$TOP/bin/test_java_db.sh

此脚本尝试对 common.properties 进行语法分析并登录到数据库。

创建数据库模式

在正确地设置 DB 用户之后,就可以创建 WebSphere Product Center 数据库模式了。

执行 shell 脚本:

$TOP/src/db/schema/create/create_schema.sh

此脚本首先显示它正在尝试连接的数据库。然后,系统提示用户进行确认,即输入“y”继续,或者输入“n”停止。

请输入“y”以继续。

注意:在创建数据库模式之后,不需要再次运行 create_schema.sh。数据库模式只需要创建一次。


设置要测试的公司

本节设置一间用来测试 WebSphere Product Center 安装的公司。必须创建一个公司才能登录到 WebSphere Product Center。要创建新公司,请参考『创建新公司』一节。

创建要测试的公司

要登录到 WebSphere Product Center,必须创建一个公司。执行下列其中一项(或执行这两项)以创建一个公司:

创建“Acme”公司

要创建名为“acme”的演示公司,请执行以下 shell 脚本:

$TOP/src/db/schema/acme/create_acme.sh --code=acme

创建的 Acme 公司有 4 个用户:

Admin、bwilson、Jwilson 和 vjackson

为所有用户都提供了“trinitron”密码

创建一间空公司

要创建名为“demo”并且没有任何预定义数据的空公司(比创建 acme 演示公司要快),请执行以下 shell 脚本:

$TOP/src/db/schema/cmp/create_cmp.sh --code=demo

这就创建了 demo 公司且具有一个用户:

Admin

Admin 的密码是“trinitron”

注意密码区分大小写。在创建后,Admin 用户具有全部特权,并且应该由管理员使用。


测试 WebSphere Product Center 安装

启动 WebSphere Product Center

要启动 WebSphere Product Center,请执行脚本 start_local.sh,此脚本启动运行 WebSphere Product Center 所需的所有服务。

$TOP/bin/go/start_local.sh

通过执行以下脚本,验证 WebSphere Product Center 是否已启动并正在运行:

$TOP/bin/go/rmi_status.sh

验证下列服务是否已启动:

start_local.sh 的正常输出的一个示例:

#./start_local.sh
killing services on localhost
killing service 'appsvr_LORAX'
killing service 'admin_LORAX'
killing service 'ajp12_LORAX'
killing service 'ajp13_LORAX'
killing service 'eventprocessor'
killing service 'queuemanager'
killing service 'scheduler'
killing service 'rmi'
starting rmiregistry on port 17507
starting service 'admin_LORAX'
starting service 'appsvr_LORAX'
starting service 'eventprocessor'
starting service 'queuemanager'
starting service 'scheduler'

通过执行以下脚本,验证应用程序是否已启动并正在运行:

$TOP/bin/go/rmi_status.sh

验证下列服务是否已启动:

admin_LORAX
appsvr_LORAX
eventprocessor
queuemanager
scheduler

注意:此过程应该会耗费大约 30-40 秒,这取决于处理器的速度。

检查 RMI 状态

通过执行以下脚本,验证 WebSphere Product Center 是否已启动并正在运行:

$TOP/bin/go/rmi_status.sh

此脚本与集群中的所有机器上的 RMI 守护进程交互并获取每台机器上的本地服务的列表。将返回一个比较长的名称列表。

以下是 rmi_status.sh 的一个示例,它显示在名为“LORAX”的机器上所有服务都已启动:

#./rmi_status.sh
++ [success] rmistatus (Mon Aug 26 17:29:47 PDT 2003)
rmi://lorax:17507/CMP1/appsvr/appsvr_LORAX
rmi://lorax:17507/CMP1/admin/admin_LORAX
rmi://lorax:17507/CMP1/eventprocessor/eventprocessor_LORAX
rmi://lorax:17507/CMP1/scheduler/scheduler_LORAX
rmi://lorax:17507/CMP1/queuemanager/queuemanager_LORAX
rmi://lorax:17507/CMP1/workflow/workflow_LORAX

测试数据库连接

要使用 Java 来测试数据库连接以验证驱动程序,请运行以下脚本。

$TOP/bin/test_java_db.sh

登录到 WebSphere Product Center

打开 Internet Explorer Web 浏览器并输入 Web 服务器的 URL 和端口。随“/utils/enterLogin.jsp”一起输入标准主机名称十分重要。

http://www.acme.com:7507/utils/enterLogin.jsp

注意:在两层配置中,在 WebSphere Product Center 安装期间已将 Web 服务器端口设置为 7507。如果使用了另一个端口,则针对三层配置更改文件“server.xml”中的端口引用。

通过使用 Acme 公司演示,按如下方式登录:

用户名:bwilson
密码:trinitron
公司代码:acme

如果登录到 WebSphere Product Center 时打开了 WebSphere Product Center 主页,则表示安装已成功。请从该应用程序中注销并转到下一个步骤。

此时,如果所有连接的运行都正常,则打开 Internet Explorer Web 浏览器并输入 WebSphere Product Center 服务器的 URL 和端口。

http://www.acme.com:7507/utils/enterLogin.jsp

如果已使用 create_acme.sh 来创建 Acme 演示公司,则按如下方式登录:

用户名:bwilson
密码:trinitron
公司:acme

如果已使用 create_cmp.sh 来创建公司,则按如下方式登录:

用户名:Admin
密码:trinitron
公司:acme

如果登录到 WebSphere Product Center 时打开了 WebSphere Product Center 主页,则表示安装已成功。

停止 WebSphere Product Center

要在本地机器上停止 WebSphere Product Center,请执行以下脚本:

$TOP/bin/go/stop_local.sh

该脚本停止 WebSphere Product Center 启动的所有服务。以下是 stop_local.sh 的示例输出,它显示已停止了所有的服务:

#./stop_local.sh
stopping services on localhost
++ [success] stop service 'appsvr_LORAX' (Mon Aug 26 17:55:46 PDT 2002)
Websphere will stop in 5 seconds
++ [success] stop service 'admin_LORAX' (Mon Aug 26 17:55:47 PDT 2002)
admin will stop in 5 seconds
++ [success] stop service 'eventprocessor' (Mon Aug 26 17:55:47 PDT 2002)
event processor stopped
++ [success] stop service 'scheduler' (Mon Aug 26 17:55:47 PDT 2002)
scheduler will stop in 5 seconds
++ [success] stop service 'queuemanager' (Mon Aug 26 17:55:48 PDT 2002)
queue manager stopped
killing service 'rmi'


创建新公司

既然 WebSphere 已经安装并测试完毕,请创建一间新公司以便在测试环境或生产环境中使用。如果您愿意的话,可以创建多个公司。

例如,要创建名为“test”并且没有任何预定义数据的空公司,请执行以下 shell 脚本:

$TOP/src/db/schema/cmp/create_cmp.sh --code=test

在创建后,该公司具有单个缺省管理员用户:

用户名:Admin
密码:trinitron

注意:Admin 用户自动地被创建为具有全部特权。此用户帐户将由管理员使用。

第 6 章 - 卸载 WebSphere Product Center

本章描述如何卸载 WebSphere Product Center。卸载程序可以使用图形 WebSphere Product Center 卸载程序来运行,也可以从命令行以静默方式运行它。


调用图形卸载程序

图形 WebSphere Product Center 卸载程序将提供一个向导,该向导允许您卸载 WebSphere Product Center。通过从 WebSphere Product Center 安装目录中运行可执行文件来调用卸载程序。 

UNIX 中的示例

本节描述如何在 Unix 环境中调用 WebSphere Product Center 的卸载程序。

如果正在 UNIX 计算机上运行 CDE:如果您正在运行公共桌面环境(CDE)并且直接在 UNIX 计算机上工作,则可以浏览到 WebSphere Product Center 安装的卸载目录并双击 .bin 文件来调用卸载程序。

如果正在通过 X 仿真软件连接至 UNIX 计算机:如果您正在使用 Windows 计算机来通过 X 仿真软件连接至 UNIX 计算机,则执行下列操作来调用安装程序:

1. 为 X 仿真软件配置环境。

2. 执行 <install location>/_uninst/uninstaller.bin

图形卸载程序将在您用来连接至 UNIX 计算机的 Windows 计算机上启动。

在命令行处调用图形卸载程序

要执行 WebSphere Product Center 的图形卸载程序,请从命令行执行以下命令:

<install location>/_uninst/uninstaller.bin


使用图形卸载程序

卸载程序尝试清除安装目录,但不清除可能存在的日志文件以及用户在安装产品后创建的任何文件。为了能够清除安装目录,请确保没有任何 shell 或应用程序正在将 _uninst 目录用作它的当前目录或者以任何其它方式锁定该目录(例如,显示 _uninst 目录内容的图形文件管理器可能锁定也可能不锁定 _uninst 目录,因此,在调用卸载程序前应该关闭这些 shell 和应用程序)。

执行下列操作以使用图形卸载程序卸载 WebSphere Product Center:

  1. 在“欢迎”屏幕上,单击下一步
  2. “总结”屏幕列示将要卸载的组件以及将要从中除去它们的产品目录。验证该信息,然后单击下一步
  3. 在卸载程序成功完成之后,单击“完成”。

执行静默卸载

卸载程序尝试清除安装目录,但不清除可能存在的日志文件以及用户在安装产品后创建的任何文件。为了能够清除安装目录,请确保没有任何 shell 或应用程序正在将 _uninst 目录用作它的当前目录或者以任何其它方式锁定该目录(例如,显示 _uninst 目录内容的图形文件管理器可能锁定也可能不锁定 _uninst 目录,因此,在调用卸载程序前应该关闭这些 shell 和应用程序)。

要执行 WebSphere Product Center 的静默卸载,请从命令行执行以下命令:

<install location>/_uninst/uninstaller.bin -silent

第 7 章 管理 WebSphere Product Center 服务


服务类型

完整的 WebSphere Product Center 系统由下列并发运行的服务组成:

admin 管理服务器启动/停止远程机器上的模块
appsvr 应用程序服务器处理 JSP
eventprocessor 事件处理器在所有模块之间分派事件
queuemanager 队列管理器将文档发送到 WebSphere Product Center 之外
scheduler 调度程序运行后台作业
workflow 工作流引擎

admin_properties.xml 和集群

服务可以在工作站的集群中运行。集群中的不同机器是在 admin_properties.xml 文件中定义的:

$TOP/etc/default/admin_properties.xml

注意:admin_properties.xml 中提供了更多的信息。每个服务都可以在 admin_properties.xml 文件中列示的任何机器上运行。

典型的 WebSphere Product Center 集群可以在 WebSphere Product Center 服务器上包含应用程序服务器和“RMI 注册程序”支持实用程序,并且在辅助服务器上包含其余 WebSphere Product Center 组件。

对于主服务器故障转移,可以通过最少量的工作来让先前未在辅助服务器上运行的服务重新联机,从而最大程度地缩短了停机时间。

 

图 4 - 典型 WebSphere Product Center 集群

服务名称 - 长名称和短名称

每个服务都由服务名称唯一地标识。服务名称必须是唯一的(如果有另一个同名的服务正在集群中的某台机器上运行,则服务将拒绝启动。)

只要服务名称不相同,每个服务都可以在多台机器上运行。

“admin”和“appsvr”服务的名称已被系统固定。

对于 admin,服务名称是 admin_<machine name>(例如“admin_server1”)

对于 appsvr,服务名称是 appsvr_<machine name>(例如“appsvr_server1”)

对于其它服务,检取任意的名称。选择的名称实际上是服务的短名称。

在内部,使用这个短名称来构建长名称:

rmi://<machine name>:<rmi port>/<db user name>/<service type>/<service short name>

示例:

如果正在机器“server1”上使用 RMI 端口 17507 来运行“scheduler”服务,正在连接至数据库用户“pauadm”,并且服务名称是“sch1”,则长名称是:

rmi://server1:17507/pauadm/scheduler/sch1

如果在 server2 上为同一个用户和端口运行另一个调度程序(sch2),则长名称是:

rmi://server2:17507/pauadm/scheduler/sch2

为服务类型设置内存标志

各种 WebSphere Product Center 服务的内存标志是在 WebSphere Product Center 初始化脚本中设置的,该脚本位于 WebSphere Product Center 安装目录中。

<install location>/setup/init_ccd_vars.sh

建议您将下列内存标志设置用于 WebSphere Product Center 服务:

export ADMIN_MEMORY_FLAG='-Xmx64m -Xms48m'

export APPSVR_MEMORY_FLAG='-Xmx512m -Xms64m'

export EVENTPROCESSOR_MEMORY_FLAG='-Xmx64m -Xms48m'

export QUEUEMANAGER_MEMORY_FLAG='-Xmx64m -Xms48m'

export SCHEDULER_MEMORY_FLAG='-Xmx1024m -Xms48m'

export WORKFLOWENGINE_MEMORY_FLAG='-Xmx64m -Xms48m'

RMI - 远程方法调用

服务注册是通过 RMI(Java 远程方法调用)完成的。在运行任何服务之前,确保已在机器上启动了 RMI。

RMI 状态

要获取集群中所有正在运行的服务的列表,请执行以下脚本:

$TOP/bin/go/rmi_status.sh

此脚本与集群中的所有机器上的 RMI 守护进程交互并获取每台机器上的本地服务的列表。它返回长名称的列表。

日志文件

每个服务都将生成运行时日志文件

$TOP/logs/<service>/<service name>/svc.out

示例:

名为“sch1”的调度程序在 $TOP/logs/scheduler/sch1 中生成运行时日志文件 svc.out

在启动服务之后,建议您检查该日志文件以确保所有内容都已启动并且没有发生任何问题。

启动服务

下列各节描述如何使用本地脚本来控制服务。在可以使用某个服务之前,必须在使用该服务的机器上启动 RMI 注册程序。

要启动 RMI,请运行以下脚本:

$TOP/bin/go/start/start_rmiregistry.sh

在本地机器上启动服务

在本地机器上启动服务的最简单方法是使用 $TOP/bin/go/start/ 目录中的脚本。

脚本 描述

start_admin.sh

 启动 admin 服务

start_appsvr.sh

启动应用程序服务器

start_eventprocessor.sh

启动事件处理器

start_queuemanager.sh

启动队列管理器

start_rmiregistry.sh

启动 RMI 注册程序

start_scheduler.sh

启动调度程序

start_workflowengine.sh

启动工作流引擎

在这些脚本中,每个脚本(start_admin.sh、start_appsvr.sh 和 start_rmiregistry.sh 除外)都可以接收服务名称来作为可选自变量:

-svc_name=<service name>

admin 和 appsvr 服务使用缺省名称(admin_<machine name> 和 appsvr_<machine name>)。指定另一个名称是不起任何作用的。

如果未指定任何服务名称,则它使用缺省名称:

对于调度程序,使用“scheduler”

对于事件处理器,使用“eventprocessor”

对于队列管理器,使用“queuemanager”

对于工作流引擎,使用“workflow”

注意,如果启动一个本地服务,并且它具有已在运行中的本地服务的名称,则先前的本地服务将首先异常终止。因此,这些脚本也可以用来“重新启动”服务(首先异常终止,然后重新启动)。

示例:

要启动具有名称“sch1”的调度程序:

$TOP/bin/go/start/start_scheduler.sh -svc_name=sch1

要启动具有缺省名称的调度程序:

$TOP/bin/go/start/start_scheduler.sh

异常终止服务

异常终止一个服务将关闭该服务并使该服务变为不可用。

例如,如果调度程序正在运行一个作业,则该作业将在进程的中间异常终止。

在本地机器上异常终止服务

此处的结构反映的是该起始结构。

使用 $TOP/bin/go/abort/ 目录中的脚本。

脚本 描述

abort_admin.sh

异常终止 admin 服务

abort_appsvr.sh

异常终止应用程序服务器

abort_eventprocessor.sh

异常终止事件处理器

abort_queuemanager.sh

异常终止队列管理器

abort_rmiregistry.sh

异常终止 RMI 注册程序

abort_scheduler.sh

异常终止调度程序

abort_workflowengine.sh

异常终止工作流引擎

在这些脚本中,每个脚本(abort_admin.sh、abort_appsvr.sh 和 abort_rmiregistry.sh 除外)都可以接收服务名称来作为可选自变量:

-svc_name=<service name>

注意:异常终止 RMI 将导致不可能与远程机器上的服务交互。

停止服务

停止服务将请求顺利地关闭该服务。如果该服务“被阻塞”,则它可能根本不执行关闭过程。在调度程序完成执行所有当前正在运行的作业之前,它将不会停止。

在本地机器上停止服务

此处的结构反映的是起始结构。

使用 $TOP/bin/go/stop/ 目录中的脚本。

脚本 描述

stop_admin.sh

停止 admin 服务

stop_appsvr.sh

停止应用程序服务器

stop_eventprocessor.sh

停止事件处理器

stop_queuemanager.sh

停止队列管理器

stop_scheduler.sh

停止调度程序

stop_workflowengine.sh

停止工作流引擎

在这些脚本中,每个脚本(abort_admin.sh、abort_appsvr.sh 和 abort_rmiregistry.sh 除外)都可以接收服务名称来作为可选自变量:

-svc_name=<service name>

有关异常终止和停止的重要说明

应该使用哪一项操作?停止还是异常终止?

异常终止 保证服务将被关闭,但它不能保证当前正在运行的任务不被中断。
停止 保证“如果”该服务被停止,则该服务将在当前正在运行的每项任务首先停止后顺利地停止。

启动所有 WebSphere Product Center 模块

在本地机器上启动 WebSphere Product Center。

运行脚本 $TOP/bin/go/start/start_local.sh

这将启动 RMI 注册程序以及下列服务:

注意:在启动任何服务之前,此脚本将首先尝试关闭本地机器上的任何现有系统。

异常终止本地机器上的 WebSphere Product Center

运行脚本 $TOP/bin/go/abort/abort_local.sh

在本地机器上启动的每个服务都异常终止。RMI 注册程序也异常终止。

停止本地机器上的 WebSphere Product Center

运行脚本 $TOP/bin/go/stop/stop_local.sh

在本地机器上启动的每个服务都停止。缺省情况下,RMI 注册程序与其它服务一起停止。要保持 RMI 注册程序运行,请传递以下选项:

--kill_rmi=no

注意:在“kill_rmi=no”前面有两个连字符。

服务状态

获取服务的短状态

要获取服务的短状态,请传递下列参数:

-cmd=check -svc=<service name>

示例:

要获取调度程序的状态:

   rootadmin.sh -cmd=check -svc=scheduler

短状态可以是下列其中一种:

正在运行 

  该服务正在运行并且正在响应“脉动信号”功能。 

找不到

 找不到该服务。该服务可能尚未启动,或者可能已崩溃。

找到但未响应

找到该服务,并发现该服务已对 RMI 注册程序注册,但它不响应“脉动信号”功能。可能必须重新启动该服务。

获取服务的长状态

要获取服务的长状态,请传递下列参数:

-cmd=status -svc=<service name>

它将生成一个 html 文件,您可以使用任何浏览器来查看该文件。在终端上,您可能想使用 lynx 来对输出进行格式化。

示例:

要获取调度程序的状态:

rootadmin.sh -cmd=status -svc=scheduler > /tmp/sch_status.html; lynx /tmp/sch_status.html

   或者

rootadmin.sh -cmd=status -svc=scheduler > /tmp/sch_status.html; lynx -dump /tmp/sch_status.html

注意:以上示例中使用的“>”将状态详细信息定向到文件输出位置。

此状态提供正在该服务中运行的不同线程的概述以及该服务当前所使用的数据库连接的状态。

第 8 章 启用外部功能


LDAP 集成

LDAP(轻量级目录访问协议)集成通过在 WebSphere Product Center 中引入三项功能来改进 WebSphere Product Center 的安全性基础结构:

特色概述

LDAP 集成提供了使用第三方 LDAP 系统来进行认证的能力。由于使用第三方 LDAP 功能来进行授权是非常复杂的,所以,使用 WebSphere Product Center 5.2 中现有的授权基础结构来对 LDAP 用户进行授权,但是认证将在 LDAP 的域中进行。LDAP 用户和角色在 WPC 中的授权既是运行时行为又基于用户/系统调用的脚本操作。WebSphere Product Center 中的 LDAP 用户是使用 LDAP 标志进行区分的。

LDAP 与 WebSphere Product Center 的集成提供了经过改进的安全性授权基础结构,该授权基础结构允许支持 1000 个以上需要针对各种(内部和外部)角色进行授权的一般用户。例如,“类别管理员”将是一个内部角色,而“助理品牌管理员”将是一个外部角色。

对于 WebSphere Product Center 5.2 来说,仅针对 IBM Tivoli Directory Server V5.2(支持 LDAP V3)验证了 LDAP 集成。但是,实现是可扩展的,它可以与下列 LDAP 服务器配合工作:Sun Java System Directory Server 5.2、Weblogic 8.1– Embedded LDAP Server 和 Novell® eDirectory™ 8.7.3。

注意:在此发行版中,不支持“单点登录”功能。我们已计划在将来的发行版中实现“单点登录”。

功能概述

假定

如果一个用户在某个会话中通过认证,则在该会话结束之前,该用户将保持处于已通过认证状态,即使在该时间段内更改了用户标识(即更改了角色和密码等等)亦如此。

局限性

此发行版尚未对进行 LDAP 条目搜索时进行的特定于语言环境的字符串抽取操作进行验证。 

对迁移 5.2 以前的版本的影响

由于引入了新的 LDAP 标志来区分 LDAP 用户和 Product Center 用户,所以在 WPC USER ENTITY 中有一项模式更改。


将 LDAP 与 WebSphere Product Center 集成

本节描述在将 LDAP for IBM Tivoli Directory Server V5.2 与 WebSphere Product Center 5.2 集成时所需执行的任务。这里假定您已经正确地安装了 IBM Tivoli Directory Server V5.2。LDAP 的配置要求为 IBM Tivoli Directory Server V5.2 的用户和角色配置 LDAP 模式。

要将 LDAP 与 WebSphere Product Center 集成,请执行下列操作:

1. 找到为 LDAP 配置打包的配置文件

2. 为 IBM Tivoli Directory Server V5.2 的用户和角色配置 LDAP 模式

3. 编辑 LDAP 配置文件

4. 在 WebSphere Product Center 中启用 LDAP 平面

5. 重新启动 WebSphere Product Center

1. 找到 LDAP 配置的配置文件包

    <WPC5.2_INSTALL_DIR>/etc/default/ldap_config.xml

2. 为用户和角色配置 LDAP 模式

创建新域

1. 在 IBM Tivoli Directory Server Web 管理工具中,使用菜单路径域和模板 > 添加域来创建新域。

2. 填写所有必需字段。 

3. 选择对象类 domain 作为“父 DN”。

例如:

相对 DN 父 DN
cn=myrealm dc=wpcdomain.dc=isl.dc=com

创建新的用户模板

1. 在 IBM Tivoli Directory Server Web 管理工具中,通过单击域和模板 > 添加用户模板来创建新的用户模板。 

2. 键入上面创建的域条目来作为“父 DN”。选择“结构对象类”作为 inetOrgPerson。 

3. 编辑“必需属性”选项卡以包括下列所有必需属性:

4. 使用菜单路径域和模板 > 管理域 > 编辑来使这个用户模板与上面创建的域相关联。

例如:

Parent DN
dc=wpcdomain,dc=isl,dc=com
cn=mytemplate,dc=wpcdomain,dc=isl,dc=com


创建新用户

1. 从 IBM Tivoli Directory Server Web 管理工具中,使用菜单路径用户和组 > 添加用户来创建新用户。

2. 选择上面创建的域来作为此用户的“域”。 

3. 在“必需属性”选项卡中键入内容以包括上面提到的所有属性。

创建新组

1. 从 IBM Tivoli Directory Server Web 管理工具中,使用菜单路径用户和组 > 添加组来创建新组。

2. 选择先前创建的域来作为这个组的“域”。组的对象类是 groupOfNames。 

3. 使用户与组相关联。

3. 编辑 LDAP 配置文件

要将 LDAP 与 WebSphere Product Center 集成,以下 LDAP 配置文件是必需的:

<WPC5.2_INSTALL_DIR>/etc/default/ldap_config.xml

编辑 ldap_config.xml 文件,将方括号中显示的值替换为适合于 LDAP 安装的值,以便进行运行时 LDAP 认证。

<?xml version="1.0" encoding="UTF-8"?>
<LdapConfiguration>
    <connectionInfo>
       y <connectionParam name = "java.naming.provider.url"> (Enter the LDAP server URL)</connectionParam>
        <connectionParam name = "java.naming.security.principal">(Enter username for logging into LDAP server)</connectionParam>
        <connectionParam name = "java.naming.security.credentials">(Enter password for logging into LDAP server)</connectionParam>
        <connectionParam name = "java.naming.security.authentication">simple</connectionParam>
        <connectionParam name = "java.naming.referral">follow</connectionParam>
        <connectionParam name = "java.naming.factory.initial">com.sun.jndi.ldap.LdapCtxFactory</connectionParam>
        <connectionParam name = "java.naming.ldap.version">3</connectionParam>
    </connectionInfo>

<RoleMapping>
    <Object name = "Role Class">groupOfNames</Object>
</RoleMapping>
<WPCUserCredentialMappings ParentDN="(Key in the base DN for the User Objects)" ObjectClass="inetOrgPerson">

对于当前示例,基本 DN 是:cn=myrealm,dc=wpcdomain,dc=isl,dc=com

        <WPCUserParam name = "UserName">uid</WPCUserParam>
        <WPCUserParam name = "FirstName">cn</WPCUserParam> >
        <WPCUserParam name = "LastName">sn</WPCUserParam> >
        <WPCUserParam name = "Email">mail</WPCUserParam> >
        <WPCUserParam name = "Address">postalAddress</WPCUserParam> >
        <WPCUserParam name = "Phone">telephoneNumber </WPCUserParam> 
        <WPCUserParam name = "Fax"> TelexNumber</WPCUserParam> >
    </WPCUserCredentialMappings>
</LdapConfiguration>

4. 在 WebSphere Product Center 中启用 LDAP。

在 WebSphere Product Center common.properties 文件中,启用 LDAP 标志。

    例如,

    enable_ldap=true

5. 重新启动系统

在前面 4 个配置 LDAP 的步骤完成后,重新启动 WebSphere Product Center。


拼写检查程序启用

WebSphere Product Center 中的拼写检查功能是使用 WinterTree 提供的第三方产品“Sentry Spell Checking Engine”的框架提供的。因此,WebSphere Product Center 未与任何拼写检查程序功能捆绑在一起,要启用拼写检查功能,您需要购买 WinterTree Software 的 Spelling Service Engine V5.10。 

注意:要使用 WebSphere Product Center 中的拼写检查程序功能部件,需要 Wintertree Sentry Spelling Checker Engine Java SDK 5.10。

在此发行版中启用拼写检查程序功能之后,用户只能在“项详细信息”和“单一编辑内容编辑”屏幕中执行拼写检查。将来的发行版将在“多重编辑”屏幕或“成批编辑”屏幕中提供对拼写检查程序功能的支持。

局限性

拼写检查功能


启用拼写检查程序

本文档描述了要让 WebSphere Product Center 在运行时使用 WinterTree Software 的 Spelling Service Engine V5.10 所需进行的配置设置。

需求

配置用于 WinterTree Spelling Engine 的 WebSphere Product Center 运行时配置

要配置用于 WinterTree Spelling Engine 的 WebSphere Product Center 运行时配置,需要更改 3 个属性文件:

注意:在更改所有属性文件之后,请重新启动 WebSphere Product Center 以使“Spelling Engine 运行时配置”参数生效。

common.properties

位置:<WPC5.2_INSTALL_DIR>/etc/default/common.properties 文件 

值:编辑 common.properties 文件以包括下列属性值:

spell_check=true(这将启用 Spelling Engine)   
spell_check_vendor=wintertree(这将拼写引擎供应商设置为 WinterTree SSCE)
spell_check_vendor_class=common.plugins.wintertree.WinterTreePlugin(这将为 Wintertree SSCE 设置插件)
 spell_license=<license_key>(在 <license_key> 属性中键入向 WinterTree 购买的 Spelling Engine V5.10 软件的许可证密码值)

spellservice.properties

位置:<WPC5.2_INSTALL_DIR>/etc/default/plugins/wintertree/spellservice.properties 文件

值:将每个出现的 MainLexicon<n> 属性的 <WINTERTREE_INSTALL_DIR> 替换为系统上 WinterTree Spelling Engine 软件的安装位置。这将配置 Spelling Engine 的词典/字典和运行时属性。

ccd.rc

位置:<WPC5.2_INSTALL_DIR>/setup/ccd.rc 文件

创建从 <WPC_INSTALL_DIR>/jars/ssce.jar 到 <WINTERTREE_INSTALL_DIR>/runtime/lib 中安装的 WinterTree jar 文件 ssce.jar 的符号链接。这可以通过对此文件添加一个未注释的行来实现,如以下示例所示。

例如:

- AddJar $JARDIR/ssce.jar

 

附录 A - 配置参考

本节对各种 WebSphere Product Center 属性文件中使用的参数进行概述。

在 WebSphere Product Center 的安装期间,将把许多值赋给参数。如果需要修改任何值,则可以使用本附录中概述的规则来进行那些修改。


文件名:common.properties

在启动时,系统将使用此文件来读入所有系统级别参数。此文件包含数据库层的设置(连接参数)、目录设置、缺省字符集、线程池参数以及其它设置。

注意:common.properties 参数是按它们在文件中的出现顺序列示的。

数据库设置

用途:连接至数据库

db_username - 用来登录到数据库的用户名

db_password - 用来登录到数据库的密码

db_url - 用来连接至数据库的 jdbc url。使用以下格式:jdbc:db2:<db alias>

示例:

db_userName=qa1

db_password=qa1

db_url=jdbc:db2:qadb

 独立的表空间

用途:定义数据库是否具有不同的表空间。对于膝上型计算机或单机系统,此参数很有用。

如果为 false,则 GenSchema.java 忽略所有表空间伪指令

如果为 true,则 GenSchema.java 遵守所有表空间伪指令

示例:

db_tablespaces=true

缺省服务的 DB 参数

用途:定义缺省服务的参数。

值:使用整数值。

示例:

db_maxConnection=8

db_minConnection=2

db_maxConnection_default=4

db_maxConnection_system=4

admin 服务的 DB 参数

用途:定义 admin 服务的参数。

值:使用整数值。

示例:

db_maxConnection_admin=5

db_minConnection_admin =2

db_maxConnection__admin_default=4

db_maxConnection__admin_system=1

appsvr 服务的 DB 参数

用途:定义 appsvr 服务的参数。

值:使用整数值。

示例:

db_maxConnection_appsvr=30

db_minConnection_appsvr=10

db_maxConnection_appsvr_default=26

db_maxConnection_appsvr_system=4

scheduler 服务的 DB 参数

用途:定义 scheduler 服务的参数。

值:使用整数值。

示例:

db_maxConnection_scheduler=40

db_minConnection_scheduler=10

db_maxConnection_scheduler_default=36

db_maxConnection_scheduler_system=4

eventprocessor 服务的 DB 参数

用途:定义 eventprocessor 服务的参数。

值:使用整数值。

示例:

db_maxConnection_eventprocessor=6

db_minConnection_eventprocessor=4

db_maxConnection_eventprocessor_default=2

db_maxConnection_eventprocessor_system=4

queuemanager 服务的 DB 参数

用途:定义 queuemanager 服务的参数。

值:使用整数值。

示例:

db_maxConnection_queuemanager=12

db_minConnection_queuemanager=4

db_maxConnection_queuemanager_default=6

db_maxConnection_queuemanager_system=6

workflow 引擎服务的 DB 参数

用途:定义 workflow 引擎服务的参数。

值:使用整数值。

示例:

db_maxConnection_workflowengine=12

db_minConnection_workflowengine=4

db_maxConnection_workflowengine_default=6

db_maxConnection_workflowengine_system=6

DB 连接池信息

用途:定义 DB 连接池信息的参数。

值:最大连接时间是以天数计的。

示例:

db_maxConnTime=1

db_numRetry=3

db_retrySleep=

db_class_name=COM.company.db2.jdbc.app.DB2Driver

设置时区

用途:定义时区属性。

设置属性:timezone

值:设置以小时或秒计的时差

示例:

要设置(GMT-08:00)太平洋时间(美国和加拿大);Tijuana(以小时计)为:

timezone=-8

要设置(GMT-08:00)太平洋时间(美国和加拿大);Tijuana(以分钟计)为:

timezone=-480

每页的行数

用途:不同表中的每页行数。如果在该用户的用户设置中未指定任何值,则将读取这些值。如果这些值也未指定,则使用硬编码的值 20。

值:输入整数。

示例:

table_rows_per_page_specs_console=20

table_rows_per_page_scripts_console=20

table_rows_per_page_item_set=20

table_rows_per_page_multi_edit=10

table_rows_per_page_alerts_display=25

table_rows_per_page_lookup_table=20

清空性能缓冲区

用途:定义多久清空一次性能缓冲区。

值:单位是对该缓冲区执行的写操作的数目,即,在每写 100 次之后进行清空。

示例:

db_perf_dump=100

WebSphere Product Center 日志文件

用途:定义 WebSphere Product Center 日志文件的相对于 ${TOP} 的位置。

值:输入 WebSphere Product Center 日志文件的目录。

示例:

dbpool_log_file=logs/db_pool/pool_log.txt

每个提供程序的基本目录(相对于 ${TOP})

用途:定义每个提供程序的相对于 ${TOP} 的基本目录。

注意:基本目录必须以 public_html 开头。

值:输入每个提供程序的相对于 ${TOP} 的基本目录路径。

示例:

supplier_base_dir=/public_html/suppliers/

FTP 根目录

用途:定义 FTP 的根目录。

值:FTP 根目录的路径必须以正斜杠“/”结尾。

示例:

ftp_root_dir=/u01/ftp/

调度程序信息

用途:Num_threads 是调度程序工作程序线程的最大数目,master_poll_time 和 scheduler_nap_log_factor 用来调整调度程序在启动作业之后并在查找另一个要运行的调度之前要等待的时间长度。master_poll_time 也被用作对 DB 执行的连续查询之间的等待时间长度。

我们的想法是要避免让单个调度程序启动 10 个作业而另一个调度程序只有 1 个作业的情况。

nap_time = master_poll_time + scheduler_nap_log_factor*log(count_busy_threads)

示例:

Log 是以 10 为底的对数。

当有 1 个忙线程时,log(1) = 0,nap_time = 5000 + 10000*0 = 5 秒。

当有 10 个忙线程时,log(10) = 1,nap_time = 5000 + 10000*1 = 15 秒。

当有 100 个忙线程时,log(100) = 2,nap_time = 5000 + 10000*2 = 25 秒。

参数:

master_poll_time

sch_poll_time

num_threads

值:输入整数值。时间是以毫秒计的。

示例:

master_poll_time=5000

scheduler_nap_log_factor=10000

sch_poll_time=30000

num_threads=8

工作流引擎工作程序线程

用途:定义工作流引擎工作程序线程的最大数目。

参数:wfe_num_threads

值:输入整数值。

示例:

wfe_num_threads=8

工作流引擎 db 事件轮询时间

用途:定义当没有要运行的工作流引擎时在对 DB2 执行的连续查询之间等待的时间长度。

参数:wfe_db_event_poll_time

值:输入整数值。

示例:

wfe_db_evnt_poll_time=1000

工作流引擎信息

用途:定义工作流引擎时间。

参数:wfl_engine_poll_time

值:输入整数值。

示例:

wfl_engine_poll_time=5000

条目处理器设置

用途:在数据条目屏幕中,项被保存下来,并且宏是在后台运行的。max_threads_entry_processor 应该是 < (db_maxConnection_appsvr_default) / 2。

示例:

max_threads_entry_processor=8

max_jobs_entry_processor=64

事件处理器信息

用途:定义事件处理器时间。

参数:evp_poll_time

值:输入整数值。

示例:

evp_poll_time=5000

挂装管理器守护进程信息

用途:定义在将挂装管理器设置为休眠之前要经过的时间量。

参数:mountmgr_daemon_sleep_time

值:输入整数值。

示例:

mountmgr_daemon_sleep_time=120000

EmailBean 的 SMTP 地址

用途:设置 emailbean 的地址。

smtp_address=mail.company.com

from_address=support@company.com

支持服务电子邮件地址

用途:设置从“帮助”菜单访问的支持服务电子邮件地址链接。这指的是客户的内部支持服务电子邮件地址,而不是 IBM WebSphere Product Center 支持服务电子邮件地址。

参数:support_email_address

值:设置为内部支持服务电子邮件地址。

support_email_address=techsupport@company.com

版本信息

用途:定义已安装的 WebSphere Product Center 版本。此值是在 WebSphere Product Center 安装期间自动插入的。不要更改此值。

值:格式包括 <WebSphere Product Center 版本号 mmddyy>

示例:

version_info=4.2.0.0 041202

系统的缺省字符集

用途:定义系统的缺省字符集。UTF-8 字符集编码是 WebSphere Product Center 的一项要求。不要更改此值。

示例:

charset_value=UTF-8

charset_name=UTF-8

缺省情况下在下拉字段中指示的字符集

用途:定义在下拉字段中使用的缺省字符集。

参数:Default_charset_value 和 Default_charset_name

Default_charset_value=Cp1252

Default_charset_name=Default (Cp1252 - ANSI Latin 1)

最大项对象数

用途:定义要从数据库访存的以及存储在内存中以便在 ItemSet.java 中导出的项对象的最大数目。

参数:max_fetch_value

值:输入整数值。

示例:

max_fetch_value=100

要合并的最大项数

用途:定义要合并和清除的项的最大数目。

参数:aggregation_queue_size

值:输入整数值。

示例:

aggregation_queue_size=2000

临时表中的最大项数

用途:定义要在临时表中占用空间的项的最大数目。

参数:aggrgation_batch_size

值:输入整数值。

示例:

aggregation_batch_size=100

要删除/回滚的最大项数

用途:定义可以删除或回滚的项的最大数目。

参数:delete_rollback_batch_size

值:输入整数值。

示例:

delete_rollback_batch_size=100

RMI 端口

用途:标识所使用的 RMI 端口。

参数:rmi_port

值:输入所使用的期望 RMI 端口的整数值。

示例:

rmi_port=17507

注意:可以通过定义变量 <service_name>_rmi_port=<rmi_port> 来将 WebSphere Product Center 服务与特定 RMI 端口绑定。

即,要将“scheduler_01”绑定为使用端口“12123”,请定义以下参数:

scheduler_01_rmi_port=12123

应用程序服务器变量

用途:定义应用程序服务器变量。

值:输入所使用的期望端口的整数值。

示例:

appsvr_port=7507

tomcat_ajp12=21507

tomecat_ajp13=20507

语言环境设置

用途:为运行时的语言支持定义一个相对于 ${TOP} 的目录,该目录包含每个语言环境的 XML 文件。

值:定义的目录必须以“/”结尾。输入未定义语言环境时的缺省语言环境。

示例:

locale_xml_top=/locales/

缺省语言环境设置

用途:定义未指定语言环境时的缺省语言环境。

值:输入语言环境值。

示例:

default_locale=en_US

刷新作业状态表

用途:作业状态页面的 http-equiv 刷新时间间隔。此参数定义作业状态页面的更新频率。

参数:job_status_refresh=

值:单位是以秒计的。

示例:

job_status_refresh=30

临时目录

用途:定义在本地框使用的临时目录的位置。

值:目录必须以“/”结尾。

示例:

tmp_dir=/local/boxer/tmp/

查找下拉框

用途:定义要出现在查找下拉框中的值的数目。

参数:max_lookup_dropdown=

值:输入范围内的整数值。

示例:

max_lookup_dropdown=25

最大不活动时间间隔

用途:定义最大不活动时间限制,在这段时间过后,将显示一个对话框以自动地与系统断开连接。

参数:max_inactive_interval=

值:以秒计的单位。

示例:

max_inactive_interval=1800

脉冲更新时间间隔

用途:定义每个 JVM 的脉动信号的时间间隔。

参数:pulse_update_interval

值:缺省值设置为 1 分钟(以毫秒计的时间)。

示例:

pulse_update_interval=60000

不活动 JVM 监视器时间间隔

用途:定义 JVM 监视器的不活动时间间隔。

参数:inactive_jvm_monitor_interval

值:缺省值设置为 5 分钟(以毫秒计的时间)。

示例:

inactive_jvm_monitor_interval=300000

压缩 BLOB

用途:定义是否压缩 BLOB。

参数:gzip_blobs=

值:true/false

示例:

gzip_blobs=true

发送外部消息

用途:定义能否发送外部消息。

参数:remote_message_delivery=on

值:on/off

示例:

remote_message_delivery=on

操作系统级别命令

用途:定义用来运行操作系统级别命令的前缀。

参数:exec_prefix

值:对于 UNIX 系统,保留为空白。

示例:

exec_prefix=

队列管理器守护进程

用途:所有系统使用的队列管理器守护进程是多线程的,缺省情况下设置为 3。

参数:queue_manager_threads

值:将缺省值设置为 3。

示例:

queue_manager_threads=3

数据条目工作列表大小

用途:设置数据条目屏幕中显示的数据条目工作列表的最大大小。请根据并行用户的数目以及正在访问的项集合的数量来配置此设置。不要超出在以下示例中出现的变量:

参数:worklist_initial_size_limit 和 worklist_initial_size_limit_sort_all_enabled

值:设置整数值。

示例:

# Data Entry Work List Max Size

worklist_initial_size_limit=5000

worklist_initial_size_limit_with_sort_all_enabled=500

数据条目:在单一编辑/多重编辑之间切换前保存

用途:在单一编辑与多重编辑之间进行切换前,必须保存条目。

参数:must_save_before_switching_single_multi_edit

值:设置为 true 或 false。

false(旧行为)- 访存高级搜索、单一编辑和多重编辑属性集合的并集

true - 仅访存适用的属性集合(内存占用量较少)

示例:

must_save_before_switching_single_multi_edit=true

数据条目:在页面调度前保存条目

用途:在页面调度到后面的或前面的条目之前,必须保存条目。

参数:must_save_before_paging_entries=true

值:设置为 true 或 false。

false - 不需要保存

true  -> 不修改任何不可视的条目(内存占用量较少)

示例:

must_save_before_paging_entries=true

启用继承

用途:打开/关闭继承功能。还应该启用子规范。(在 4.2.1 中,未提供继承。)

参数:enable_inheritance

值:设置为 yes 或 no。

示例:

enable_inheritance=yes

启用子规范

用途:打开/关闭子规范功能,该功能用于继承。(在 4.2.1 中,未提供继承。可以在各种与继承无关的数据建模方案中使用子规范。)

参数:enable_subspecs

值:设置为 yes 或 no。

示例:

enable_subspecs=yes

队列管理器服务

用途:定义队列管理器参数。

参数:queuemanager_poll_time、queuemanager_num_threads 和 queuemanager_max_jobs

值:设置为整数值。

示例:

queuemanager_poll_time=5000

queuemanager_num_threads=10

queuemanager_max_jobs=1000

IBM MQ 上的 JMS

用途:IBM MQ 上的 JMS 的实现需要下列参数。

参数:jms_provider 和 jms_receive_timeout

值:设置为以下示例中显示的值。

示例:

jms_provider=IBM WebSphere MQ

jms_receive_timeout=1000

工作流条目可编辑

用途:将工作流条目设置为可编辑。

参数:workflow_with_entries_editable

值:缺省情况下,带有条目的工作流是不可编辑的。

no - 带有条目的工作流是不可编辑的

yes - 带有条目的工作流是可编辑的

示例:

workflow_with_entries_editable=no

JMS 端口和队列设置

用途:设置 WebSphere Product Center 使用的入站/出站队列以及设置所使用的 MQ 端口:

参数:jms_inbound_queue、jms_outbound_queue 和 mq_port

示例:

jms_inbound_queue=WPC.MINIME.QUEUE

jms_outbound_queue=WPC.MINIME.QUEUE

mq_port=1414

MQ 设置

用途:MQ 的实现直接需要这些设置,IBM MQ 上的 JMS 也需要这些设置。

参数:mq_channel、mq_hostname 和 mq_queuemanager

mq_channel=WPC.JAVA.CHANNEL

mq_hostname=minime

mq_queuemanager=WPC.MINIME.QMGR

mq_inbound_queue=WPC.MINIME.QUEUE

mq_outbound_queue=WPC.MINIME.QUEUE

如果缺省值不可接受,则指定下列参数。

mq_queue_put_open_options=

mq_message_put_options=

mq_queue_get_open_options=

mq_message_get_options=

脚本编制操作也可以传入这些参数。必须在这里指定整数值。除非要在代码中使用有效值来覆盖缺省值,否则不要将这些参数注释掉。即使指定了这些参数,脚本编制操作传入的值也将覆盖它们。

消息的字符集

用途:设置用于消息的字符集。

参数:mq_use_utf 和 mq_charset

示例:

mq_use_utf=false

mq_charset=819

限制规范的高速缓存大小

用途:设置在 WebSphere Product Center 的用户界面中显示的静态高速缓存的规范定义的大小。这个值影响所使用的内存量。请根据系统需求来设置高速缓存大小。

参数:max_specs_in_cache

值:设置整数值。

示例:

max_specs_in_cache=200

启用挂装管理器

用途:仅当外部进程对文档库中挂装的文件系统目录添加/删除文件时,挂装管理器才有用。

参数:enable_mountmgr

值:true/false

enable_mountmgr=true

设置每次出现的运行规则

用途:允许每次都计算多次出现字符串枚举规则值。如果不希望这样做,则设置为“false”。

参数:run_rule_per_occurrence

run_rule_per_occurrence=true

为组/本地化属性创建唯一的标识

用途:将这些参数设置为 true 将自动地为多次出现的组和本地化属性保存唯一的标识。简而言之,这允许使用脚本操作 getChangedAttributesForMultiOccurrence 来准确地进行区分。

参数:create_unique_key_for_multi_occurrence_groups 和 create_unique_key_for_multi_occurrence_localized

值:true/false

示例:

create_unique_key_for_multi_occurrence_groups=true

create_unique_key_for_multi_occurrence_localized=true

限制查找表和视图对象

用途:内存设置,用于限制可以与单一会话存储在一起的查找表和容器视图对象的数目。为了提高性能,这些对象与会话存储在一起,但是,这会增加每个会话的内存占用量,因此,最好设置保守的数值。

参数:max_lookups_in_cache 和 max_ctgviews_in_cache

值:输入整数值。

示例:

max_lookups_in_cache=10

max_ctgviews_in_cache=10

max_roles_in_cache=50

max_accesses_in_cache=500

启用内存监视

用途:启用对会话内存使用情况进行的内存监视以分析会话的内存占用量。

参数:enable_memorymonitor 和 memorymonitor_interval

值:如果启用的话,设置为“true”并对 interval 输入整数值。

示例:

enable_memorymonitor=true

memorymonitor_interval=50000

显示装入屏幕

用途:允许/禁止在进行页面导航时显示“正在装入”屏幕并且在页面装入完成前不允许用户导航到其它位置。将此参数设置为“true”可以防止过多用户同时对服务器进行操作。

参数:display_loading_screen

值:true/false

示例:

display_loading_screen=false

收集屏幕和作业的概要分析信息

用途:收集屏幕和作业的概要分析信息。

参数:profiling_info_collection_depth=1

值:-1 / 0 / 1 / 2 / 3 / … / 100(-1 指示不收集任何概要分析信息;深度值以 0 开始)

Profiling_info_collection_depth=1

收集已调度作业的其它概要分析

用途:收集已调度作业的其它概要分析信息。

参数:profiling_scheduled_jobs

值:none/nodebuglog/full

Profiling_scheduled_jobs=full

窗口小部件名

用途:使用窗口小部件长名称。缺省情况下,此参数设置为 false。

参数:debug_use_long_widget_names

值:true/false

debug_use_long_widget_names=false

DB 连接池接口

用途:对于 WebSphere Product Center,ThinPoolDBManager 不再是缺省 DB 连接池接口层。因此,缺省值设置为“false”。要切换回使用 ThinPoolDBManager,请将其设置为“true”。

参数:debug_profile_db_connections

值:true/false

示例:

debug_profile_db_connections=true

同步锁设置

用途:同步锁的设置,同步锁使线程在临界区等待,直到正在对临界区执行操作的当前线程的操作完成为止。每经过一小段时间(由 wait_poll_time 定义),一个等待线程就进行轮询以检查临界区是否空闲,如果临界区空闲,该线程就锁定临界区以进行使用。线程在被锁定临界区上可以等待的最大时间长度是由 wait_max_time 指定的,在这段时间过后,将会因为超时而抛出异常。

参数:wait_poll_time 和 wait_max_time

值:输入的值是以毫秒计的。缺省情况下,wait_poll_time 是 1 秒,wait_max_time 是 1 分钟。

wait_poll_time=1000

wait_max_time=60000

设置为检查脚本中的变量

用途:设置为声明要在脚本中使用 var 声明的变量。如果设置为 true,则必须使用 var 来声明脚本变量。

参数:script_check_variables

值:true/false

script_check_variables=false

设置为修剪条目属性值

用途:设置为修剪条目属性值。例如,将“xyz ”保存为“xyz”。

参数:trim_entry_attribute_values

值:true/false

trim_entry_attribute_values=false

显示条目属性列表

用途:设置为在“高级选择编辑器”屏幕上显示条目属性列表。

参数:display_attributes_in_rule_editor

值:true/false

Display_attributes_in_rule_editor=true

设置不可变规范

用途:设置 getCtgSpec 和 getCatalogSpec 的缺省行为以获取不可变规范或可变规范。不可变规范不能被修改,但它们重用共享高速缓存。可变规范可以被修改。

注意:可以通过将一个布尔值传递给 getCtgSpec/getCatalogSpec 来覆盖此选项。

参数:get_immutable_specs

值:true/false

Get_immutable_specs=false

关闭事件激发

用途:打开和关闭事件激发。将此标志设置为 false 将停止激发事件。

参数:fire_event_processor_events

值:true/false

fire_event_processor_events=true

设置在父代下显示的节点的上限

用途:对在左导航窗格(也称为目录资源管理器)中的一个父节点下显示的节点数设置上限,或者不设置上限(0)。

参数:leftnav_max_categories 和 leftnav_max_items

值:输入整数。

levtnav_max_categories=0

leftnav_max_items=100

设置标准 URL

用途:设置 Web 站点的标准 URL(包括端口号),用户应该将他们的浏览器指向这个 Web 站点以访问 WebSphere Product Center 实例。不应该包括尾部的“/”字符。如果将此值保留为空值,则将根据应用程序服务器的主机名和端口推断此值。对于 WebSphere,不要将此值保留为空值。

参数:trigo_web_url

值:输入带有端口号的 URL。

trigo_web_url=http://bach.qa.company.com:7507


文件名:admin_properties.xml

用途:管理实用程序使用此文件来配置 WebSphere Product Center 的集群。

规则:

列示作为集群一部分的不同主机

只能在集群中的机器上启动服务

如果在集群中只有一台主机,则使用“localhost”,否则使用真实的机器名

示例:

<!-- %DISCLAIMER% -->

<admin>

<!--

列示作为集群一部分的不同主机。

只能在集群中的机器上启动服务。

当集群中只有一台主机时,应该只使用“localhost”。

否则,应该使用真实的机器名。

示例:

<cluster>
<host name="server1"/>
<host name="server2"/>
<host name="server3"/>
</cluster>

<cluster>
<host name="localhost"/>
</cluster>

</admin>

 


文件名:docstore_mount.xml

用途:系统挂装管理器需要此文件以获取各种操作系统文件系统挂装点的位置。

示例:

<?xml version="1.0"?>
<mnts>
<mnt doc_path="/public_html/" real_path="$supplier_base_dir/"/>
<mnt doc_path="/ftp/" real_path="$supplier_ftp_dir/"/>
</mnts>


文件名:data_entry_properties.xml

此文件包含当使用单一编辑时显示在数据条目屏幕中的附加框架的信息。

对于一个公司的给定目录或层次结构,可以定义一组脚本,将执行这些脚本以显示附加框架。

有两种类型的脚本:

对于每个脚本,将需要指定:

type(url/content)

title

path(通常是 /scripts/triggers/<script name>)

要传递给 iframe 或 div html 元素的某些附加 html 信息(可选)。

示例:

<xml>

<company code="WPC">

<catalog name="ctg1">

<script>
<type>url</type>
<extra>height='150'</extra>
<title>for ctg1 - 1</title>
<path>/scripts/triggers/test_ctg1b</path>
</script>

<script>
<type>content</type>
<title>for ctg1 - 1</title>
path>/scripts/triggers/test_ctg1b</path>
</script>

</catalog>

<hierarchy name="h1">
<script>
<type>url</type>
<title>for h2 - 1</title>
<path>/scripts/triggers/test_h2</path>
</script>
</hierarchy>

</company>
</xml>

 

声明

IBM 可能不在所有国家或地区提供本文档中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息,请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权,任何同等功能的产品、程序或服务,都可以代替 IBM 产品、程序或服务。但是,评估和验证任何非 IBM 产品、程序或服务,则由用户自行负责。

IBM 公司可能已拥有或正在申请与本文档内容有关的各项专利。提供本文档并未授予用户使用这些专利的任何许可。您可以用书面方式将许可查询寄往:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区:

International Business Machines Corporation“按现状”提供本出版物,不附有任何种类的(无论是明示的还是暗含的)保证,包括但不限于暗含的有关非侵权、适销和适用于某种特定用途的保证。某些国家或地区在某些交易中不允许免除明示或暗含的保证。因此本条款可能不适用于您。

本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改;这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和/或程序进行改进和/或更改,而不另行通知。

本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的,不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分,使用那些 Web 站点带来的风险将由您自行承担。

IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。

本程序的被许可方如果要了解有关程序的信息以达到如下目的:(i)允许在独立创建的程序和其他程序(包括本程序)之间进行信息交换,以及(ii)允许对已经交换的信息进行相互使用,请与下列地址联系:

IBM Burlingame Laboratory
Director IBM Burlingame Laboratory
577 Airport Blvd., Suite 800
Burlingame, CA 94010
U.S.A

只要遵守适当的条件和条款,包括某些情形下的一定数量的付费,都可获得这方面的信息。

本资料中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际软件许可协议或任何同等协议中的条款提供。

此处包含的任何性能数据都是在受控环境中测得的。因此,在其他操作环境中获得的数据可能会有明显的不同。有些测量可能是在开发级的系统上进行的,因此不保证与一般可用系统上进行的测量结果相同。此外,有些测量是通过推算而估计的,实际结果可能会有差异。本文档的用户应当验证其特定环境的适用数据。

涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其他可公开获得的资料中获取。IBM 没有对这些产品进行测试,也无法确认其性能的精确性、兼容性或任何其他关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。

本信息可能包含日常业务经营中使用的数据和报告的示例。为了尽可能完整地说明这些示例,这些示例中包括个人、公司、品牌和产品的名称。所有这些人名或名称均系虚构,如有实际的企业名称和地址与此雷同,纯属巧合。

所有关于 IBM 未来方向或意向的声明都可随时更改或收回,而不另行通知,它们仅仅表示了目标和意愿而已。

编程接口信息

如果提供了编程接口信息,它用来帮助您使用此程序来创建应用软件。

通用编程接口允许您编写获取此程序工具的服务的应用软件。

但是,此信息也可能包含诊断、修改和调整信息。这些诊断、修改和调整信息用于帮助您调试应用软件。

警告:不要将此诊断、修改和调整信息用作编程接口,因为它是会更改的。

商标和服务标记

下列各项是 International Business Machines Corporation 在美国和/或其他国家或地区的商标或注册商标:

IBM
IBM logo
AIX
CrossWorlds
DB2
DB2 Universal Database
Domino
Lotus
Lotus Notes
MQIntegrator
MQSeries
Tivoli
WebSphere

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

MMX、Pentium 和 ProShare 是 Intel Corporation 在美国和/或其他国家或地区的商标或注册商标。

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

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


IBM WebSphere Product Center contains certain Excluded Components (as defined in the relevant License Information document), to which the following additional terms apply. This software is licensed to you under the terms and conditions of the International Program License Agreement, subject to its Excluded Components provisions. IBM is required to provide the following notices to you in connection with this softwatre:

i.) IBM WebSphere Product Center includes the following software that was licensed by IBM from the Apache Software Foundation under the terms and conditions of the Apache 2.0 license:

- Apache Regular Expression v1.2
- Apache Axis v1.1
- Apache XML4J v3.0.1
- Apache Log4j v1.1.1
- Apache Jakarta Commons DBCP Package v1.1
- Apache Jakarta Commons Pool Package v1.1
- Apache Jakarta Commons Collections Package v3.0

Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all ther entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.

"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation, and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:

(a) You must give any other recipients of the Work or Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.

You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives.

Copyright [yyyy] [name of copyright owner]

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

ii.) IBM WebSphere Product Center includes the following software that was licensed by IBM from Scott Hudson, Frank Flannery and C. Scott Ananian under the following terms and conditions:

- Cup Parser Generator v0.10k

CUP Parser Generator Copyright Notice, License, and Disclaimer
Copyright 1996-1999 by Scott Hudson, Frank Flannery, C. Scott Ananian 
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both the copyright notice and this permission notice and warranty disclaimer appear in supporting documentation, and that the names of the authors or their employers not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission.The authors and their employers disclaim all warranties with regard to this software, including all implied warranties of merchantability and fitness. In no event shall the authors or their employers be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software. 

iii.) IBM WebSphere Product Center includes the following software that was licensed by IBM from Elliot Joel Berk and C. Scott Ananian under the following terms and conditions:

- JLex v1.2.6

JLEX COPYRIGHT NOTICE, LICENSE AND DISCLAIMER.
Copyright 1996-2003 by Elliot Joel Berk and C. Scott Ananian 
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both the copyright notice and this permission notice and warranty disclaimer appear in supporting documentation, and that the name of the authors or their employers not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. The authors and their employers disclaim all warranties with regard to this software, including all implied warranties of merchantability and fitness. In no event shall the authors or their employers be liable for any special, indirect or consequential damages or any damages whatsoever resulting from loss of use, data or profits, whether in an action of contract, negligence or other tortious action, arising out of or in connection with the use or performance of this software. Java is a trademark of Sun Microsystems, Inc. References to the Java programming language in relation to JLex are not meant to imply that Sun endorses this product. 

iv.) IBM WebSphere Product Center includes the following software that was licensed by IBM from International Business Machines Corporation and others under the following terms and conditions:

- ICU4J v2.8

ICU License - ICU 1.8.1 and later
COPYRIGHT AND PERMISSION NOTICE

Copyright (c) 1995-2003 International Business Machines Corporation and others
All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, provided that the above copyright notice(s) and this permission notice appear in all copies of the Software and that both the above copyright notice(s) and this permission notice appear in supporting documentation.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.

-----------------------------------------------------------------------------
All trademarks and registered trademarks mentioned herein are the property of their respective owners.