EOS故障处理指南

E O S故障处理指南-CAL-FENGHAI-(2020YEAR-YICAI)_JINGBIAN
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.
文档修订记录
目录
第1章发现故障如何处理......................................................................................................... 1-1
1.1 故障处理总体思路.............................................................................................................. 1-1
1.2 故障现象............................................................................................................................. 1-2
1.2.1 页面提示异常........................................................................................................... 1-3
1.2.2 控制台异常 .............................................................................................................. 1-3
1.2.3 业务异常.................................................................................................................. 1-4
1.3 常用问题定位方法.............................................................................................................. 1-4第2章 EOS Server类故障处理指导 ........................................................................................ 2-1
2.1 概述.................................................................................................................................... 2-1
2.2 配置类故障处理流程 .......................................................................................................... 2-1
2.3 集成类故障处理流程 ........................................................................................................ 2-12
2.4 功能类故障处理流程 ........................................................................................................ 2-13第3章 EOS Studio类故障处理指导 ........................................................................................ 3-1
3.1 概述.................................................................................................................................... 3-1
3.2 应用开发类故障处理流程 ................................................................................................... 3-1
3.3 调试类故障处理流程 .......................................................................................................... 3-8第4章 EOS Workflow类故障处理指导.................................................................................... 4-1
4.1 概述.................................................................................................................................... 4-1
4.2 开发类故障处理流程 .......................................................................................................... 4-1
4.3 部署类故障处理流程 .......................................................................................................... 4-4第5章 EOS构件库类故障处理指导......................................................................................... 5-1
5.1 概述.................................................................................................................................... 5-1
5.2 故障处理流程 ..................................................................................................................... 5-1第6章系统故障处理指导......................................................................................................... 6-1
6.1 概述.................................................................................................................................... 6-1
6.2 故障处理流程 ..................................................................................................................... 6-1第7章故障信息收集................................................................................................................ 7-1第8章故障信息反馈................................................................................................................ 8-1第9章附录1 异常码................................................................................................................ 9-2第10章附录2 FAQ ............................................................................................................... 10-5第11章附录3 术语 ............................................................................................................... 11-9
第1章发现故障如何处理
本章指导维护人员在发现故障后如何处理故障。

1.1 故障处理总体思路
1. 发现故障
发现EOS（Enterprise Operation System）故障通常有以下3种表现形式：
●页面提示异常
●控制台异常
●业务异常
2. 处理故障
处理EOS系统故障的总体思路，如图1-1所示。

其中控制台异常是指命令行界面出现的异常。

页面异常描述是指EOS系统发生异常时，页面提示的“异常编号”、“异常描述”、“异常堆栈”和相关“解决方案”信息。

图1-1故障处理总体思路1.2 故障现象
故障现象分为页面提示异常、控制台异常及业务异常。

1.2.1 页面提示异常
如果在页面运行过程中发现异常，请根据页面提示信息或者本故障处理指南进行处理，如果不能解决，请将该错误信息提供给华为工程师。

例如，系统运行过程中出现异常，用户可通过页面提示的“异常描述”了解系统出现异常的原因，根据“解决方案”处理异常，如图1-2所示。

图1-2页面提示
1.2.2 控制台异常
在控制台通常会发现以下5种故障：
●控制台打印运行期异常，出现异常堆栈。

例如，EOS系统无法连接数据
库，控制台抛出异常。

●控制台提示EOS Server没有正确启动。

例如，控制台没有输出“Primeton
Enterprise Operation System start !”的字样。

●控制台输出没有license的异常。

例如，license文件已过期。

●控制台输出端口已被占用的信息。

例如，端口8080已经被绑定。

●系统配置文件读取错误。

例如，log4j.xml文件格式错误。

如果控制台出现告警信息，系统管理员可以在EOS管理控制台中，选择[错误/异常编码库]菜单项。

查询异常相关的描述信息和解决方案，参照解决方案处理故障。

如果查询到的异常描述不准确，请查找$EOS_HOME\logs目录（EOS_HOME=EOS 安装目录\eosserver）下的日志文件（其中eos.log为最新的日志文件，eos.log.1为次新的日志文件，依次类推），如果日志文件中有关于异常原因的描述，请根据异常原因解决问题。

如果日志文件中没有关于异常原因的描述或根据异常原因仍然无法处理故障，请联系华为工程师，并提供$EOS_HOME\logs目录下的日志文件。

1.2.3 业务异常
业务异常是指期望的业务信息与实际的业务信息不一致。

此类错误的表现形式是在控制台输出错误信息，如果没有输出错误信息，则需要通过分析日志文件来诊断业务信息错误的原因。

1.3 常用问题定位方法
如果发生故障，请按照以下方法进行处理：
案例法
查看是否有与本故障相同的案例，如果有则对照案例解决问题。

排除法
通过排除法，缩小故障范围，最终找到故障发生的根源。

例如，首次安装EOS后，登录业务控制台时，页面提示数据库操作错误。

处理方法如下：
通过以下2个步骤，定位是何原因引起的数据库问题。

步骤1：在EOS管理控制台中测试数据库连接，确定是否为数据库连接问题。

步骤2：如果已排除数据库连接问题，在EOS管理控制台中进行数据库初始化，确定是否为数据库初始化故障。

日志分析法
通过分析EOS系统的相关日志文件，定位问题所在。

这些日志文件主要用于调试和维护EOS系统，存放于$EOS_HOME\logs目录下。

调试分析法
EOS Studio提供的调试器可以帮助用户在运行期跟踪和调试应用。

参考调试过程中在“控制台”和“EOS调用栈”视图中产生的相关信息，有助于用户发现故障原因。

进行调试之前，请修改eosconfig.xml文件中的“30614”端口，例如改为40614，以防数据库配置信息混乱，避免端口冲突。

具体调试方法如下：
步骤1：鼠标右键选择开发资源（如展现逻辑或者业务逻辑）中的某个节点。

步骤2：从弹出的快捷菜单中选择[添加断点]菜单项，如图1-3所示。

图1-3添加断点
步骤3：单击EOS Studio工具栏上的按钮，启动调试服务器。

步骤4：若开发资源中包含多个项目，可单击按钮旁的下拉按钮▼，在弹出的下拉列表中选中要调试的项目名称，如图1-4所示。

图1-4启动服务器
步骤5：成功启动调试服务器后，通过浏览器访问服务器。

步骤6：在运行过程中，遇到开发资源中设置的调试断点，服务器就会处于“挂起”状态，等待开发者的指令（单步执行、单步进入、单步返回、继续、终止、断开连
接等），如图1-5所示。

图1-5EOS调试
步骤7：执行“单步执行”操作，观察控制台窗口输出，查看是否有异常情况发生。

第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_HOME\server\default\conf\jboss-service.xml文件中的“8083”，“1099”，“1098”，“4444”和“4445”端口。

（JBoss_HOME=EOS安装
目录\jboss-3.2.6）
修改位置如下：
<mbean code="org.jboss.web.WebService" name="jboss:service=WebService">
<attribute name="Port">8083</attribute>
...
<mbean code="org.jboss.naming.NamingService" name="jboss:service=Naming">
...
<attribute name="Port">1099</attribute>
...
<attribute name="RmiPort">1098</attribute>
...
<mbean code="org.jboss.invocation.jrmp.server.JRMPInvoker"
name="jboss:service=invoker,type=jrmp">
<attribute name="RMIObjectPort">4444</attribute>
...
<mbean code="org.jboss.invocation.pooled.server.PooledInvoker"
name="jboss:service=invoker,type=pooled">
...
<attribute name="ServerBindPort">4445</attribute>
步骤2：修改$JBoss_HOME\server\default\conf\jboss-minimal.xml文件中的“1099”端口，且必须与jboss-service.xml文件中“1099”端口的修改保持一致。

修改位置如下：
<mbean code="org.jboss.naming.NamingService" name="jboss:service=Naming">
...
<attribute name="Port">1099</attribute>
</mbean>
步骤3：修改$JBoss_HOME\server\default\deploy\jbossweb-tomcat50.sar\server.xml文件中的“8080”和“8081”端口。

修改位置如下：
<Service name="jboss.web"
className="org.jboss.web.tomcat.tc5.StandardService">
<Connector port="8080" address="${jboss.bind.address}" maxThreads="150"
minSpareThreads="25" maxSpareThreads="75" enableLookups="false"
redirectPort="8443" acceptCount="100" connectionTimeout="20000"
disableUploadTimeout="true" URIEncoding="GBK"/>
...
<Connector URIEncoding="GBK" enableLookups="true" keystoreFile="keystore"
port="8081" redirectPort="8443" scheme="https" secure="true"
sslProtocol="TLS"/>
步骤4：修改$JBoss_HOME\server\default\deploy\jms\uil2-service.xml文件中的“8093”端口。

修改位置如下：
<a ttribute name="ServerBindPort">8093</attribute>
步骤5：修改$EOS_HOME\config\eosconfig.xml文件中的“1099”端口，且必须与jboss-service.xml文件中“1099”端口的修改保持一致。

修改位置如下：
<configValue key="dbprovider">jnp://localhost:1099</configValue>
✍说明：
●在同一台机器上执行JBoss的负载均衡时，不能参照本指南中修改配置文件的
操作。

●可以在EOS管理控制台的“构件包信息配置”功能模块中为构件包配置数据
源，注意修改“1099”端口。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.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_HOME\config\eosconfig.xml文件。

步骤2：将该文件中“7001”端口改成与$EOS_HOME\config\config.xml文件中的设置一致。

<group name="DBConnect">
<configValue key="dbType">sqlserver2000</configValue>
<configValue key="context-initial-
factory">weblogic.jndi.WLInitialContextFactory</configValue>
<configValue key="dbprovider">t3://localhost:7001</configValue>
✍说明：
●在非数据源模式下，因为EOS系统不取数据源，所以不修改该配置，EOS系
统也能正常运行。

●可以通过EOS管理控制台的“构件包信息配置”功能模块为构件包配置数据
源，注意修改相关端口。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。

3. EOS Server无法实现数据库的自动重连
故障表现
启动EOS Server后，如果出现网络问题而致使数据库连接中断，则需要重新启动EOS Server。

处理流程
(1) 修改数据库连接方式
步骤1：打开$EOS_HOME\config\eosconfig.xml文件。

步骤2：将数据库连接方式改为数据源的连接方式。

修改如下：
<configvalue key="single">false</configvalue>
(2) 修改数据源配置
步骤1：打开$JBoss_HOME\server\default\deploy\eos4jboss\ProductDataSource-ds.xml 文件。

步骤2：修改以下默认数据源配置部分（请用户根据实际需要配置数据源）。

<local-tx-datasource>
<jndi-name>ProductDataSource</jndi-name>
<connection-url>jdbc:oracle:thin:@192.168.1.229:1521:EOS</connection-url>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
<user-name>EOS5</user-name>
<password>EOS5</password>
<min-pool-size>5</min-pool-size>
<max-pool-size>100</max-pool-size>
<blocking-timeout-millis>5000</blocking-timeout-millis>
<idle-timeout-minutes>15</idle-timeout-minutes>
<valid-connection-checker-class-
name>org.jboss.resource.adapter.jdbc.vendor.OracleValidConnectionChecker<
/valid-connection-checker-class-name>
<check-valid-connection-sql>select 1 from dual</check-valid-connection-
sql>
<new-connection-sql>select 1 from dual</new-connection-sql> </local-tx-datasource>
✍说明：
●以上操作可能对系统访问数据库的性能产生影响，导致每次连接数据库时都会
自动调用该sql语句。

●在系统要使用多个数据源时，可以在
$JBoss_HOME\server\default\deploy\eos4jboss\ProductDataSource-ds.xml
文件中增加“local-tx-datasource”配置。

●以上描述中ProductDataSource-ds.xml的配置信息需依具体环境而定。

例
如，在不同环境中，<connection-url>、<user-name>、<password>等配置信
息也要随之改变。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。

4. 配置多个数据源时出错
故障表现
在JBoss环境中，配置多个数据源时出现错误。

处理流程
(1) 检查是否配置为数据源连接方式。

步骤1：打开$EOS_HOME\config\eosconfig.xml文件。

步骤2：检查数据库连接方式是否为数据源连接方式。

正确配置如下：
<configvalue key="single">false</configvalue>
(2) 在eosejbregister表中增加相应的包配置信息。

步骤1：在EOS管理控制台中，选择“控制台信息”导航树中的“构件包信息配置”节点。

步骤2：在[构件包信息配置]页面，单击<增加>按钮。

步骤3：在[新建构件包信息]页面，根据实际情况增加相应的包配置信息。

(3) 修改数据源配置。

步骤1：打开$JBoss_HOME\server\default\deploy\eos4jboss\ProductDataSource-ds.xml 文件。

步骤2：修改以下默认数据源配置部分（请用户根据需要配置数据源）。

<local-tx-datasource>
<jndi-name>ProductDataSource</jndi-name>
<connection-url>jdbc:oracle:thin:@192.168.1.229:1521:EOS</connection-url>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
<user-name>EOS5</user-name>
<password>EOS5</password>
<min-pool-size>5</min-pool-size>
<max-pool-size>100</max-pool-size>
<blocking-timeout-millis>5000</blocking-timeout-millis>
<idle-timeout-minutes>15</idle-timeout-minutes>
<valid-connection-checker-class-
name>org.jboss.resource.adapter.jdbc.vendor.OracleValidConnectionChecker<
/valid-connection-checker-class-name>
<check-valid-connection-sql>select 1 from dual</check-valid-connection-
sql>
<new-connection-sql>select 1 from dual</new-connection-sql>
</local-tx-datasource>
说明：
eosejbregister表中数据源的值应该是能够在JNDI树上查找到的名称，需要参见
各种应用服务器的配置，例如JBoss为：“java:ProductDataSource”。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs\目录下的所有以“.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_HOME\logs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。

7. 启动EOS Server报异常
故障表现
在启动EOS Server时，控制台报如下异常信息：
###### Servlet initializing #####
configFile=C:\eos0412\eosserver\config\startUpConfig.xml
org.xml.sax.SAXParseException: com.primeton.crimson.parser/P-067
处理流程
此故障主要是由于EOS配置文件的格式问题所引起的。

步骤1：使用XML SPY编辑器检查$EOS_HOME\config\startUpConfig.xml是否为合法的XML格式。

步骤2：使用XML SPY编辑器检查$EOS_HOME\config\eosconfig.xml是否为合法的XML格式。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.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_HOME\logs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。

2.4 功能类故障处理流程
此类故障表现为EOS提供的功能不能正常使用。

1. 控制台报数据库操作错误
故障表现
控制台出现告警信息“数据库操作错误:Underlying input stream returned zero byte”，而SQL语句却是正确的。

处理流程
步骤1：检查SQL Server表中的“Text”类型记录中是否包含“null”的情况。

步骤2：检查“BL_runFormatSql”的SQL语句后是否多加了分号“;”。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。

2. EOS不支持BLOB字段
故障表现
无法为带BLOB字段的数据库表生成数据实体。

处理流程
对BLOB或其它不支持的字段，只能通过写Java代码的方式操作。

说明：
虽然在EOS中导入生成数据实体时会报错“不支持BLOB字段”，但EOS会过
滤掉BLOB等不支持的字段，生成数据实体。

3. 无法登录业务控制台
故障表现
无法登录业务控制台。

处理流程
EOS为用户提供了一套基础应用框架，如“菜单管理”、“权限管理”、“机构与用户管理”等需要安装系统表，所以在首次安装EOS时，必须初始化数据库，否则无法登录业务控制台。

初始化数据库的2种方法如下：
(1) 在EOS管理控制台中，执行初始化数据库操作。

步骤1：在EOS管理控制台中，选择导航树中的“应用管理/数据库初始化”节点。

步骤2：在[初始化数据库]页面，输入待初始化的数据库配置信息。

步骤3：单击<初始化>按钮。

系统执行初始化数据库操作。

(2) 重新安装EOS。

(3) 在安装过程中，执行到“配置数据库”步骤时，选中“初始化数据库”的单
选按钮。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。

4. 无法使用上传文件功能
故障表现
开发业务系统时，不能使用上传文件功能。

处理流程
步骤1：在JSP页面中进行上传文件时，对应的FORM中需要设置“enctype="multipart/form-data"”和“method="post"”。

配置样例如下：
<form name="frm" action="MASImport.pr.MASCOM_IMP_Product.do"
enctype="multipart/form-data" method="post" >
步骤2：上传文件的根目录和文件大小的限制是在$JBoss_HOME\server\default\deploy\eos4jboss\default.war\WEB-INF\web.xml
文件中配置的。

配置样例如下：
<init-param>
<param-name>uploadRoot</param-name>
<param-value>C:\primeton\eosserver\masupload</param-value>
</init-param>
<init-param>
<param-name>maxFileSize</param-name>
<param-value>2000000</param-value>
</init-param>
✍说明：
●建议将上传文件的根目录设为绝对路径。

●如果上传文件的大小为0字节，则文件不能成功上传。

●修改该web.xml文件后，需要重启EOS Server才能生效。

步骤3：如果设置为保留上传文件名，且上传的文件名中包含中文，那么在某些应用服务器下载时会出现故障，此时下载链接需要转码，例如，在JBOSS中需要将中文
文件名显示从ISO8859-1转为UTF-8：real_name = new
String(name.getBytes("ISO8859-1","UTF-8")”。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件）反馈给华为工程师。

第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类，并在控制台打印“ng.NoClassDefFoundError: org/jboss/Main”。

处理流程
检查EOS Server配置是否正确，步骤如下：
步骤1：在EOS Studio中，选择[窗口/首选项]菜单项。

步骤2：在[首选项]对话框中，展开“Primeton EOS”节点，选择“服务器”子节点。

节点右侧显示服务器编辑区，如图3-1所示。

图3-1配置服务器
步骤3：在“设置”页签中，检查“JBoss安装目录”和“EOS服务器目录”是否正确（主要检查所设目录是否存在）。

步骤4：选择“类路径”页签，检查“类路径”的配置是否正确（主要检查所配置的run.jar和tools.jar是否存在）。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件以及$IDE_HOME\eclipse\workspace\.metadata目录下的.log文件）反馈给华为工程师，（IDE_HOME=EOS安装目录\ide）。

2. 系统提示内存不足
故障表现
使用EOS Studio开发过程中，系统速度变慢，或者弹出[内存错误]对话框，提示内存不足，询问是否要退出工作台，如图3-2所示。

图3-2内部错误
处理流程
此故障是由于机器内存严重不足所致。

(1) 在[内部错误]对话框中，单击<否>按钮。

(2) 不退出工作台。

此操作不会影响使用EOS Studio，但是系统可能会再次出
现本对话框。

建议停止EOS Server后重新启动EOS Studio，或者执行以下
2个步骤之一。

(3) 建立并执行批处理文件。

步骤1：在EOS安装目录中，\ide\eclipse下建立一个批处理文件，如startStudio.bat。

步骤2：文件内容为“eclipse -vmargs -Xmx512m”。

步骤3：保存文件，完成创建文件操作。

步骤4：双击执行该批处理文件。

(4) 在EOS Studio的快捷启动菜单中设置内存参数。

步骤1：在Windows操作系统中，鼠标左键选择[开始/程序/Primeton EOS 5/EOS Studio
5.1]菜单项。

步骤2：从弹出的快捷菜单中选择[属性]菜单项。

步骤3：在[EOS Studio 5.1属性]对话框的“目标”文本框中，设置内存参数，如图3-3所示。

图3-3修改参数
步骤4：单击<确定>按钮，完成设置操作。

步骤5：重新启动EOS Studio。

说明：
若系统仍提示内存不足，请用户继续加大-Xmx的值（不要超过机器的物理内
存）。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件以及$IDE_HOME\eclipse\workspace\.metadata目录下的.log文件）反馈给华为工程师。

3. 无法处理连接线右值为空的情况
故障表现
使用EOS Studio开发时，系统无法处理连接线属性的简单表达式中右值为空的情况，如图3-4所示。

图3-4连接线属性
处理流程
有以下2种处理方法：
●由于XML特性是不对空值情况做判断，所以请用户改用其他数值替代。

●使用复杂表达式来处理判断。

详情请参见《ENIP BME EOS企业操作系统
Studio 使用指南》。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件以及$IDE_HOME\eclipse\workspace\.metadata目录下的.log文件）反馈给华为工程师，（IDE_HOME=EOS安装目录\ide）。

4. 无法打开EOS Studio联机帮助
故障表现
在EOS Studio中，选择[帮助/帮助内容]菜单项，系统提示无法打开联机帮助，如图3-5所示。

图3-5无法打开联机帮助
处理流程
修改首选项配置，步骤如下：
步骤1：选择[窗口/首选项]菜单项。

步骤2：在[首选项]对话框中，单击“帮助”节点。

步骤3：在右侧“帮助”编辑区，取消选择“始终使用外部浏阅器”选项按钮。

收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件以及$IDE_HOME\eclipse\workspace\.metadata目录下的.log文件）反馈给华为工程师。

5. 调试时控制台异常
故障表现
在EOS Studio中进行调试操作时，控制台出现如下告警信息：
ng.ClassNotFoundException: Exception
at .URLClassLoader$1.run(URLClassLoader.java:198)
at java.security.AccessController.doPrivileged(Native Method)
at .URLClassLoader.findClass(URLClassLoader.java:186)
at ng.ClassLoader.loadClass(ClassLoader.java:299)
at uncher$AppClassLoader.loadClass(Launcher.java:272)
at ng.ClassLoader.loadClass(ClassLoader.java:255)
at ng.ClassLoader.loadClassInternal(ClassLoader.java:315)
at ng.Class.forName0(Native Method)
at ng.Class.forName(Class.java:140)
at
service.state.MethodBizState.getExceptionNextID(M
ethodBizState.java:104)
at
service.state.MethodBizState.invoke(MethodBizStat
e.java:67)
at
service.debug.ProcessDebugThread.run(ProcessDebug
Thread.java:154)
at ng.Thread.run(Thread.java:536)
处理流程
此故障是由于“异常线”中的“异常类型”的类路径不完整，导致无法加载Exception 类。

故障的处理方法是把“Exception”改为“ng.Exception”，如图3-6所示。

图3-6连接线属性
收集信息
如果无法处理问题，请将故障信息和相关日志文件（存放在$EOS_HOME\logs目录下的所有以“.log”为后缀名的文件以及$IDE_HOME\eclipse\workspace\.metadata目录下的.log文件）反馈给华为工程师。

6. 增加构件包无法加载
故障表现
增加的构件包无法正常加载。

处理流程
此故障是由于项目的“.reference”文件属性为只读导致无法加载构件包。

步骤1：在“资源”视图导航器中，右键选择项目下的“.reference”文件。

步骤2：从弹出的快捷菜单中选择[属性]菜单项。

步骤3：在[属性]对话框中，将文件属性改为非只读状态。

3.3 调试类故障处理流程
此类故障通常表现为无法进行调试和调试中断等。

1. 无法调试EOS构件
故障表现
无法继续或者中止调试EOS构件。

处理流程
EOS调试构件失败的原因是没有启动调试服务器，或者调试数据设置不正确。

(1) 启动调试服务器
步骤1：单击EOS Studio工具栏中“启动服务器”图标。

步骤2：选择项目对应的服务器，如图3-7所示。

图3-7选择服务器
(2) 检查调试数据是否设置正确（涉及数据处理的逻辑必须设置调试数据后才能
正常调试）。

步骤1：在EOS Studio中，单击[编辑器]窗口中的“调试数据”页签。

步骤2：在“树状编辑”页面中，单击<case>折叠按钮展开导航树。

步骤3：请用户根据实际情况设置调试用例或者增加节点。

(3) 检查展现逻辑或业务逻辑的属性是否设置正确（如定义参数等）。

(4) 检查调试首选项是否设置正确。

步骤1：选择[窗口/首选项]菜单项。

步骤2：单击<运行/调试>折叠按钮。

步骤3：检查“运行/调试”的各项配置是否正确。

(5) 如果调试时发生暂挂，检查是否是设置了调试断点。

(6) 如果设置调试断点，在运行至调试断点时会发生调试暂挂，此时需要用户手
动继续调试。