EOS故障处理指南.doc

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.COPYRIGHT 2003 by Primeton Technologies, Ltd. ALL RIGHTS RESERVED.文档修订记录序号版本号修订日期修订概述修订人审核人批准人备注11.0.02006-6-24EOS4HW项目文档验收版张琳琳王葱权晏斐刘航、袁琨目 录第1章 发现故障如何处理1-11.1 故障处理总体思路1-11.2 故障现象1-21.2.1 页面提示异常1-31.2.2 控制台异常1-31.2.3 业务异常1-41.3 常用问题定位方法1-4第2章 EOS Server类故障处理指导2-12.1 概述2-12.2 配置类故障处理流程2-12.3 集成类故障处理流程2-82.4 功能类故障处理流程2-9第3章 EOS Studio类故障处理指导3-13.1 概述3-13.2 应用开发类故障处理流程3-13.3 调试类故障处理流程3-8第4章 EOS Workflow类故障处理指导4-14.1 概述4-14.2 开发类故障处理流程4-14.3 部署类故障处理流程4-3第5章 EOS构件库类故障处理指导5-15.1 概述5-15.2 故障处理流程5-1第6章 系统故障处理指导6-16.1 概述6-16.2 故障处理流程6-1第7章 故障信息收集7-1第8章 故障信息反馈8-1第9章 附录1 异常码9-2第10章 附录2 FAQ10-5第11章 附录3 术语11-8iiiEOS企业操作系统 故障处理指南第1章 发现故障如何处理第1章 发现故障如何处理本章指导维护人员在发现故障后如何处理故障。1.1 故障处理总体思路1. 发现故障发现EOS（Enterprise Operation System）故障通常有以下3种表现形式：l 页面提示异常l 控制台异常l 业务异常2. 处理故障处理EOS系统故障的总体思路，如图1-1所示。其中控制台异常是指命令行界面出现的异常。页面异常描述是指EOS系统发生异常时，页面提示的“异常编号”、“异常描述”、“异常堆栈”和相关“解决方案”信息。图1-1 故障处理总体思路1.2 故障现象故障现象分为页面提示异常、控制台异常及业务异常。1.2.1 页面提示异常如果在页面运行过程中发现异常，请根据页面提示信息或者本故障处理指南进行处理，如果不能解决，请将该错误信息提供给华为工程师。例如，系统运行过程中出现异常，用户可通过页面提示的“异常描述”了解系统出现异常的原因，根据“解决方案”处理异常，如图1-2所示。图1-2 页面提示1.2.2 控制台异常在控制台通常会发现以下5种故障：l 控制台打印运行期异常，出现异常堆栈。例如，EOS系统无法连接数据库，控制台抛出异常。l 控制台提示EOS Server没有正确启动。例如，控制台没有输出“Primeton Enterprise Operation System start !”的字样。l 控制台输出没有license的异常。例如，license文件已过期。l 控制台输出端口已被占用的信息。例如，端口8080已经被绑定。l 系统配置文件读取错误。例如，log4j.xml文件格式错误。如果控制台出现告警信息，系统管理员可以在EOS管理控制台中，选择错误/异常编码库菜单项。查询异常相关的描述信息和解决方案，参照解决方案处理故障。如果查询到的异常描述不准确，请查找$EOS_HOMElogs目录（EOS_HOME=EOS安装目录eosserver）下的日志文件（其中eos.log为最新的日志文件，eos.log.1为次新的日志文件，依次类推），如果日志文件中有关于异常原因的描述，请根据异常原因解决问题。如果日志文件中没有关于异常原因的描述或根据异常原因仍然无法处理故障，请联系华为工程师，并提供$EOS_HOMElogs目录下的日志文件。1.2.3 业务异常业务异常是指期望的业务信息与实际的业务信息不一致。此类错误的表现形式是在控制台输出错误信息，如果没有输出错误信息，则需要通过分析日志文件来诊断业务信息错误的原因。1.3 常用问题定位方法如果发生故障，请按照以下方法进行处理：(1) 案例法查看是否有与本故障相同的案例，如果有则对照案例解决问题。(2) 排除法通过排除法，缩小故障范围，最终找到故障发生的根源。例如，首次安装EOS后，登录业务控制台时，页面提示数据库操作错误。处理方法如下：通过以下2个步骤，定位是何原因引起的数据库问题。步骤1： 在EOS管理控制台中测试数据库连接，确定是否为数据库连接问题。步骤2： 如果已排除数据库连接问题，在EOS管理控制台中进行数据库初始化，确定是否为数据库初始化故障。(3) 日志分析法通过分析EOS系统的相关日志文件，定位问题所在。这些日志文件主要用于调试和维护EOS系统，存放于$EOS_HOMElogs目录下。(4) 调试分析法EOS Studio提供的调试器可以帮助用户在运行期跟踪和调试应用。参考调试过程中在“控制台”和“EOS调用栈”视图中产生的相关信息，有助于用户发现故障原因。进行调试之前，请修改eosconfig.xml文件中的“30614”端口，例如改为40614，以防数据库配置信息混乱，避免端口冲突。具体调试方法如下：步骤1： 鼠标右键选择开发资源（如展现逻辑或者业务逻辑）中的某个节点。步骤2： 从弹出的快捷菜单中选择添加断点菜单项，如图1-5所示。图1-5 添加断点步骤3： 单击EOS Studio工具栏上的按钮，启动调试服务器。若开发资源中包含多个项目，可单击按钮旁的下拉按钮，在弹出的下拉列表中选中要调试的项目名称，如图1-6所示。图1-6 启动服务器步骤4： 成功启动调试服务器后，通过浏览器访问服务器。步骤5： 在运行过程中，遇到开发资源中设置的调试断点，服务器就会处于“挂起”状态，等待开发者的指令（单步执行、单步进入、单步返回、继续、终止、断开连接等），如图1-7所示。图1-7 EOS调试步骤6： 执行“单步执行”操作，观察控制台窗口输出，查看是否有异常情况发生。2-11ENIP BME EOS企业操作系统 故障处理指南第2章 EOS Server类故障处理指导第2章 EOS Server类故障处理指导本章介绍EOS Server类的主要故障现象以及故障的处理流程。2.1 概述EOS Server类故障是指EOS系统配置错误和EOS Server运行异常等情况。2.2 配置类故障处理流程此类故障通常表现为启动EOS Server时控制台出现异常，或者启动EOS Server以后访问EOS系统出现不能连接数据库的情况。& 说明：在处理此类故障时，需要修改相关配置文件。在修改配置文件后，必须重新启动EOS Server，否则配置无效。1. 端口已被占用故障表现在同一台机器上运行2个EOS for JBoss实例时，这2个实例会使用相同的端口，再启动另外一个实例后，则会出现端口已被占用的异常，如图2-1所示。图2-1 控制台端口被占异常处理流程通过修改JBoss和EOS的端口配置来解决此故障，具体步骤如下。步骤1： 修改$JBoss_HOMEserverdefaultconfjboss-service.xml文件中的“8083”，“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”端口。修改位置如下：.步骤4： 修改$JBoss_HOMEserverdefaultdeployjmsuil2-service.xml文件中的“8093”端口。修改位置如下：8093步骤5： 修改$EOS_HOMEconfigeosconfig.xml文件中的“1099”端口，且必须与jboss-service.xml文件中“1099”端口的修改保持一致。修改位置如下：jnp:/localhost:1099& 说明：l 在同一台机器上执行JBoss的负载均衡时，不能参照本指南中修改配置文件的操作。l 可以在EOS管理控制台的“构件包信息配置”功能模块中为构件包配置数据源，注意修改“1099”端口。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。2. 修改Weblogic的7001侦听端口后无法启动EOS Server故障表现修改WebLogic的“7001”侦听端口后，无法启动EOS Server，在操作数据库时系统报告找不到数据源，控制台错误信息如图2-2所示。图2-2 控制台错误信息处理流程在数据源模式下，EOS需要通过JNDI（Java Naming and Directory Interface）获取WebLogic的数据源。EOS端口默认配置为“7001”，如果WebLogic的“7001”侦听端口发生改变，EOS的端口配置也要做相应的修改。修改步骤如下：步骤1： 打开$EOS_HOMEconfigeosconfig.xml文件。步骤2： 将该文件中“7001”端口改成与$EOS_HOMEconfigconfig.xml文件中的设置一致。sqlserver2000weblogic.jndi.WLInitialContextFactoryt3:/localhost:7001& 说明：l 在非数据源模式下，因为EOS系统不取数据源，所以不修改该配置，EOS系统也能正常运行。l 可以通过EOS管理控制台的“构件包信息配置”功能模块为构件包配置数据源，注意修改相关端口。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。3. EOS Server无法实现数据库的自动重连故障表现启动EOS Server后，如果出现网络问题而致使数据库连接中断，则需要重新启动EOS Server。处理流程(1) 修改数据库连接方式步骤1： 打开$EOS_HOMEconfigeosconfig.xml文件。步骤2： 将数据库连接方式改为数据源的连接方式。修改如下：false(2) 修改数据源配置步骤1： 打开$JBoss_HOMEserverdefaultdeployeos4jbossProductDataSource-ds.xml文件。步骤2： 修改以下默认数据源配置部分（请用户根据实际需要配置数据源）。ProductDataSourcejdbc:oracle:thin:29:1521:EOSoracle.jdbc.driver.OracleDriverEOS5EOS55100500015org.jboss.resource.adapter.jdbc.vendor.OracleValidConnectionCheckerselect 1 from dualselect 1 from dual& 说明：l 以上操作可能对系统访问数据库的性能产生影响，导致每次连接数据库时都会自动调用该sql语句。l 在系统要使用多个数据源时，可以在$JBoss_HOMEserverdefaultdeployeos4jbossProductDataSource-ds.xml文件中增加“local-tx-datasource”配置。l 以上描述中ProductDataSource-ds.xml的配置信息需依具体环境而定。例如，在不同环境中，、等配置信息也要随之改变。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。4. 配置多个数据源时出错故障表现在JBoss环境中，配置多个数据源时出现错误。处理流程(1) 检查是否配置为数据源连接方式。步骤1： 打开$EOS_HOMEconfigeosconfig.xml文件。步骤2： 检查数据库连接方式是否为数据源连接方式。正确配置如下：false(2) 在eosejbregister表中增加相应的包配置信息。步骤1： 在EOS管理控制台中，选择“控制台信息”导航树中的“构件包信息配置”节点。步骤2： 在构件包信息配置页面，单击按钮。步骤3： 在新建构件包信息页面，根据实际情况增加相应的包配置信息。(3) 修改数据源配置。步骤1： 打开$JBoss_HOMEserverdefaultdeployeos4jbossProductDataSource-ds.xml文件。步骤2： 修改以下默认数据源配置部分（请用户根据需要配置数据源）。ProductDataSourcejdbc:oracle:thin:29:1521:EOSoracle.jdbc.driver.OracleDriverEOS5EOS55100500015org.jboss.resource.adapter.jdbc.vendor.OracleValidConnectionCheckerselect 1 from dualselect 1 from dual& 说明：eosejbregister表中数据源的值应该是能够在JNDI树上查找到的名称，需要参见各种应用服务器的配置，例如JBoss为：“java:ProductDataSource”。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。5. 修改EOS配置文件后出现编码错误故障表现修改EOS配置文件后，出现编码错误。处理流程此故障是由于EOS配置文件不是UTF-8格式而引起异常，建议用户使用XML SPY编辑器修改配置文件，这样可以确保文件格式正确。6. 测试数据库连接失败故障表现为EOS配置SQL Server2000数据库，测试连接失败。处理流程此故障主要是由于操作系统的防火墙或SQL Server造成的。步骤1： 在命令行中输入命令“netstat an”，确定操作系统的“1433”端口已打开。步骤2： 在window的控制面板中查看管理工具/服务中的内容，确定SQL Server中没有设置隐藏服务器。步骤3： 如果使用了第三方防火墙（非操作系统自带的防火墙），请关闭第三方防火墙。步骤4： 在WinXP环境下，如果SQL Server已经安装SP2补丁，请停止SP2自带的防火墙。& 说明：打开操作系统的控制面板窗口，进入安全中心对话框中，关闭防火墙即可。步骤5： 安装SQL Server的SP3以上的补丁。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。7. 启动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系统部署在同一个war中，需要修改引用后缀。因为它们使用的action都是“.do”。步骤2： 修改EOS中所有JSP Tag中的前缀，例如，使用文本编辑器将所有“html:”前缀的标签全文替换为“htmlext:”。因为在设计EOS系统时参考了Struts，但是没有考虑共存的问题。& 说明：将Struts集成到EOS系统中主要表现在应用部署时的集成，与开发EOS应用时无关。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。2.4 功能类故障处理流程此类故障表现为EOS提供的功能不能正常使用。1. 控制台报数据库操作错误故障表现控制台出现告警信息“数据库操作错误:Underlying input stream returned zero byte”，而SQL语句却是正确的。处理流程步骤1： 检查SQL Server表中的“Text”类型记录中是否包含“null”的情况。步骤2： 检查“BL_runFormatSql”的SQL语句后是否多加了分号“;”。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。2. EOS不支持BLOB字段故障表现无法为带BLOB字段的数据库表生成数据实体。处理流程对BLOB或其它不支持的字段，只能通过写Java代码的方式操作。& 说明：虽然在EOS中导入生成数据实体时会报错“不支持BLOB字段”，但EOS会过滤掉BLOB等不支持的字段，生成数据实体。3. 无法登录业务控制台故障表现无法登录业务控制台。处理流程EOS为用户提供了一套基础应用框架，如“菜单管理”、“权限管理”、“机构与用户管理”等需要安装系统表，所以在首次安装EOS时，必须初始化数据库，否则无法登录业务控制台。初始化数据库的2种方法如下：(1) 在EOS管理控制台中，执行初始化数据库操作。步骤1： 在EOS管理控制台中，选择导航树中的“应用管理/数据库初始化”节点。步骤2： 在初始化数据库页面，输入待初始化的数据库配置信息。步骤3： 单击按钮。系统执行初始化数据库操作。(2) 重新安装EOS。在安装过程中，执行到“配置数据库”步骤时，选中“初始化数据库”的单选按钮。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。4. 无法使用上传文件功能故障表现开发业务系统时，不能使用上传文件功能。处理流程步骤1： 在JSP页面中进行上传文件时，对应的FORM中需要设置“enctype=multipart/form-data”和“method=post”。配置样例如下：步骤2： 上传文件的根目录和文件大小的限制是在$JBoss_HOMEserverdefaultdeployeos4jbossdefault.warWEB-INFweb.xml文件中配置的。配置样例如下：uploadRootC:primetoneosservermasuploadmaxFileSize2000000& 说明：l 建议将上传文件的根目录设为绝对路径。l 如果上传文件的大小为0字节，则文件不能成功上传。l 修改该web.xml文件后，需要重启EOS Server才能生效。步骤3： 如果设置为保留上传文件名，且上传的文件名中包含中文，那么在某些应用服务器下载时会出现故障，此时下载链接需要转码，例如，在JBOSS中需要将中文文件名显示从ISO8859-1转为UTF-8：real_name = new String(name.getBytes(ISO8859-1,UTF-8)”。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。ENIP BME EOS企业操作系统 故障处理指南第3章 EOS Studio类故障处理指导第3章 EOS Studio类故障处理指导本章介绍EOS Studio类的主要故障现象以及故障的处理流程。3.1 概述EOS Studio类故障是指不能正常使用EOS Studio的功能或者系统自动退出的情况。3.2 应用开发类故障处理流程此类故障主要表现为使用EOS Studio进行开发时，不能正常使用功能。1. 因配置异常导致无法启动EOS Server故障表现在EOS Studio中启动EOS Server时，EOS Server一直处于启动状态或者提示找不到main类，并在控制台打印“java.lang.NoClassDefFoundError: org/jboss/Main”。处理流程检查EOS Server配置是否正确，步骤如下：步骤1： 在EOS Studio中，选择窗口/首选项菜单项。步骤2： 在首选项对话框中，展开“Primeton EOS”节点，选择“服务器”子节点。节点右侧显示服务器编辑区，如图3-2所示。图3-2 配置服务器步骤3： 在“设置”页签中，检查“JBoss安装目录”和“EOS服务器目录”是否正确（主要检查所设目录是否存在）。步骤4： 选择“类路径”页签，检查“类路径”的配置是否正确（主要检查所配置的run.jar和tools.jar是否存在）。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件以及$IDE_HOMEeclipseworkspace.metadata目录下的.log文件）反馈给华为工程师，（IDE_HOME=EOS安装目录ide）。2. 系统提示内存不足故障表现使用EOS Studio开发过程中，系统速度变慢，或者弹出内存错误对话框，提示内存不足，询问是否要退出工作台，如图3-3所示。图3-3 内部错误处理流程此故障是由于机器内存严重不足所致。(1) 在内部错误对话框中，单击按钮。不退出工作台。此操作不会影响使用EOS Studio，但是系统可能会再次出现本对话框。建议停止EOS Server后重新启动EOS Studio，或者执行以下2个步骤之一。(2) 建立并执行批处理文件。步骤1： 在EOS安装目录中，ideeclipse下建立一个批处理文件，如startStudio.bat。步骤2： 文件内容为“eclipse -vmargs -Xmx512m”。步骤3： 保存文件，完成创建文件操作。步骤4： 双击执行该批处理文件。(3) 在EOS Studio的快捷启动菜单中设置内存参数。步骤1： 在Windows操作系统中，鼠标左键选择开始/程序/Primeton EOS 5/EOS Studio 5.1菜单项。步骤2： 从弹出的快捷菜单中选择属性菜单项。步骤3： 在EOS Studio 5.1属性对话框的“目标”文本框中，设置内存参数，如图3-6所示。图3-6 修改参数步骤4： 单击按钮，完成设置操作。步骤5： 重新启动EOS Studio。& 说明：若系统仍提示内存不足，请用户继续加大-Xmx的值（不要超过机器的物理内存）。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件以及$IDE_HOMEeclipseworkspace.metadata目录下的.log文件）反馈给华为工程师。3. 无法处理连接线右值为空的情况故障表现使用EOS Studio开发时，系统无法处理连接线属性的简单表达式中右值为空的情况，如图3-7所示。图3-7 连接线属性处理流程有以下2种处理方法：l 由于XML特性是不对空值情况做判断，所以请用户改用其他数值替代。l 使用复杂表达式来处理判断。详情请参见ENIP BME EOS企业操作系统 Studio 使用指南。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件以及$IDE_HOMEeclipseworkspace.metadata目录下的.log文件）反馈给华为工程师，（IDE_HOME=EOS安装目录ide）。4. 无法打开EOS Studio联机帮助故障表现在EOS Studio中，选择帮助/帮助内容菜单项，系统提示无法打开联机帮助，如图3-8所示。图3-8 无法打开联机帮助处理流程修改首选项配置，步骤如下：步骤1： 选择窗口/首选项菜单项。步骤2： 在首选项对话框中，单击“帮助”节点。步骤3： 在右侧“帮助”编辑区，取消选择“始终使用外部浏阅器”选项按钮。收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件以及$IDE_HOMEeclipseworkspace.metadata目录下的.log文件）反馈给华为工程师。5. 调试时控制台异常故障表现在EOS Studio中进行调试操作时，控制台出现如下告警信息：java.lang.ClassNotFoundException: Exceptionat .URLClassLoader$1.run(URLClassLoader.java:198)at java.security.AccessController.doPrivileged(Native Method)at .URLClassLoader.findClass(URLClassLoader.java:186)at java.lang.ClassLoader.loadClass(ClassLoader.java:299)at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:272)at java.lang.ClassLoader.loadClass(ClassLoader.java:255)at java.lang.ClassLoader.loadClassInternal(ClassLoader.java:315)at java.lang.Class.forName0(Native Method)at java.lang.Class.forName(Class.java:140)at service.state.MethodBizState.getExceptionNextID(MethodBizState.java:104)at service.state.MethodBizState.invoke(MethodBizState.java:67)at service.debug.ProcessDebugThread.run(ProcessDebugThread.java:154)at java.lang.Thread.run(Thread.java:536)处理流程此故障是由于“异常线”中的“异常类型”的类路径不完整，导致无法加载Exception类。故障的处理方法是把“Exception”改为“java.lang.Exception”，如图3-9所示。图3-9 连接线属性收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件以及$IDE_HOMEeclipseworkspace.metadata目录下的.log文件）反馈给华为工程师。6. 增加构件包无法加载故障表现增加的构件包无法正常加载。处理流程此故障是由于项目的“.reference”文件属性为只读导致无法加载构件包。步骤1： 在“资源”视图导航器中，右键选择项目下的“.reference”文件。步骤2： 从弹出的快捷菜单中选择属性菜单项。步骤3： 在属性对话框中，将文件属性改为非只读状态。3.3 调试类故障处理流程此类故障通常表现为无法进行调试和调试中断等。1. 无法调试EOS构件故障表现无法继续或者中止调试EOS构件。处理流程EOS调试构件失败的原因是没有启动调试服务器，或者调试数据设置不正确。(1) 启动调试服务器步骤1： 单击EOS Studio工具栏中“启动服务器”图标。步骤2： 选择项目对应的服务器，如图3-12所示。图3-12 选择服务器(2) 检查调试数据是否设置正确（涉及数据处理的逻辑必须设置调试数据后才能正常调试）。步骤1： 在EOS Studio中，单击编辑器窗口中的“调试数据”页签。步骤2： 在“树状编辑”页面中，单击折叠按钮展开导航树。步骤3： 请用户根据实际情况设置调试用例或者增加节点。(3) 检查展现逻辑或业务逻辑的属性是否设置正确（如定义参数等）。(4) 检查调试首选项是否设置正确。步骤1： 选择窗口/首选项菜单项。步骤2： 单击折叠按钮。步骤3： 检查“运行/调试”的各项配置是否正确。(5) 如果调试时发生暂挂，检查是否是设置了调试断点。如果设置调试断点，在运行至调试断点时会发生调试暂挂，此时需要用户手动继续调试。3-6收集信息如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOMElogs目录下的所有以“.log”为后缀名的文件以及$IDE_HOMEeclipseworkspace.metadata目录下的.log文件）反馈给华为工程师。2. 不能将调试信息更新到EOS Server故障表现调试时文件不能正确同步，控制台报错“不能连接到server:http:/localhost:8080，能将调试信息更新到server.请检查配置”。处理流程(1) HTTP端口不一致。请确认在EOS Studio“首选项”中设置的EOS调试端口是否与服务器实际运行时使用的端口（即$JBoss_HOME serverdefaultdeployjbossweb-tomcat50.sarserver.xml文件中设置的端口）一致，否则EOS Studio无法从服务器获得调试信息。(2) 检查$JBoss_HOMEserverdefaultdeployeos4jbossdefault.warinternetdebug目录下的5个文件（bizlogicDebugger.jsp、breakpointManager.jsp、jspDebugger.jsp、prlogicDebugger.jsp和setDebugStatus.jsp）是否被破坏或丢失。这5个文件是EOS Studio与EOS Server进行调试通讯的关键，若文件已被破坏或丢失，则将完好的相同文件复制到该目录下（建议操作前先备份）。(3) 检查服务器配置是否正确。步骤1： 在EOS Studio中，选择窗口/首选项菜单项。步骤2： 在首选项对话框中，展开“Primeton EOS”节点，选择“服务器”子节点。首选项对话框右侧显示服务器编辑区。步骤3： 在“设置”页签中，检查“JBoss安装目录”和“EOS服务器目录”是否正确（主要检查所设目录是否存在），如图3-16所示。图3-16 配置服务器(4) 检查EOS项目属性中是否已设置项目服务器。步骤1： 在项目资源管理视图中，鼠标右键单击项目名称。步骤2： 从弹出的快捷菜单中选择属性菜单项。步骤3： 在项目的属性对话框中，从左边列表框中选择“EOS项目属性”。步骤4： 列表框右边显示“EOS项目属性”编辑区。步骤5： 检查“项目配置”页签中配置是否正确。如果配置错误，页签上方会出现错误提示，如图3-18所示。图3-18 EOS项目属性步骤6： 正确设置服务器信息，单击按钮，完成设置操作。& 说明：在启动EOS Server时，必须选择项目的服务器。(5) 检查$EOS_HOMEconfigeosconfig.xml文件中数据库连接的设置与Produc