WebSphere故障排除.docx
《WebSphere故障排除.docx》由会员分享,可在线阅读,更多相关《WebSphere故障排除.docx(39页珍藏版)》请在冰豆网上搜索。
WebSphere故障排除
对IBMWorkplaceServicesExpress进行故障检修
级别:
中级
FoongYenLee,IT专家,IBM
ChengKuanGan,IT专家,IBM
KiatSingLai,IT专家,IBM
2006年1月16日
如果您是IBMWorkplaceServicesExpress管理员,那么本文会提供有价值的信息,帮助您对遇到的问题进行故障检修。
我们将带领您经历分析、识别和纠正问题的步骤;以及在需要时寻求帮助。
本文描述如何对在使用IBMWorkplaceServicesExpress时遇到的问题进行故障检修。
您将学习需要收集哪些信息以便理解问题,如何隔离问题,如何启动调试跟踪,以及如何从IBMWorkplaceServicesExpressSupport页面找到解决方案。
您应该先参考本文提供的初始故障检修步骤,如果问题仍然得不到解决,再与IBM技术支持联系。
本文的“与IBM技术支持联系”一节提供了收集所有应该发送给IBM技术支持的必要信息的步骤。
本文针对的是WorkplaceServicesExpress2.5,但是也应该适用于2.6版。
本文假设您是中级WorkplaceServicesExpress专家。
您还应该熟悉IBMWebSphereApplicationServer5.0.x和IBMWebSpherePortal5.0.2.2。
本文应用于Linux和Windows操作系统,并且基于独立的WorkplaceServicesExpress。
另外要注意,WorkplaceServicesExpress的许可方式只能是针对在单一服务器配置中使用;它不能是集群化的或克隆的。
进行故障检修的结构化方式
在对问题进行故障检修时要使用以下四个基本步骤(见图1):
1.理解问题。
2.收集信息。
3.获取错误消息。
4.隔离问题。
图1.使用四步方式进行故障检修
这四个步骤将帮助回答以下问题:
∙问题是什么?
∙为什么出现问题?
∙这个问题在什么时候发生?
∙从哪里开始故障检修?
∙应该使用什么工具进行故障检修?
∙如何解决这个问题?
回页首
理解问题
判断是不是真的有问题,判断所谓的问题是不是由于用户的误解造成的,这是很重要的。
还必须判断WorkplaceServicesExpress的哪些部分停止了,哪些部分正在工作。
在确信WorkplaceServicesExpress出现了问题之后,才能继续识别问题。
回页首
收集信息
这个步骤涉及收集产品和系统配置信息。
产品信息可以帮助判断问题是不是由于前提条件未得到满足造成的。
下面几小节描述需要收集的产品信息。
支持的软件
确认WorkplaceServicesExpress支持的软件版本和补丁级别,包括操作系统、Web浏览器、数据库、Web服务器和LightweightDirectoryAccessProtocol(LDAP)目录。
基本的WorkplaceServicesExpress2.5设置要求安装以下产品:
∙WebSphereApplicationServerBase5.0.2.6
∙WebSphereApplicationServerEnterprise5.0.2.6
∙WebSpherePortalversion5.0.2.2
∙IBMWebSphereJDK1.3.1.7
支持的硬件
除了确认安装WorkplaceServicesExpress的操作系统是受支持的之外,还要确认处理器速度、物理内存、磁盘空间和文件系统/文件系统大小满足要求。
应用的补丁和修补
在软件补丁或临时补丁安装之后,可能出现某些问题。
确认补丁可以应用于特定版本,而且部署时采用了正确的步骤。
请记住,某些补丁要求先安装其他补丁,或者卸载以前安装的补丁。
系统配置信息可以帮助发现问题是由于产品配置造成的,还是由于与其他外部产品的集成造成的。
WorkplaceServicesExpress配置
配置步骤中细微的变化就可能造成WorkplaceServicesExpress的功能出现大问题。
这些配置包括单点登录(SSO)、文档库或访问控制。
因此,要确保按照WorkplaceServicesExpressInformationCenter和其他产品文档中的建议进行配置,这是很重要的。
与其他产品的集成
WorkplaceServicesExpress可以与外部Web、LDAP、数据库和代理服务器集成,并参与公司网络。
一定要确保集成成功完成并经过充分测试,然后才能继续进行故障检修。
同样,要确保按照WorkplaceServicesExpressInformationCenter中的建议进行配置。
数据改变
确保开发期间使用的测试数据没有迁移到生产环境中,因为测试数据可能造成系统不稳定。
意外地修改用户注册表常常会造成用户身份验证和授权问题。
修改
对WorkplaceServicesExpress进行无计划的或不正确的修改可能会造成潜在问题;因此,必须了解在问题出现之前对程序做了哪些修改。
其他需求
要了解站点使用方面的建议,JavaSpecificationRequest(JSR)168和WebServicesforRemotePortlets(WSRP)的限制,以及客户机的显示设置。
注意:
JSR168支持portlet和门户之间进行互操作。
这个规范为portlet定义了一组API,并对参数设置、用户信息、portlet请求和响应、部署打包以及安全性进行了标准化。
WSRP规范定义了一个Web服务接口,用于访问和操作交互式的面向表示的Web服务。
回页首
获取错误消息
在收集了发生问题的环境的相关信息之后,转到下一步,即获取错误消息。
例如,判断是从哪里报告了这个错误,是从WorkplaceServicesExpress,还是从其他外部产品(比如LDAP)。
为了捕获错误消息,需要启动某些跟踪功能,从而将调试消息捕获到相应的日志文件中。
跟踪
WorkplaceServicesExpress企业应用程序安装在WebSpherePortal上,WebSpherePortal提供了两种日志记录功能:
消息的日志记录和调试消息的日志记录。
这些调试消息称为跟踪。
可以使用WebSpherePortal日志记录设施来设置跟踪,并通过重现问题将调试信息捕获到日志文件中。
调试信息将有助于揭示问题。
要启动跟踪,需要指定与关心的领域对应的traceString值。
traceString值实际上是要跟踪的WebSpherePortal组件的Java完全限定类名。
使用以下步骤启用跟踪:
1.停止WorkplaceServicesExpress。
2.编辑/shared/app/config/log.properties文件。
3.取消参数traceString的注释标记,并添加相应的跟踪字符串值(见图2):
traceString=[traceString]:
[traceString]
图2.log.properties文件
注意,traceString值必须在一行上,之间没有空格,而且可以组合不同的traceString值,用分号(;)进行分隔。
4.保存log.properties文件。
5.清理WebSpherePortal日志文件夹,将所有旧的日志转移到备份文件夹中。
当WorkplaceServicesExpress重新启动时,将产生一组新的日志。
收集新的日志文件可以帮助消除旧的日志消息,从而加快识别日志消息的产生根源。
6.重新启动WorkplaceServicesExpress。
跟踪的结果写入/log/wps_.log文件。
使用的跟踪字符串参见下表。
关心的领域
相关的错误
跟踪字符串
数据库
失败的事务/死锁SQL语句错误
com.ibm.wps.datastore.*=all=enabled:
com.ibm.wps.services.datastore.*=all=enabled
身份验证
登录错误
可能与LDAP相关的身份验证问题
com.ibm.wps.engine.*=all=enabled:
com.ibm.wps.services.puma.*=all=enabled:
com.ibm.wps.puma.*=all=enabled:
com.ibm.wps.sso.*=all=enabled:
com.ibm.wps.services.authentication.*=all=enabled
访问控制
与资源权限和访问控制相关的错误
com.ibm.wps.ac.*=all=enabled
portlet
与任何portlet相关的错误
com.ibm.wps.portlets.*=all=enabled:
org.apache.jetspeed.portlet.PortletLog=all=enabled
组合模型
与页面上的错误相关的错误
装载页面和portlet的错误
com.ibm.wps.model.*=all=enabled:
position.*=all=enabled
部署
与portlet的安装相关的错误
com.ibm.wps.pe.mgr.*=all=enabled:
com.ibm.wps.services.deployment.*=all=enabled:
mand.applications.*=all=enabled:
mand.portlets.*=all=enabled
凭证库
与凭证库相关的错误
com.ibm.wps.sso.credentialvault.*=all=enabled:
mand.credentialvault.*=all=enabled:
com.ibm.wps.portletservice.credentialvault.*=all=enabled:
com.ibm.wps.services.credentialvault.*=all=enabled:
com.ibm.portal.portlet.service.credentialvault.*=all=enabled
自理
与注册和配置文件编辑相关的错误
com.ibm.wps.services.puma.*=all=enabled:
com.ibm.wps.puma.*=all=enabled
SSO
与单点登录相关的错误
com.ibm.wps.sso.*=all=enabled
引擎
与WebSpherePort