EOS故障处理指南.docx

1、EOS故障处理指南EOS故障处理指南PRIMETON TECHNOLOGIES, LTD.上海普元信息技术有限责任公司EOS故障处理指南No part of this document may be reproduced, stored in any electronic retrieval system, or transmitted in any form or by any means, mechanical, photocopying, recording, otherwise, without the written permission of the copyright owner

2、.COPYRIGHT 2003 by Primeton Technologies, Ltd. ALL RIGHTS RESERVED.文档修订记录序号版本号修订日期修订概述修订人审核人批准人备注11.0.02006-6-24EOS4HW项目文档验收版张琳琳王葱权晏斐刘航、袁琨第1章 发现故障如何处理本章指导维护人员在发现故障后如何处理故障。1.1 故障处理总体思路1. 发现故障发现EOS（Enterprise Operation System）故障通常有以下3种表现形式：页面提示异常控制台异常业务异常2. 处理故障处理EOS系统故障的总体思路，如图1-1所示。其中控制台异常是指命令行界面出现的

3、异常。页面异常描述是指EOS系统发生异常时，页面提示的“异常编号”、“异常描述”、“异常堆栈”和相关“解决方案”信息。图1-1 故障处理总体思路1.2 故障现象故障现象分为页面提示异常、控制台异常及业务异常。1.2.1 页面提示异常如果在页面运行过程中发现异常，请根据页面提示信息或者本故障处理指南进行处理，如果不能解决，请将该错误信息提供给华为工程师。例如，系统运行过程中出现异常，用户可通过页面提示的“异常描述”了解系统出现异常的原因，根据“解决方案”处理异常，如图1-2所示。图1-1 页面提示1.2.2 控制台异常在控制台通常会发现以下5种故障：控制台打印运行期异常，出现异常堆栈。例如，EO

4、S系统无法连接数据库，控制台抛出异常。控制台提示EOS Server没有正确启动。例如，控制台没有输出“Primeton Enterprise Operation System start !”的字样。控制台输出没有license的异常。例如，license文件已过期。控制台输出端口已被占用的信息。例如，端口8080已经被绑定。系统配置文件读取错误。例如，log4j.xml文件格式错误。如果控制台出现告警信息，系统管理员可以在EOS管理控制台中，选择错误/异常编码库菜单项。查询异常相关的描述信息和解决方案，参照解决方案处理故障。如果查询到的异常描述不准确，请查找$EOS_HOMElogs目录（

5、EOS_HOME=EOS安装目录eosserver）下的日志文件（其中eos.log为最新的日志文件，eos.log.1为次新的日志文件，依次类推），如果日志文件中有关于异常原因的描述，请根据异常原因解决问题。如果日志文件中没有关于异常原因的描述或根据异常原因仍然无法处理故障，请联系华为工程师，并提供$EOS_HOMElogs目录下的日志文件。1.2.3 业务异常业务异常是指期望的业务信息与实际的业务信息不一致。此类错误的表现形式是在控制台输出错误信息，如果没有输出错误信息，则需要通过分析日志文件来诊断业务信息错误的原因。1.3 常用问题定位方法如果发生故障，请按照以下方法进行处理：案例法查看

6、是否有与本故障相同的案例，如果有则对照案例解决问题。排除法通过排除法，缩小故障范围，最终找到故障发生的根源。例如，首次安装EOS后，登录业务控制台时，页面提示数据库操作错误。处理方法如下：通过以下2个步骤，定位是何原因引起的数据库问题。步骤1：在EOS管理控制台中测试数据库连接，确定是否为数据库连接问题。步骤2：如果已排除数据库连接问题，在EOS管理控制台中进行数据库初始化，确定是否为数据库初始化故障。日志分析法通过分析EOS系统的相关日志文件，定位问题所在。这些日志文件主要用于调试和维护EOS系统，存放于$EOS_HOMElogs目录下。调试分析法EOS Studio提供的调试器可以帮助用户

7、在运行期跟踪和调试应用。参考调试过程中在“控制台”和“EOS调用栈”视图中产生的相关信息，有助于用户发现故障原因。进行调试之前，请修改eosconfig.xml文件中的“30614”端口，例如改为40614，以防数据库配置信息混乱，避免端口冲突。具体调试方法如下：步骤3：鼠标右键选择开发资源（如展现逻辑或者业务逻辑）中的某个节点。步骤4：从弹出的快捷菜单中选择添加断点菜单项，如图1-3所示。图1-2 添加断点步骤1：单击EOS Studio工具栏上的按钮，启动调试服务器。步骤2：若开发资源中包含多个项目，可单击按钮旁的下拉按钮，在弹出的下拉列表中选中要调试的项目名称，如图1-4所示。图1-3

8、启动服务器步骤1：成功启动调试服务器后，通过浏览器访问服务器。步骤2：在运行过程中，遇到开发资源中设置的调试断点，服务器就会处于“挂起”状态，等待开发者的指令（单步执行、单步进入、单步返回、继续、终止、断开连接等），如图1-5所示。图1-4 EOS调试步骤1：执行“单步执行”操作，观察控制台窗口输出，查看是否有异常情况发生。第2章 EOS Server类故障处理指导本章介绍EOS Server类的主要故障现象以及故障的处理流程。2.1 概述EOS Server类故障是指EOS系统配置错误和EOS Server运行异常等情况。2.2 配置类故障处理流程此类故障通常表现为启动EOS Server时

9、控制台出现异常，或者启动EOS Server以后访问EOS系统出现不能连接数据库的情况。 说明：在处理此类故障时，需要修改相关配置文件。在修改配置文件后，必须重新启动EOS Server，否则配置无效。1. 端口已被占用故障表现在同一台机器上运行2个EOS for JBoss实例时，这2个实例会使用相同的端口，再启动另外一个实例后，则会出现端口已被占用的异常，如图2-1所示。图2-1 控制台端口被占异常处理流程通过修改JBoss和EOS的端口配置来解决此故障，具体步骤如下。步骤1：修改$JBoss_HOMEserverdefaultconfjboss-service.xml文件中的“8083”

10、，“1099”，“1098”，“4444”和“4445”端口。（JBoss_HOME=EOS安装目录jboss-3.2.6）修改位置如下：8083.1099.1098.4444.4445步骤2：修改$JBoss_HOMEserverdefaultconfjboss-minimal.xml文件中的“1099”端口，且必须与jboss-service.xml文件中“1099”端口的修改保持一致。修改位置如下：.1099步骤3：修改$JBoss_HOMEserverdefaultdeployjbossweb-tomcat50.sarserver.xml文件中的“8080”和“8081”端口。修改位置

11、如下：.步骤4：修改$JBoss_HOMEserverdefaultdeployjmsuil2-service.xml文件中的“8093”端口。修改位置如下：8093步骤5：修改$EOS_HOMEconfigeosconfig.xml文件中的“1099”端口，且必须与jboss-service.xml文件中“1099”端口的修改保持一致。修改位置如下：jnp:/localhost:1099 说明：在同一台机器上执行JBoss的负载均衡时，不能参照本指南中修改配置文件的操作。可以在EOS管理控制台的“构件包信息配置”功能模块中为构件包配置数据源，注意修改“1099”端口。收集信息如果无法处理问题

12、，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。2. 修改Weblogic的7001侦听端口后无法启动EOS Server故障表现修改WebLogic的“7001”侦听端口后，无法启动EOS Server，在操作数据库时系统报告找不到数据源，控制台错误信息如图2-2所示。图2-1 控制台错误信息处理流程在数据源模式下，EOS需要通过JNDI（Java Naming and Directory Interface）获取WebLogic的数据源。EOS端口默认配置为“7001”，如果WebLogic的“7001”侦听端口发生

13、改变，EOS的端口配置也要做相应的修改。修改步骤如下：步骤1：打开$EOS_HOMEconfigeosconfig.xml文件。步骤2：将该文件中“7001”端口改成与$EOS_HOMEconfigconfig.xml文件中的设置一致。sqlserver2000weblogic.jndi.WLInitialContextFactoryt3:/localhost:7001 说明：在非数据源模式下，因为EOS系统不取数据源，所以不修改该配置，EOS系统也能正常运行。可以通过EOS管理控制台的“构件包信息配置”功能模块为构件包配置数据源，注意修改相关端口。收集信息如果无法处理问题，请将故障信息和相关

14、日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。3. EOS Server无法实现数据库的自动重连故障表现启动EOS Server后，如果出现网络问题而致使数据库连接中断，则需要重新启动EOS Server。处理流程(1)修改数据库连接方式步骤1：打开$EOS_HOMEconfigeosconfig.xml文件。步骤2：将数据库连接方式改为数据源的连接方式。修改如下：false(2)修改数据源配置步骤1：打开$JBoss_HOMEserverdefaultdeployeos4jbossProductDataSource-ds.xml文件。步

15、骤2：修改以下默认数据源配置部分（请用户根据实际需要配置数据源）。ProductDataSourcejdbc:oracle:thin:192.168.1.229:1521:EOSoracle.jdbc.driver.OracleDriverEOS5EOS55100500015org.jboss.resource.adapter.jdbc.vendor.OracleValidConnectionCheckerselect 1 from dualselect 1 from dual 说明：以上操作可能对系统访问数据库的性能产生影响，导致每次连接数据库时都会自动调用该sql语句。在系统要使用多个数据

16、源时，可以在$JBoss_HOMEserverdefaultdeployeos4jbossProductDataSource-ds.xml文件中增加“local-tx-datasource”配置。以上描述中ProductDataSource-ds.xml的配置信息需依具体环境而定。例如，在不同环境中，、等配置信息也要随之改变。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。4. 配置多个数据源时出错故障表现在JBoss环境中，配置多个数据源时出现错误。处理流程(1)检查是否配置为数据源连接方式。步

17、骤1：打开$EOS_HOMEconfigeosconfig.xml文件。步骤2：检查数据库连接方式是否为数据源连接方式。正确配置如下：false(2)在eosejbregister表中增加相应的包配置信息。步骤1：在EOS管理控制台中，选择“控制台信息”导航树中的“构件包信息配置”节点。步骤2：在构件包信息配置页面，单击按钮。步骤3：在新建构件包信息页面，根据实际情况增加相应的包配置信息。(3)修改数据源配置。步骤1：打开$JBoss_HOMEserverdefaultdeployeos4jbossProductDataSource-ds.xml文件。步骤2：修改以下默认数据源配置部分（请用户

18、根据需要配置数据源）。ProductDataSourcejdbc:oracle:thin:192.168.1.229:1521:EOSoracle.jdbc.driver.OracleDriverEOS5EOS55100500015org.jboss.resource.adapter.jdbc.vendor.OracleValidConnectionCheckerselect 1 from dualselect 1 from dual 说明：eosejbregister表中数据源的值应该是能够在JNDI树上查找到的名称，需要参见各种应用服务器的配置，例如JBoss为：“java:Product

19、DataSource”。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。5. 修改EOS配置文件后出现编码错误故障表现修改EOS配置文件后，出现编码错误。处理流程此故障是由于EOS配置文件不是UTF-8格式而引起异常，建议用户使用XML SPY编辑器修改配置文件，这样可以确保文件格式正确。6. 测试数据库连接失败故障表现为EOS配置SQL Server2000数据库，测试连接失败。处理流程此故障主要是由于操作系统的防火墙或SQL Server造成的。步骤1：在命令行中输入命令“netstat an

20、”，确定操作系统的“1433”端口已打开。步骤2：在window的控制面板中查看管理工具/服务中的内容，确定SQL Server中没有设置隐藏服务器。步骤3：如果使用了第三方防火墙（非操作系统自带的防火墙），请关闭第三方防火墙。步骤4：在WinXP环境下，如果SQL Server已经安装SP2补丁，请停止SP2自带的防火墙。 说明：打开操作系统的控制面板窗口，进入安全中心对话框中，关闭防火墙即可。步骤5：安装SQL Server的SP3以上的补丁。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。7

21、. 启动EOS Server报异常故障表现在启动EOS Server时，控制台报如下异常信息：# Servlet initializing #configFile=C:eos0412eosserverconfigstartUpConfig.xmlorg.xml.sax.SAXParseException: com.primeton.crimson.parser/P-067处理流程此故障主要是由于EOS配置文件的格式问题所引起的。步骤1：使用XML SPY编辑器检查$EOS_HOMEconfigstartUpConfig.xml是否为合法的XML格式。步骤2：使用XML SPY编辑器检查$EOS_HOMEconfigeosconfig.xml是否为合法的XML格式。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。2.3 集成类故障处理流程此类故障主要表现为和第三方系统集成时出现的问题。无法将Struts集成到EOS系统中。故障表现在应用部署时，无法将Struts集成到EOS系统中。处理流程Struts和EOS系统不能同时部署在同一个context中，但能以war包的方式部署到J2EE应用中。步骤1：如果要将Struts和EOS系统部署在同