© 2006 IBM Corporation
International Technical Support Organization
the power of one
IBM System i5
ITSO Technical Forum 2006
Best Practices for WebSphere Application Server
Administration
Aleksandr Nartovich
IBM
WSP 01
© 2006 IBM Corporation
International Technical Support Organization
声明
本信息针对在美国供应的产品和服务编写。
关于美国政府用户权利受限制的说明——使用、复制或披露受与 IBM Corporation 签订的 GSA ADP Schedule Contract 制约。
IBM 可能在其他国家或地区不提供本文档中讨论的产品、服务或功能特性。关于目前您所在地区的产品和服务的可用信息，请向当地的 IBM 代表咨询。任何对 IBM 的产品或
服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要 不侵犯 IBM 的知识产权，可用任何同等功能的产品、程序或服务代替 IBM 的产品、程序或服
务。但是，评估和验证任何非 IBM 产品、程序或服务的责任由用户承担。
IBM 可能已拥有或正在申请与本文档所述内容有关的专利。提供本文档并非授予用户使用这些专利的任何许可。请致信以下地址垂询有关许可事宜：IBM Director of Licensing,
IBM Corporation, North Castle Drive Armonk, NY 10504-1785 .
以下信息不适用于英国或其他当地法律与本规定不一致的国家和地区：IBM 公司在本文中所提供信息均系客观陈述，对此不做任何明示或暗示保证，包括但不限于针对特
定目的所暗示的非侵权、适销性或适宜性保证。在特定交易中一些陈述可能不允许明示或暗示性免责声明，因此该陈述可能对您不适用。
本信息中可能包含技术不准确之处或印刷错误，将定期更改；更改将编入本资料的新版本中。IBM 可随时对本资料中所述产品和／或程序进行完善和／或更改，恕不另行
通知。
本信息中所提及任何非 IBM Web 站点均出于便利目的，并非以任何方式对该 Web 站点做出保证。该 Web 站点所包含资料并非 IBM 产品资料的一部分，使用该 Web 站点所引
起的风险由用户自行承担。
IBM 可以自认为适当的任何方式使用或分发您提供的任何信息而无须对您承担任何责任。
涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其它可公开获得 的资料中获取。IBM 未对这些产品进行测试，也无从确认其性能的准确性、 兼容性或任何其
他关于非 IBM 产品的声明。关于非 IBM 产品的功能问题应该向这些产品的供应商提出。
本信息中包含日常业务运作中使用的数据和报告示例。为了使介绍尽可能完整，这些示例中包含个人、公司、品牌和产品名称。所有这些名称均系虚构，如与真实企业所
用名称和地址存在任何相似之处，则纯属巧合。
版权许可：
本信息包含用源语言编写的样本应用程序，以介绍各种操作系统平台上的编程技术。您可出于以下目的以任何形式复制、修改和分发这些样本程序，而无须向 IBM 付费：
开发、使用、销售或分发符合操作平台（编写样本程序的操作平台）上的应用程序编程接口的应用程序。这些示例未在所有条件下经过完全测试。因此，IBM 不能明
确保证或暗示这些程序的可靠性、可服务性或功能。您可出于以下目的以任何形式复制、 修改和分发这些样本程序，而无须向 IBM 付费：开发、使用、销售或分发符
合 IBM 应用程序编程接口的应用程序。
© 2006 IBM Corporation
International Technical Support Organization
商标
以下为国际商业机器公司在美国、其他国家或者同时在美国和其他国家的商标：
以下为其他公司的商标：
Intel、Intel Inside（标识）、MMX 和 Pentium 是 Intel Corporation 在美国、其他国家或者同时在美国和其他国家的商标。
Microsoft、Windows、Windows NT 和 Windows 标识是 Microsoft Corporation 在美国、其他国家或者同时在美国和其他国家的商标。
Java 和所有基于 Java 的商标和标识是 Sun Microsystems 在美国、其他国家或者同时在美国和其他国家的商标或注册商标。
UNIX 是 Open Group 在美国和其他国家的注册商标。
SET、SET Secure Electronic Transaction 和 SET 标识是属于 SET Secure Electronic Transaction LLC 所有的商标。
其他公司、产品和服务名称可能是其他各自的商标或服务标记。
Redbooks（标识）™
OS/400®
Perform™
Rational®
Redbooks™
Tivoli®
WebSphere®
IBM eServer™
iSeries™
z/OS®
AIX®
Domino®
DB2®
IBM®
Lotus®
© 2006 IBM Corporation
International Technical Support Organization
目的
演示 WebSphere Application Server for OS/400 的多种管理、维
护和排障技巧
© 2006 IBM Corporation
International Technical Support Organization
议程
WebSphere 安装和 PTF 维护
安装技巧
安装修订包：组 PTF 和 Interim Fix
启动简单：IBM Web Administration for i5/OS
创建 WebSphere profile 和 HTTP 服务器实例
WebSphere profile 主页：启动/停止、运行的应用程序、虚拟主机、JDBC 资
源
如果您不能访问您的程序，我们在此为您提供一个检查列表。
发展迅速
单一服务器环境
访问 WAS WAS Admin Console（从 HTTP GUI 或直接）
排除应用程序访问故障
Web 服务器定义
© 2006 IBM Corporation
International Technical Support Organization
议程（续）
Network Deployment 环境
创建群集
向群集中安装一个应用程序
Web 服务器配置
同步配置
排除故障
服务器不启动
查找错误的位置
跟踪对 DB2 UDB for iSeries 的 JDBC 访问
© 2006 IBM Corporation
International Technical Support Organization
WebSphere 安装和 PTF 维护
© 2006 IBM Corporation
International Technical Support Organization
WebSphere Application Server 的包装
所有三个版本（Express、Base 和 ND）都包含在同一个产品 ID
中——5733W60
产品不再包装为一个 OS/400 Licensed Program Product（LPP），
也不再作为一个 LPP安装
以前的版本使用 RSTLICPGM 安装包含在这一范围内的产品（在 Express 版
本中有此明确表示）
在 中，我们使用与 Multiplatforms 产品相同的包装和安装机制
ISMP
提供严格的产品包装原则，以便安装人员知道如何操作
© 2006 IBM Corporation
International Technical Support Organization
安装产品
最简单的安装方法是从 Windows 工作站启动 GUI 安装
然而，如果连接到您的 System i5 的速度比较慢，请采用以下方
法（该方法可避免 CD-ROM 驱动器引起的时延）：
只把 WAS V6 CD 上的 /WAS 文件夹拷贝到您的 System i5 上的 IFS 中
在您的系统中启动一个 5250 会话，并切换到 QShell
切换到 IFS 中的 WAS 文件夹，例如：
cd /WAS
利用一个自变量从 Qshell 命令行运行静默安装（sillent install）；将安装所
有组件
SETUP –W =“true” -silent
© 2006 IBM Corporation
International Technical Support Organization
组 PTF 安装
从 WebSphere V6 开始，WAS PTF 成为软件修订包，而非本机
PTF
System i5 的 WebSphere 组 PTF：
包括其他组 PTF：Java、HTTP Server、DB2 UDB for iSeries 加上单一 PTF 以
及通常包含一个修订包的 WAS PTF
通常遵循 PTF Cover Letter 指示
要点：
要安装修订包，必须启动主机服务器
使用 SBMJOB 向批处理提交激活更新脚本的 STRQSH 任务
确保批处理任务在内存尽可能多的池中运行（ 到 2 GB 比较合适）
确保系统上正在执行的其他活动要尽可能少。不能在受限制的状态下运
行更新，因为它要使用 Java，但是如果您能停止在系统上运行其他任何活
动，那将很好。
注：您可从支持网站下载修订包，但是我们建议您作为一个组 PTF 安装，因为可能需要依赖某些
其他产品
© 2006 IBM Corporation
International Technical Support Organization
组 PTF 安装（续）
在本机组 PTF 安装阶段：
安装组 PTF 中包括的所有本机 PTF
创建（或更新）WebSphere 目录：
/QIBM/ProdData/WebSphere/AppServer/v6/<edition>/updateinstaller
下一步是终止 WebSphere 子系统：
ENDSBS SBS(QWAS6) DELAY(300)
要完成 WebSphere 修订包的安装，必须运行位于该文件夹中的
更新脚本（或者运行 SMBJOB 命令）：
/QIBM/ProdData/WebSphere/AppServer/v6/<edition>/updateinstaller/update
如果您未使用任何自变量，更新脚本就安装在系统上发现的最新修订包。
例如：
cd /QIBM/ProdData/WebSphere/AppServer/v6/Base/updateinstaller
update
© 2006 IBM Corporation
International Technical Support Organization
Interim Fix
© 2006 IBM Corporation
International Technical Support Organization
Interim Fix（续）
搜索修订包数据库
当您发现一个适用于您的问题的修订包时，点击该修订包的链接
您应当看到一个像这样的页面：
经过测试的OS
和 WebSphere
版本
© 2006 IBM Corporation
International Technical Support Organization
安装 Interim Fix
从修订包所在网页上下载一个 .pak 文件
将该文件保存在：
/QIBM/ProdData/WebSphere/AppServer/v6/<edition>/updateinstaller/maintenance/ 1
平滑地终止 QWAS6 子系统——ENDSBS（使用以秒表示的适当
DELAY 参数值）
从 Qshell 运行这两个命令：
cd /qibm/proddata/websphere/appserver/v6/<edition>/updateinstaller
update -W ="maintenance/<downloaded .pak file>”
例如，对于 Base Edition：
cd /qibm/proddata/websphere/appserver/v6/base/updateinstaller
update -W ="maintenance/“
1 这一目录是在安装组 PTF 或修订包期间创建的。如果该目录不存在，下载 Update
Installer 工具（从修订包所在网页下载）。
© 2006 IBM Corporation
International Technical Support Organization
安装成功
如果安装成功，应在 Oshell 屏幕底部看到类似于下面这样的提
示行：
UpdateInstaller, , msg1, CWUPI0000I: EXITCODE=0
UpdateInstaller, , msg1, INSTCONFSUCCESS
重要提示：在安装一个修订或修订包后，所有的 WebSphere profile 都得到更新。
© 2006 IBM Corporation
International Technical Support Organization
卸载特定修订包
您可卸载一个特定的修订包：
终止 QWAS6 子系统
看到 QShell 命令提示符后运行两个命令，例如：
cd /qibm/proddata/websphere/appserver/v6/base/updateinstaller
update -W =""
-W ="uninstall“
如果您忘记安装的修订包的名称，可通过运行以下命令找到其名称和维护
历史记录
/qibm/proddata/websphere/appserver/v6/base/bin/historyInfo -file /tmp/
Installation Event
--------------------------------------------------------------------------------
Maintenance Package ID -WS-WAS-OS400PPC64-FPdelta011
Action install
Package Filename
Log File Name /QIBM/ProdData/WebSphere/AppServer/V6/Base/logs/update/
Backup File Name /QIBM/ProdData/WebSphere/AppServer/V6/Base/properties/version/update/backup/
Timestamp 2006-07-27 21:30:16+0900
Result success
© 2006 IBM Corporation
International Technical Support Organization
启动简单——IBM Web Administration for i5/OS
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
通过 Create a New WebSphere
Application Server 链接即刻创建
一个 WAS profile 和 HTTP Server
实例
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
创建应用服务器的 “欢迎”
页面。说明在创建应用服务器
后将能够执行的任务。
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
选择您希望为之创建一个应用
服务器 profile 的版本
只显示系统上安装的产品版本
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
指定 profile 的名称（以及后
续应用服务器）和可选的描
述
服务器名称是 WRKACT JOB
中显示的 job 名称
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
选择：
创建一个 IBM HTTP 服务器实例，
以便由新应用服务器使用
使用应用服务器的现有 HTTP 服
务器实例
选择使用应用服务器的现有
Domino HTTP 服务器
以上都不选——使用 WAS 提供
的内部 HTTP 服务器
（仅）对于 服务器是新的
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
选择您希望使用的 HTTP 服务
器实例
HTTP 服务器实例可与一个而
且仅一个 WAS 实例相关联
WAS 独立 profile 可与一个
而且仅一个 HTTP 服务器实例
相关联
两种方式是否殊途同归？
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
当您影响到另外一个 WAS 实
例/ profile 时，需要确认您的
选择。
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
可选择不安装默认的应用程序
Snoop
Hello
HitCount
Ivt
可选择不安装 DB2 Web Services
样本应用程序
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
配置 EIM 身份标记（token）
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
指定一批端口中的第一个端口
您将收到冲突警告
如果存在冲突，将不能继续进
行下一步
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
应用服务器（profile）创
建选择总结
© 2006 IBM Corporation
International Technical Support Organization
通过 IBM Web Administration for i5/OS 管理 WAS
HTTP 服务器选择总结
© 2006 IBM Corporation
International Technical Support Organization
启动 WebSphere profile
Manage All Servers 面板可使您快速浏览全部现有的单独 WebSphere profile
（Express 和 Base；ND 中不可管理的节点）以及每个 profile 使用的端口
选择您的 profile，点击 Start 按钮
© 2006 IBM Corporation
International Technical Support Organization
启动 WebSphere 服务器（续）
要手动启动一个 WebSphere profile，请登录到 Web Administration for i5/OS - >
Manage -> Application Servers
从下拉框中选择您的服务器
点击 Start 按钮
© 2006 IBM Corporation
International Technical Support Organization
Profile 主页
该页面可使您快速浏览多种重要的详细配置信息：
安装的应用程序及其状态
现有的虚拟主机
现有的数据源
您可点击列标题，切换到相应的配制面板
© 2006 IBM Corporation
International Technical Support Organization
自动启动 WAS 服务器
对每台服务器执行这些步骤（我们使用的服务器称为
“demo”）1：
CRTDUPOBJ OBJ(QWASJOBD) FROMLIB(QWAS6) OBJTYPE(*JOBD) TOLIB(demolib) NEWOBJ(mywasjobd)
CHGJOBD JOBD(DEMOLIB/MYWASJOBD) USER(QEJBSVR) RQSDTA('QSYS/CALL PGM(QWAS6/QWASSTRSVR) PARM(''
-profilePath'' ''/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/demo'' ''-server'' ''demo'')')
ADDAJE SBSD(QWAS6/QWAS6) JOB(DEMO) JOBD(DEMOLIB/MYWASJOBD)
如果 QWAS6 子系统正在运行，重启该系统
1 注：用您自己的 profile 和服务器名称替换 “demo”，用您的服务器上运行的 WebSphere 版本替换
“base”。有两种选择：Base 或 ND
© 2006 IBM Corporation
International Technical Support Organization
自动启动 QWAS6 子系统
要自动启动 QWAS6 子系统，请：
找到启动程序的名称：
WRKSYSVAL SYSVAL(QSTRUPPGM)
修改程序的源代码并编译1：
创建一个源物理文件：
CRTSRCPF FILE(DEMO/MYFILE)
检索 CL 源代码（如果必要）：
RTVCLSRC PGM(QSYS/QSTRUP)
SRCFILE(DEMO/MYFILE)
打开该源代码，向其中添加一条命令：
QSYS/STRSBS SBSD(QWAS6/QWAS6)
编译
改变 QSTRUPPGM，使其指向库中的
QSTRUP
1 在修改该程序时要慎重；在您的的 LIB 中创建一个副本。
确保 CHGIPLA 中的 STRTCP 参数设置为 *YES 。
当 QWAS6 启动时 TCP/IP 必须正常运行。
© 2006 IBM Corporation
International Technical Support Organization
访问 WebSphere 应用程序
© 2006 IBM Corporation
International Technical Support Organization
访问 WebSphere 应用程序
在处理客户端的请求时一般设计三种主要组件：
HTTP 服务器、Web 服务器插件和 WebSphere Application Server
插件
HTTP
服务器
客户端 HTTP
请求
WebSphere Application
Server
DB2
© 2006 IBM Corporation
International Technical Support Organization
配置文件
这三种组件中的每一种都有一个或多个配置文件
HTTP 服务器配置文件
插件配置文件
用于 WebSphere profile 的多个 XML 文件
Web Administration for i5/OS 避开了更新这些配置文件的复杂性
现在，我们来看看访问 WebSphere 应用程序的相关问题及其解
决方法……
© 2006 IBM Corporation
International Technical Support Organization
如果不能访问应用程序，该怎么办？
您试图访问应用程序，例如：
http://myserver:10031/snoop
此处的 HTTP 服务器实例端口是 10031
得到以下答复：
SRVE0017W: A WebGroup/Virtual Host to handle /snoop has not been defined.
The requested URL /snoop was not found on this
您需要使用以下检查列表查明问题所在：
第一步：检查应用程序是否安装和启动
第二步：检查 WebSphere 端口
第三步：访问 WebSphere 内部端口上的应用
第四步：检查上下文根
第五步：检查虚拟主机
第六步：检查日志文件（在 “排除故障” 部分讨论）
1 Firefox 浏览器中的消息
http://myserver:10031/snoop
© 2006 IBM Corporation
International Technical Support Organization
第一步：检查应用程序是否安装和启动
打开 Web Administration for i5/OS 中的
WebSphere profile 页面
点击导航树中的 Manage Installed
Application
该应用程序的状态必须是 Running
如果不是，执行以下步骤：
选择应用程序并点击 Properties
将 Application enablement 变为 Enabled
启动应用程序
© 2006 IBM Corporation
International Technical Support Organization
第二步：检查 WebSphere 端口
下一步检查要确认 WebSphere 内部端口
您可在内部端口上访问您的应用程序
点击导航树中的 Server Ports
您所需要的是标为 HTTP 的端口
© 2006 IBM Corporation
International Technical Support Organization
第三步：在 WebSphere 内部端口上访问应用程序
在内部端口上访问您的应用程序
http://myserver:50001/snoop
此处的 WAS 内部端口是 50001
而不是
http://myserver:10031/snoop
此处的 HTTP 服务器实例端口是 10031
http://myserver:10031/snoop
© 2006 IBM Corporation
International Technical Support Organization
第四步：检查应用程序的上下文根
上下文根是服务器上的所有应用构
件的逻辑位置，例如：
http://mysystem:50001/WebSphereBank/
/WebSphereBank 是该应用的上下文根
要检查上下文根，请：
点击导航树中的 Manage Installed
Applications
选择您的应用程序并点击
Properties1
点击 Virtual Host Mapped to Web
Modules 标签
1 在您选择了应用程序之后才会显示该按钮。
© 2006 IBM Corporation
International Technical Support Organization
第五步：检查虚拟主机
虚拟主机的功能像 IP 过滤器：
它有一个主机表和专用服务器，IP 地址/主机名和端口号在主机表中的允
许访问 WebSphere 中的应用程序
通过使用多个虚拟主机，您可将您的系统对客户端显示为多个
服务器
WebSphere Application Server
HTTP 服务器 1
http://FirstServer/FirstApp
虚拟主机 1：
•FirstServer
虚拟主机 2：
•SecondServer
FirstApp
SecondAppHTTP 服务器 2
http://SecondServer/SecondApp
映射
映射
x
访问
受阻
© 2006 IBM Corporation
International Technical Support Organization
第五步：检查虚拟主机（续）
每个应用程序都被映射到虚拟主机中
有两个默认的虚拟主机：
default_host – 该主机用于您的企业应用程序
admin_host – 该主机用于 WebSphere 内部应用程序，不应用于企业应用程
序
点击导航树中的 Manage Virtual Hosts
选择您的虚拟主机并点击 Properties
© 2006 IBM Corporation
International Technical Support Organization
第五步：检查虚拟主机（续）
主机表显示 IP 地址/主机名和端口号
您还可看到相关的 HTTP 服务器1。这是使用 Web Administration for i5/OS 的优
势所在
如果您希望通过 HTTP 服务器访问您的应用程序，则它的名称和端口号必
须包含在该主机表中
1 注：只有当 HTTP 服务器和 WebSphere profile 在同一服务器上配置时，这一支持才可
使用。
© 2006 IBM Corporation
International Technical Support Organization
检查列表总结
通过使用检查列表，您可确定访问应用程序时存在的问题
如果您对 WebSphere profile 配置进行某些改变（例如虚拟主机表）
，则需要重启 WebSphere profile 和 HTTP 服务器实例
© 2006 IBM Corporation
International Technical Support Organization
发展迅速——WebSphere Administrative Console
© 2006 IBM Corporation
International Technical Support Organization
启动 WebSphere Admin Console
从 Web Administration for i5/OS 页面启动 WAS Admin Console
或者把浏览器指向：
http://<your system host name>: <admin port>/ibm/console
http://%3Cyour
© 2006 IBM Corporation
International Technical Support Organization
Web 服务器定义
Web 服务器定义是一组表示您的
Web 服务器的配置参数
它为 Web 服务器插件提供配置参数，
因此应用服务器和 Web 服务器彼此
之间可互相通信
© 2006 IBM Corporation
International Technical Support Organization
插件
HTTP
服务器
客户端 HTTP
请求
WebSphere Application
Server
DB2
Web 服务器定义（续）
© 2006 IBM Corporation
International Technical Support Organization
Web 服务器定义（续）
WebSphere Application Server
HTTP 服务器 1
http://FirstServer/FirstApp
HTTP 服务器 2
http://SecondServer/SecondApp
Web 服务器
定义 1
虚拟主机：
•FirstServer
•SecondServer
FirstApp
映射
Web 服务器
定义 2 SecondApp
映射
映射
映射
- 代表 HTTP 服务器实例和 Web 服务器定义之间的关联
FirstServer:80
Se
co
nd
Se
rv
er
:8
0
© 2006 IBM Corporation
International Technical Support Organization
如何添加 Web 服务器定义
IBM Web Administration for i5/OS 是创建 Web 服务器定义的最佳工
具
当您成对创建 WebSphere profile/HTTP 服务器实例时
当您配置现有的 HTTP 服务器实例，使之和 WebSphere profile 配套使用时
但在许多情况下需要使用 WebSphere Admin Console
© 2006 IBM Corporation
International Technical Support Organization
分析 HTTP 服务器 -> WAS profile 配置
——是最佳启动位置
在 WAS Admin Console 中打开文件：
插件属性面板包含：
关于文件位置的信息
View 按钮显示文件内容
© 2006 IBM Corporation
International Technical Support Organization
查看 文件
请看几个参数（标签）
<VirtualHostGroup>
<Transport>
<UriGroup>
<Log LogLevel="Error" Name="/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/demo/logs/IHS_MYSYSTEM_DEMO/"/>
<Property Name="ESIEnable" Value="true"/>
<Property Name="ESIMaxCacheSize" Value="1024"/>
<Property Name="ESIInvalidationMonitor" Value="false"/>
<VirtualHostGroup Name="default_host">
<VirtualHost Name="*:50001"/>
<VirtualHost Name="*:50003"/>
<VirtualHost Name="*:10030"/>
</VirtualHostGroup>
<ServerCluster CloneSeparatorChange="false" LoadBalance="Round Robin" Name="demo_MYSYSTEM_demo_Cluster" PostBufferSize="64" PostSizeLimit="-1"
RemoveSpecialHeaders="true" RetryInterval="60">
<Server ConnectTimeout="0" ExtendedHandshake="false" MaxConnections="-1" Name="MYSYSTEM_demo_demo" ServerIOTimeout="0" WaitForContinue="false">
<Transport Hostname=“" Port="50001" Protocol="http"/>
<Transport Hostname="" Port="50003" Protocol="https">
<Property Name="keyring" Value="/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/demo/etc/"/>
<Property Name="stashfile" Value="/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/demo/etc/"/>
</Transport>
</Server>
</ServerCluster>
<UriGroup Name="default_host_demo_MYSYSTEM_demo_Cluster_URIs">
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/snoop/*"/>
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/hello"/>
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/hitcount"/>
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="*.jsp"/>
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="*.jsv"/>
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="*.jsw"/>
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/j_security_check"/>
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/ibm_security_logout"/>
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/servlet/*"/>
<Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/ivt/*"/>
</UriGroup>
© 2006 IBM Corporation
International Technical Support Organization
虚拟主机的设置
如果您看不到 HTTP 服务器主机名/
端口号，就需要向虚拟主机设置中
添加
© 2006 IBM Corporation
International Technical Support Organization
如果 中没有列出应用程序
当您安装一个新应用程序时，需要将它映射到：
虚拟主机
Web 服务器定义（许多人在此出错）
将模块映射到服务器
的步骤
1
2
3
© 2006 IBM Corporation
International Technical Support Organization
如果 中没有列出应用程序（续）
如果应用程序没有安装，那么
保存修改
重新生成
对于远程 HTTP 服务器：将插件传送到
远程 HTTP 服务器中
重启 WebSphere profile 和 HTTP 服务
器
© 2006 IBM Corporation
International Technical Support Organization
远程 HTTP 服务器配置
您需要配置 2 个系统：
HTTP 服务器系统（Machine B）
WebSphere 服务器系统（Machine A）
Machine B（HTTP 服务器系统）具有：
HTTP 服务器实例
Web 服务器插件（部分 WAS 安装）
利用 http 模板创建的 WebSphere profile
可选：运行 HTTP Admin 服务器
Machine A（WebSphere 系统）具有：
WebSphere Application Server
Web 服务器定义
RCHAS11 RCHAS60
© 2006 IBM Corporation
International Technical Support Organization
配置远程 HTTP 服务器的步骤
1. 在 Machine A 上创建 WebSphere profile
wasprofile -create -profileName demo2 -templatePath default –portBlock 50001
2. 在 Machine B 上利用 http 模板创建 WebSphere profile
wasprofile -create -profileName demo2remote -templatePath http
3. 在 Machine B 上创建一个称为 demo2http 的 HTTP 服务器
4. 利用 Web Administration for i5/OS 实现 HTTP 服务器与
demo2remote WebSphere profile 的通信
1. 在此期间创建了一个新文件——configureIHS_RCHAS11_DEMO2HTTP
2. 新文件位于 Machine B 上，在以下目录下：
5. /QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/demo2remote/config/IHS_RCHAS11_DEMO2HTTP/configureIHS_RCHAS11_DEMO2HT
TP
6. 将 configureIHS_RCHAS11_DEMO2HTTP 转移到 Machine A
（WebSphere 系统）上 profile 下的 o /bin 文件夹中
7. 确保您的 WebSphere profile 在 Machine A 上运行
© 2006 IBM Corporation
International Technical Support Organization
配置远程 HTTP 服务器的步骤（续）
7. 运行 Machine A 上的
configureIHS_RCHAS11_DEMO2HTTP 脚本
8. 连接到 Machine A 上的 WAS Admin Console
利用 Machine B 上的 HTTP 服务器实例的主
机名/端口号更新虚拟主机
为远程服务器 *ADMIN 进程提供详细配置信
息：它可用于将 文件从 Machine
A 传送到 Machine B 1
9. 重启 Machine A 上的 WebSphere profile
10. 启动或重启 Machine B 上的 HTTP 服务器实
例
1 If you don’t use the HTTP *ADMIN process to propagate the file, then you have to do it manually. The file location is:
/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/demo2remote/config/IHS_RCHAS11_DEMO2HTTP/
© 2006 IBM Corporation
International Technical Support Organization
Web 服务器插件
HTTP 服务器
WAS profile
（http）
WAS profile
Machine B（HTTP 服务器） Machine A（WebSphere profile）
配置 IHS
Web
服务器
© 2006 IBM Corporation
International Technical Support Organization
远程 Web 服务器管理
© 2006 IBM Corporation
International Technical Support Organization
远程 Web 服务器管理——自动化
您可在插件配置页面设置以下两个参数：
© 2006 IBM Corporation
International Technical Support Organization
WebSphere Network Deployment
© 2006 IBM Corporation
International Technical Support Organization
2.
2.
2.
1
P
or
t F
ir
ew
al
l
1.
1.
1.
1
Load Balancer: Primary
Hostname: EdgePrimary
IP address:
Cluster IP Address
Load Balancer: Backup
Hostname: EdgeBackup
IP address:
Web Server 1
Hostname: webserver1
IP address:
Port 80
s/n mask:
Web Server 2
Hostname: webserver2
IP address:
Port 80
s/n mask:
1.
1.
1.
25
3
D
om
ai
n
Fi
re
w
al
l
19
2.
16
8.
10
0.
1
WAS and DB2
Hostname: appserver1
IP address:
Port 20000
s/n mask:
Cluster IP:
WAS
Hostname: appserver2
IP address:
Port 20000
s/n mask:
DB2
Hostname: dbbackup
IP address:
Port 20000
s/n mask:
Cluster IP:
IASP
IASP
R
ep
lic
at
io
n
WebSphere Network Deployment 体系结构
© 2006 IBM Corporation
International Technical Support Organization
创建 ND 配置的高级步骤
1. 创建 WEBSERVER1 和 WEBSERVER2
2. 在每个 HTTP 服务器上使用 http 模板创建一个 WebSphere profile
3. 在 APPSERVER1 上创建一个部署管理器 WebSphere profile——整
个配置只有一个部署管理器 profile
4. 在每个 WebSphere 系统上创建一个可管理节点（APPSERVER1
和 APPSERVER2）
5. 使每个可管理节点与信元相关联。从现在开始，您可以从单
一位置——部署管理器——来配置和控制每个节点（以及应
用服务器）1
1 在这一步中我们没有创建任何应用服务器
Deployment
Manager
Node
Agent
© 2006 IBM Corporation
International Technical Support Organization
创建 ND 配置的高级步骤（续）
6. 创建一个至少有一个成员的群集
7. 将您的应用程序安装到该群集中
8. 为每个 HTTP 服务器创建一个 Web 服务器定义。使用 QShell 脚
本（该脚本将所有应用程序映射到 HTTP 服务器中）
9. 重新生成 Web 服务器插件文件，并将其发送到远程 HTTP 服务
器中
10. 启动群集（带有一个应用服务器）
11. 启动 HTTP 服务器和测试 ND 配置
12. 在测试应用程序和 WebSphere 配置后，向群集中添加更多的成
员
© 2006 IBM Corporation
International Technical Support Organization
第六步：创建群集
首先，创建一个仅有一个成员的群集1。
您可使用该成员：
安装企业应用程序
测试应用程序
测试整个配置（HTTP 服务器、WebSphere、
Load Balancer 等）
在创建群集 Wizard 向导期间，选择Create
a replication domain for this cluster
可选：您可创建根据需要创建许多成员，
但您需要指定希望在哪个节点上创建每个
成员。
1 以后可添加更多的成员，将第一个服务器的配置（包
括应用程序）复制到所有其他成员中。
© 2006 IBM Corporation
International Technical Support Organization
第六步：创建群集
首先，创建一个仅有一个成员的群集1。
您可使用该成员：
安装企业应用程序
测试应用程序
测试整个配置（HTTP 服务器、WebSphere、
Load Balancer 等）
在创建群集 wizard 向导期间，选择Create
a replication domain for this cluster
可选：您可创建根据需要创建许多成员。
需要指定您希望在哪个节点上创建每个成
员。
1 以后您可添加更多的成员，将第一个服务器的配置
（包括应用程序）复制到所有其他成员中。
© 2006 IBM Corporation
International Technical Support Organization
第八步：创建 Web 服务器定义
使用与前面所述的配置远程 HTTP 服务器相同的方法，只是这
次要对它进行配置，以便与部署管理器配套使用
Web Administration for i5/OS 生成一个特定的脚本，称为
configureIHS_<host_name>_<HTTP_server_name>。例如：
configureIHS_RCHAS11_DEPMNGR
将该脚本转移到您运行部署管理器 profile 的系统上
执行 configureIHS_<host_name>_<HTTP_server_name> 脚本
向虚拟主机表中添加 HTTP 服务器实例的主机名和端口号
配置 Remote Web server management 参数：该参数实现 WAS Admin
Console 对远程 HTTP 服务器的管理
重启部署管理器 profile
© 2006 IBM Corporation
International Technical Support Organization
第十二步：向群集添加成员
在测试您的应用程序和 WebSphere 配置后，就可以创建更多的
群集成员了：
向群集中添加一个新成员，要确保在正确的节点（系统）上创建新成员
（系统）
用新成员的主机名/端口号组合更新虚拟主机表
重启部署管理器
重新生成 Web 服务器 文件
将该文件传送到远程 HTTP 服务器中
如果必要，重启 HTTP 服务器
© 2006 IBM Corporation
International Technical Support Organization
排除故障
© 2006 IBM Corporation
International Technical Support Organization
日志文件
几个重要的日志文件位于 IFS 中的以下目录下：
/QIBM/UserData/WebSphere/AppServer/v6/Base/profiles/<profile_name>/logs/<profile_name>
这些文件包括：
© 2006 IBM Corporation
International Technical Support Organization
服务器不启动——服务器名称冲突
服务器名称（不是 profile 名称）对大小写的敏感性
本机代码对大小写不敏感，因此创建 JVM
包含错误信息
abd76523 WsServer E WSVR0004E: The server name, SERVER1, is not a valid name.
abd76523 WsServer E WSVR0009E: Error occurred during startup
服务器名称拼写错误
Job 日志包含错误信息（在 QEZJOBLOG 输出队列中搜索）：
Message . . . . : WebSphere application server not started.
Cause . . . . . : The application server configuration file
/QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/default/config/cells/MYSYSTEM/nodes/M
YSYSTEM/servers/server2/ is not valid. The reason code is 8.
8 -- Unable to access the configuration file. Verify that the path to the configuration file is correct
and is accessible by the user profile configured for the application server.
© 2006 IBM Corporation
International Technical Support Organization
服务器不启动——端口冲突
存在端口冲突：请查看
0000000a WsServerImpl E WSVR0009E: Error occurred during startup
: : Unable to initialize the Name Service
…..
Caused by: : Unable to start bootstrap server
using port 2809. Verify that no servers or other processes are already using the bootstrap server port. Also
verify that the bootstrap server is being started with a user ID which has sufficient (., root, Administrator)
privileges.
验证端口是通过从 i5 命令行运行以下命令来使用的：
netstat *cnn
点击 F13，选择按照本地端口分类
点击 F14，查看以数值表示的端口
© 2006 IBM Corporation
International Technical Support Organization
服务器不启动——端口冲突（续）
要修改服务器端口，请从 Oshell 运行 chgwassvr 命令。
例如：
chgwassvr -server server1 -profileName default -portblock 10601
© 2006 IBM Corporation
International Technical Support Organization
IPTest
WebSphere 中断运行的另一个原因是 IP 设置错误
要测试该设置，请从 Qshell 运行以下命令：
/qibm/proddata/websphere/appserver/v6/base/bin/IPTest
输出结果应该类似于：
$
>
/qibm/proddata/websphere/appserver/v6/base/bin/IPTest
Local Address:
Local Name:
All addresses for :
$
© 2006 IBM Corporation
International Technical Support Organization
JDBC 访问跟踪
© 2006 IBM Corporation
International Technical Support Organization
根据对 DB2 UDB for iSeries 的数据库访问
排除多层应用程序的故障并不是一件轻松的工作：
您需要处理通常单独驻留在异构环境中的软件组件
有两种工具对于排除故障特别有用
用于数据库服务器任务的 job 日志消息
跟踪实用程序
© 2006 IBM Corporation
International Technical Support Organization
服务器侧（数据库服务器）跟踪
为了进行这一跟踪，您需要设置关于数据源的 serverTraceCategories 定制属
性（需要重启 WebSphere profile）：
0 – 跟踪未激活
2 – 启动 JDBC 服务器任务上的数据库监控
4 – 启动 JDBC 服务器任务上的调试
8 – 当 WebSphere 关闭连接时保存 job 日志。这通常会在您终止 WebSphere profile 时发
生。
16 – 启动 JDBC 服务器任务上的跟踪
32 – 保存 SQL 信息
如果您需要实现一个以上的类别，请一起添加类别值：
例如，要实现调试消息和保存 job 日志，请将该属性设置为 12 = 4 + 8
© 2006 IBM Corporation
International Technical Support Organization
服务器侧（数据库服务器）跟踪（续）
job 日志在连接终止（关闭）后创
建
保存的 job 日志位于您在数据源属
性中指定的用户 profile 下
通过实现调试消息或数据库监控生
成许多消息
仅用它来捕获与问题相关的信息
在收集到关于问题的信息后将它关
闭
© 2006 IBM Corporation
International Technical Support Organization
客户端侧（WebSphere）跟踪——本机 JDBC 驱动程序
您可对本机 JDBC 驱动程序进行不同类型的跟踪
设置几个 JVM 命令行自变量1：
=true – 该自变量实现 CLI 调用信息
=<value> – 该自变量实现 JDBC 连接上的 Java 侧跟踪，此处的 <value> 可以是：
0 – 无跟踪
1 – 错误
3 – 错误、警告和通知消息
– 指向保存跟踪信息的文件
例如，您可在 JVM 的命令行自变量中进行以下设置：
=3 =file:///home/demo/jdbctrace.%
确保在文件后面有三个斜线（“ / ”）：file:///
在文件生成时 “%j” 将添加到 job 名称中
跟踪文件是 EBCDIC
如果您希望在您的 PC 上读取这个跟踪文件（以 ASCII 表示），请预先在 IFS 中创
建文件：
touch –C 819 /home/demo/
改变命令行自变量，以指向新文件：
=3 =file:///home/demo/
1 为了实现跟踪您需要重启 WebSphere
© 2006 IBM Corporation
International Technical Support Organization
客户端侧（WebSphere）跟踪——本机 JDBC 驱动程序（续）
© 2006 IBM Corporation
International Technical Support Organization
Redbooks
WebSphere Application Server V6 for OS/400: A Guide to Getting Started ,
SG24-6670-00
WebSphere Application Server for iSeries V6: Building Advanced
Configurations, SG24-6637-00
WebSphere Application Server for i5/OS Handbook: Version , SG24-
7221-00
