EOS故障處理指南

1、上海普元信息技術(shù)有限責(zé)任公司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

2、. ALL RIGHTS RESERVED.文檔修訂記錄序號版本號修訂日期修訂概述修訂人審核人批準(zhǔn)人備注12006-6-24EOS4HW項(xiàng)目文檔驗(yàn)收版張琳琳王蔥權(quán)晏斐劉航、袁琨目錄第1章 發(fā)現(xiàn)故障如何處理1-11.1 故障處理總體思路1-11.2 故障現(xiàn)象1-21.2.1 頁面提示異常1-31.2.2 控制臺異常1-31.2.3 業(yè)務(wù)異常1-41.3 常用問題定位方法1-4第2章 EOS Server類故障處理指導(dǎo)2-12.1 概述2-12.2 配置類故障處理流程2-12.3 集成類故障處理流程2-82.4 功能類故障處理流程2-9第3章 EOS Studio類故障處理指導(dǎo)3-13.1 概述3

3、-13.2 應(yīng)用開發(fā)類故障處理流程3-13.3 調(diào)試類故障處理流程3-8第4章 EOS Workflow類故障處理指導(dǎo)4-14.1 概述4-14.2 開發(fā)類故障處理流程4-14.3 部署類故障處理流程4-3第5章 EOS構(gòu)件庫類故障處理指導(dǎo)5-15.1 概述5-15.2 故障處理流程5-1第6章 系統(tǒng)故障處理指導(dǎo)6-16.1 概述6-16.2 故障處理流程6-1第7章 故障信息收集7-1第8章 故障信息反饋8-1第9章 附錄1 異常碼9-2第10章 附錄2 FAQ10-5第11章 附錄3 術(shù)語11-8第1章 發(fā)現(xiàn)故障如何處理本章指導(dǎo)維護(hù)人員在發(fā)現(xiàn)故障后如何處理故障。1.1 故障處理總體思路1.

4、 發(fā)現(xiàn)故障發(fā)現(xiàn)EOS（Enterprise Operation System）故障通常有以下3種表現(xiàn)形式：l 頁面提示異常l 控制臺異常l 業(yè)務(wù)異常2. 處理故障處理EOS系統(tǒng)故障的總體思路，如圖1-1所示。其中控制臺異常是指命令行界面出現(xiàn)的異常。頁面異常描述是指EOS系統(tǒng)發(fā)生異常時，頁面提示的“異常編號”、“異常描述”、“異常堆?！焙拖嚓P(guān)“解決方案”信息。圖1-1 故障處理總體思路1.2 故障現(xiàn)象故障現(xiàn)象分為頁面提示異常、控制臺異常及業(yè)務(wù)異常。1.2.1 頁面提示異常如果在頁面運(yùn)行過程中發(fā)現(xiàn)異常，請根據(jù)頁面提示信息或者本故障處理指南進(jìn)行處理，如果不能解決，請將該錯誤信息提供給華為工程師。例如

5、，系統(tǒng)運(yùn)行過程中出現(xiàn)異常，用戶可通過頁面提示的“異常描述”了解系統(tǒng)出現(xiàn)異常的原因，根據(jù)“解決方案”處理異常，如圖1-1所示。圖1-1 頁面提示1.2.2 控制臺異常在控制臺通常會發(fā)現(xiàn)以下5種故障：l 控制臺打印運(yùn)行期異常，出現(xiàn)異常堆棧。例如，EOS系統(tǒng)無法連接數(shù)據(jù)庫，控制臺拋出異常。l 控制臺提示EOS Server沒有正確啟動。例如，控制臺沒有輸出“PrimetonEnterprise Operation System start !”的字樣。l 控制臺輸出沒有l(wèi)icense的異常。例如，license文件已過期。l 控制臺輸出端口已被占用的信息。例如，端口8080已經(jīng)被綁定。l 文件格式錯

6、誤。如果控制臺出現(xiàn)告警信息，系統(tǒng)管理員可以在EOS管理控制臺中，選擇錯誤/異常編碼庫菜單項(xiàng)。查詢異常相關(guān)的描述信息和解決方案，參照解決方案處理故障。如果查詢到的異常描述不準(zhǔn)確，請查找$EOS_HOMElogs目錄（EOS_HOME=EOS安裝目錄eosserver）下的日志文件（，依次類推），如果日志文件中有關(guān)于異常原因的描述，請根據(jù)異常原因解決問題。如果日志文件中沒有關(guān)于異常原因的描述或根據(jù)異常原因仍然無法處理故障，請聯(lián)系華為工程師，并提供$EOS_HOMElogs目錄下的日志文件。1.2.3 業(yè)務(wù)異常業(yè)務(wù)異常是指期望的業(yè)務(wù)信息與實(shí)際的業(yè)務(wù)信息不一致。此類錯誤的表現(xiàn)形式是在控制臺輸出錯誤信息

7、，如果沒有輸出錯誤信息，則需要通過分析日志文件來診斷業(yè)務(wù)信息錯誤的原因。1.3 常用問題定位方法如果發(fā)生故障，請按照以下方法進(jìn)行處理：(1) 案例法查看是否有與本故障相同的案例，如果有則對照案例解決問題。(2) 排除法通過排除法，縮小故障范圍，最終找到故障發(fā)生的根源。例如，首次安裝EOS后，登錄業(yè)務(wù)控制臺時，頁面提示數(shù)據(jù)庫操作錯誤。處理方法如下：通過以下2個步驟，定位是何原因引起的數(shù)據(jù)庫問題。步驟1： 在EOS管理控制臺中測試數(shù)據(jù)庫連接，確定是否為數(shù)據(jù)庫連接問題。步驟2： 如果已排除數(shù)據(jù)庫連接問題，在EOS管理控制臺中進(jìn)行數(shù)據(jù)庫初始化，確定是否為數(shù)據(jù)庫初始化故障。(3) 日志分析法通過分析EO

8、S系統(tǒng)的相關(guān)日志文件，定位問題所在。這些日志文件主要用于調(diào)試和維護(hù)EOS系統(tǒng)，存放于$EOS_HOMElogs目錄下。(4) 調(diào)試分析法EOS Studio提供的調(diào)試器可以幫助用戶在運(yùn)行期跟蹤和調(diào)試應(yīng)用。參考調(diào)試過程中在“控制臺”和“EOS調(diào)用?！币晥D中產(chǎn)生的相關(guān)信息，有助于用戶發(fā)現(xiàn)故障原因。進(jìn)行調(diào)試之前，請“30614”端口，例如改為40614，以防數(shù)據(jù)庫配置信息混亂，避免端口沖突。具體調(diào)試方法如下：步驟1： 鼠標(biāo)右鍵選擇開發(fā)資源（如展現(xiàn)邏輯或者業(yè)務(wù)邏輯）中的某個節(jié)點(diǎn)。步驟2： 從彈出的快捷菜單中選擇添加斷點(diǎn)菜單項(xiàng)，如圖1-2所示。圖1-2 添加斷點(diǎn)步驟3： 單擊EOS Studio工具欄上

9、的按鈕，啟動調(diào)試服務(wù)器。若開發(fā)資源中包含多個項(xiàng)目，可單擊按鈕旁的下拉按鈕，在彈出的下拉列表中選中要調(diào)試的項(xiàng)目名稱，如圖1-3所示。圖1-3 啟動服務(wù)器步驟4： 成功啟動調(diào)試服務(wù)器后，通過瀏覽器訪問服務(wù)器。步驟5： 在運(yùn)行過程中，遇到開發(fā)資源中設(shè)置的調(diào)試斷點(diǎn)，服務(wù)器就會處于“掛起”狀態(tài)，等待開發(fā)者的指令（單步執(zhí)行、單步進(jìn)入、單步返回、繼續(xù)、終止、斷開連接等），如圖1-4所示。圖1-4 EOS調(diào)試步驟6： 執(zhí)行“單步執(zhí)行”操作，觀察控制臺窗口輸出，查看是否有異常情況發(fā)生。第2章 EOS Server類故障處理指導(dǎo)本章介紹EOS Server類的主要故障現(xiàn)象以及故障的處理流程。2.1 概述EOS S

10、erver類故障是指EOS系統(tǒng)配置錯誤和EOS Server運(yùn)行異常等情況。2.2 配置類故障處理流程此類故障通常表現(xiàn)為啟動EOS Server時控制臺出現(xiàn)異常，或者啟動EOS Server以后訪問EOS系統(tǒng)出現(xiàn)不能連接數(shù)據(jù)庫的情況。&說明：在處理此類故障時，需要修改相關(guān)配置文件。在修改配置文件后，必須重新啟動EOS Server，否則配置無效。1. 端口已被占用故障表現(xiàn)在同一臺機(jī)器上運(yùn)行2個EOS for JBoss實(shí)例時，這2個實(shí)例會使用相同的端口，再啟動另外一個實(shí)例后，則會出現(xiàn)端口已被占用的異常，如圖2-1所示。圖2-1 控制臺端口被占異常處理流程通過修改JBoss和EOS的端口

11、配置來解決此故障，具體步驟如下。步驟1： 修改$JBoss“8083”，“1099”，“1098”，“4444”和“4445”端口。（JBoss_HOME=EOS安裝目錄jboss-）修改位置如下：<mbean code="org.jboss.web.WebService" name="jboss:service=WebService"><attribute name="Port">8083</attribute>.<mbean code="org.jboss.naming.Nami

12、ngService" 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&

13、quot;><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“1099

14、”端口，且必須“1099”端口的修改保持一致。修改位置如下：<mbean code="org.jboss.naming.NamingService" name="jboss:service=Naming">.<attribute name="Port">1099</attribute></mbean>步驟3： 修改$JBoss文件中的“8080”和“8081”端口。修改位置如下：<Service name="jboss.web" className="

15、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&q

16、uot; connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="GBK"/>.<Connector URIEncoding="GBK" enableLookups="true" keystoreFile="keystore" port="8081" redirectPort="8443" scheme="https" secu

17、re="true" sslProtocol="TLS"/>步驟4： 修改$JBoss“8093”端口。修改位置如下：<a ttribute name="ServerBindPort">8093</attribute>步驟5： 修改$EOS_HOME“1099”端口，且必須“1099”端口的修改保持一致。修改位置如下：<configValue key="dbprovider">jnp:/localhost:1099</configValue>&說明：l 在

18、同一臺機(jī)器上執(zhí)行JBoss的負(fù)載均衡時，不能參照本指南中修改配置文件的操作。l 可以在EOS管理控制臺的“構(gòu)件包信息配置”功能模塊中為構(gòu)件包配置數(shù)據(jù)源，注意修改“1099”端口。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。2. 修改Weblogic的7001偵聽端口后無法啟動EOS Server故障表現(xiàn)修改WebLogic的“7001”偵聽端口后，無法啟動EOS Server，在操作數(shù)據(jù)庫時系統(tǒng)報告找不到數(shù)據(jù)源，控制臺錯誤信息如圖2-1所示。圖2-1 控制臺錯誤信息處理流程在數(shù)據(jù)源模式下，EO

19、S需要通過JNDI（Java Naming and Directory Interface）獲取WebLogic的數(shù)據(jù)源。EOS端口默認(rèn)配置為“7001”，如果WebLogic的“7001”偵聽端口發(fā)生改變，EOS的端口配置也要做相應(yīng)的修改。修改步驟如下：步驟1： 打開$EOS_HOMEconfigl文件。步驟2： 將該文件中“7001”端口改成與$EOS_HOMEconfigconfig.xml文件中的設(shè)置一致。<group name="DBConnect"><configValue key="dbType">sqlserver

20、2000</configValue><configValue key="context-initial-factory">weblogic.jndi.WLInitialContextFactory</configValue><configValue key="dbprovider">t3:/localhost:7001</configValue>&說明：l 在非數(shù)據(jù)源模式下，因?yàn)镋OS系統(tǒng)不取數(shù)據(jù)源，所以不修改該配置，EOS系統(tǒng)也能正常運(yùn)行。l 可以通過EOS管理控制臺的“構(gòu)件包信息配置

21、”功能模塊為構(gòu)件包配置數(shù)據(jù)源，注意修改相關(guān)端口。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。3. EOS Server無法實(shí)現(xiàn)數(shù)據(jù)庫的自動重連故障表現(xiàn)啟動EOS Server后，如果出現(xiàn)網(wǎng)絡(luò)問題而致使數(shù)據(jù)庫連接中斷，則需要重新啟動EOS Server。處理流程(1) 修改數(shù)據(jù)庫連接方式步驟1： 打開$EOS_HOME。步驟2： 將數(shù)據(jù)庫連接方式改為數(shù)據(jù)源的連接方式。修改如下：<configvalue key="single">false</configva

22、lue>(2) 修改數(shù)據(jù)源配置步驟1： 打開$JBoss。步驟2： 修改以下默認(rèn)數(shù)據(jù)源配置部分（請用戶根據(jù)實(shí)際需要配置數(shù)據(jù)源）。<local-tx-datasource><jndi-name>ProductDataSource</jndi-name><connection-url>jdbc:oracle:thin:29:1521:EOS</connection-url><driver-class>oracle.jdbc.driver.OracleDriver</driver-class&g

23、t;<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><va

24、lid-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-s

25、ql></local-tx-datasource>&說明：l 以上操作可能對系統(tǒng)訪問數(shù)據(jù)庫的性能產(chǎn)生影響，導(dǎo)致每次連接數(shù)據(jù)庫時都會自動調(diào)用該sql語句。l 在系統(tǒng)要使用多個數(shù)據(jù)源時，可以在$JBoss“l(fā)ocal-tx-datasource”配置。l 以上描述中ProductDataSource-ds.xml的配置信息需依具體環(huán)境而定。例如，在不同環(huán)境中，<connection-url>、<user-name>、<password>等配置信息也要隨之改變。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOME

26、logs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。4. 配置多個數(shù)據(jù)源時出錯故障表現(xiàn)在JBoss環(huán)境中，配置多個數(shù)據(jù)源時出現(xiàn)錯誤。處理流程(1) 檢查是否配置為數(shù)據(jù)源連接方式。步驟1： 打開$EOS_HOME。步驟2： 檢查數(shù)據(jù)庫連接方式是否為數(shù)據(jù)源連接方式。正確配置如下：<configvalue key="single">false</configvalue>(2) 在eosejbregister表中增加相應(yīng)的包配置信息。步驟1： 在EOS管理控制臺中，選擇“控制臺信息”導(dǎo)航樹中的“構(gòu)件包信息配置”節(jié)點(diǎn)。步驟2： 在構(gòu)件包信息配置

27、頁面，單擊<增加>按鈕。步驟3： 在新建構(gòu)件包信息頁面，根據(jù)實(shí)際情況增加相應(yīng)的包配置信息。(3) 修改數(shù)據(jù)源配置。步驟1： 打開$JBoss。步驟2： 修改以下默認(rèn)數(shù)據(jù)源配置部分（請用戶根據(jù)需要配置數(shù)據(jù)源）。<local-tx-datasource><jndi-name>ProductDataSource</jndi-name><connection-url>jdbc:oracle:thin:29:1521:EOS</connection-url><driver-class>oracle.

28、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-minut

29、es>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

30、>select 1 from dual</new-connection-sql></local-tx-datasource>&說明：eosejbregister表中數(shù)據(jù)源的值應(yīng)該是能夠在JNDI樹上查找到的名稱，需要參見各種應(yīng)用服務(wù)器的配置，例如JBoss為：“java:ProductDataSource”。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。5. 修改EOS配置文件后出現(xiàn)編碼錯誤故障表現(xiàn)修改EOS配置文件后，出現(xiàn)編碼錯誤。處理流程此故障是由于EO

31、S配置文件不是UTF-8格式而引起異常，建議用戶使用XMLSPY編輯器修改配置文件，這樣可以確保文件格式正確。6. 測試數(shù)據(jù)庫連接失敗故障表現(xiàn)為EOS配置SQL Server2000數(shù)據(jù)庫，測試連接失敗。處理流程此故障主要是由于操作系統(tǒng)的防火墻或SQL Server造成的。步驟1： 在命令行中輸入命令“netstat an”，確定操作系統(tǒng)的“1433”端口已打開。步驟2： 在window的控制面板中查看管理工具/服務(wù)中的內(nèi)容，確定SQL Server中沒有設(shè)置隱藏服務(wù)器。步驟3： 如果使用了第三方防火墻（非操作系統(tǒng)自帶的防火墻），請關(guān)閉第三方防火墻。步驟4： 在WinXP環(huán)境下，如果SQL S

32、erver已經(jīng)安裝SP2補(bǔ)丁，請停止SP2自帶的防火墻。&說明：打開操作系統(tǒng)的控制面板窗口，進(jìn)入安全中心對話框中，關(guān)閉防火墻即可。步驟5： 安裝SQL Server的SP3以上的補(bǔ)丁。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。7. 啟動EOS Server報異常故障表現(xiàn)在啟動EOS Server時，控制臺報如下異常信息：# Servlet initializing #處理流程此故障主要是由于EOS配置文件的格式問題所引起的。步驟1： 使用XML SPY編輯器檢查$EOS_HOMEco

33、nfig是否為合法的XML格式。步驟2： 使用XML SPY編輯器檢查$EOS_HOMEconfigeosconfig.xml是否為合法的XML格式。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。2.3 集成類故障處理流程此類故障主要表現(xiàn)為和第三方系統(tǒng)集成時出現(xiàn)的問題。無法將Struts集成到EOS系統(tǒng)中。故障表現(xiàn)在應(yīng)用部署時，無法將Struts集成到EOS系統(tǒng)中。處理流程Struts和EOS系統(tǒng)不能同時部署在同一個context中，但能以war包的方式部署到J2EE應(yīng)用中。步驟1： 如果要將S

34、truts和EOS系統(tǒng)部署在同一個war中，需要修改引用后綴。因?yàn)樗鼈兪褂玫腶ction都是“.do”。步驟2： 修改EOS中所有JSP Tag中的前綴，例如，使用文本編輯器將所有“html:”前綴的標(biāo)簽全文替換為“htmlext:”。因?yàn)樵谠O(shè)計EOS系統(tǒng)時參考了Struts，但是沒有考慮共存的問題。& 說明：將Struts集成到EOS系統(tǒng)中主要表現(xiàn)在應(yīng)用部署時的集成，與開發(fā)EOS應(yīng)用時無關(guān)。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。2.4 功能類故障處理流程此類故障表現(xiàn)為EOS提供

35、的功能不能正常使用。1. 控制臺報數(shù)據(jù)庫操作錯誤故障表現(xiàn)控制臺出現(xiàn)告警信息“數(shù)據(jù)庫操作錯誤:Underlying input stream returned zero byte”，而SQL語句卻是正確的。處理流程步驟1： 檢查SQL Server表中的“Text”類型記錄中是否包含“null”的情況。步驟2： 檢查“BL_runFormatSql”的SQL語句后是否多加了分號“;”。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。2. EOS不支持BLOB字段故障表現(xiàn)無法為帶BLOB字段的數(shù)據(jù)庫表

36、生成數(shù)據(jù)實(shí)體。處理流程對BLOB或其它不支持的字段，只能通過寫Java代碼的方式操作。&說明：雖然在EOS中導(dǎo)入生成數(shù)據(jù)實(shí)體時會報錯“不支持BLOB字段”，但EOS會過濾掉BLOB等不支持的字段，生成數(shù)據(jù)實(shí)體。3. 無法登錄業(yè)務(wù)控制臺故障表現(xiàn)無法登錄業(yè)務(wù)控制臺。處理流程EOS為用戶提供了一套基礎(chǔ)應(yīng)用框架，如“菜單管理”、“權(quán)限管理”、“機(jī)構(gòu)與用戶管理”等需要安裝系統(tǒng)表，所以在首次安裝EOS時，必須初始化數(shù)據(jù)庫，否則無法登錄業(yè)務(wù)控制臺。初始化數(shù)據(jù)庫的2種方法如下：(1) 在EOS管理控制臺中，執(zhí)行初始化數(shù)據(jù)庫操作。步驟1： 在EOS管理控制臺中，選擇導(dǎo)航樹中的“應(yīng)用管理/數(shù)據(jù)庫初始化”節(jié)

37、點(diǎn)。步驟2： 在初始化數(shù)據(jù)庫頁面，輸入待初始化的數(shù)據(jù)庫配置信息。步驟3： 單擊<初始化>按鈕。系統(tǒng)執(zhí)行初始化數(shù)據(jù)庫操作。(2) 重新安裝EOS。在安裝過程中，執(zhí)行到“配置數(shù)據(jù)庫”步驟時，選中“初始化數(shù)據(jù)庫”的單選按鈕。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。4. 無法使用上傳文件功能故障表現(xiàn)開發(fā)業(yè)務(wù)系統(tǒng)時，不能使用上傳文件功能。處理流程步驟1： 在JSP頁面中進(jìn)行上傳文件時，對應(yīng)的FORM中需要設(shè)置“enctype="multipart/form-data"

38、”和“method="post"”。配置樣例如下：<form name="frm" action="MASImport.pr.MASCOM_IMP_Product.do" enctype="multipart/form-data" method="post" >步驟2： 上傳文件的根目錄和文件大小的限制是在$JBoss_HOMEserverdefaultdeployeos4jboss的。配置樣例如下：<init-param><param-name>upload

39、Root</param-name><param-value>C:primetoneosservermasupload</param-value></init-param><init-param><param-name>maxFileSize</param-name><param-value>2000000</param-value></init-param>& 說明：l 建議將上傳文件的根目錄設(shè)為絕對路徑。l 如果上傳文件的大小為0字節(jié)，則文件不能成功上傳。l 修改該

40、web.xml文件后，需要重啟EOS Server才能生效。步驟3： 如果設(shè)置為保留上傳文件名，且上傳的文件名中包含中文，那么在某些應(yīng)用服務(wù)器下載時會出現(xiàn)故障，此時下載鏈接需要轉(zhuǎn)碼，例如，在JBOSS中需要將中文文件名顯示從ISO8859-1轉(zhuǎn)為UTF-8：real_name = new String(name.getBytes("ISO8859-1","UTF-8")”。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件）反饋給華為工程師。第3章 EOS Studio類故障處理

41、指導(dǎo)本章介紹EOS Studio類的主要故障現(xiàn)象以及故障的處理流程。3.1 概述EOS Studio類故障是指不能正常使用EOS Studio的功能或者系統(tǒng)自動退出的情況。3.2 應(yīng)用開發(fā)類故障處理流程此類故障主要表現(xiàn)為使用EOS Studio進(jìn)行開發(fā)時，不能正常使用功能。1. 因配置異常導(dǎo)致無法啟動EOS Server故障表現(xiàn)在EOS Studio中啟動EOS Server時，EOS Server一直處于啟動狀態(tài)或者提示找不到main類，并在控制臺打印“java.lang.NoClassDefFoundError: org/jboss/Main”。處理流程檢查EOS Server配置是否正確

42、，步驟如下：步驟1： 在EOS Studio中，選擇窗口/首選項(xiàng)菜單項(xiàng)。步驟2： 在首選項(xiàng)對話框中，展開“Primeton EOS”節(jié)點(diǎn)，選擇“服務(wù)器”子節(jié)點(diǎn)。節(jié)點(diǎn)右側(cè)顯示服務(wù)器編輯區(qū)，如圖3-2所示。圖3-2 配置服務(wù)器步驟3： 在“設(shè)置”頁簽中，檢查“JBoss安裝目錄”和“EOS服務(wù)器目錄”是否正確（主要檢查所設(shè)目錄是否存在）。步驟4： 選擇“類路徑”頁簽，檢查“類路徑”的配置是否正確（主要檢查所配置的run.jar和tools.jar是否存在）。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件以及$IDE_H

43、OMEeclipseworkspace.metadata）反饋給華為工程師，（IDE_HOME=EOS安裝目錄ide）。2. 系統(tǒng)提示內(nèi)存不足故障表現(xiàn)使用EOS Studio開發(fā)過程中，系統(tǒng)速度變慢，或者彈出內(nèi)存錯誤對話框，提示內(nèi)存不足，詢問是否要退出工作臺，如圖3-1所示。圖3-1 內(nèi)部錯誤處理流程此故障是由于機(jī)器內(nèi)存嚴(yán)重不足所致。(1) 在內(nèi)部錯誤對話框中，單擊<否>按鈕。不退出工作臺。此操作不會影響使用EOS Studio，但是系統(tǒng)可能會再次出現(xiàn)本對話框。建議停止EOS Server后重新啟動EOS Studio，或者執(zhí)行以下2個步驟之一。(2) 建立并執(zhí)行批處理文件。步驟1

44、： 在EOS安裝目錄中，ideeclipse下建立一個批處理文件，如startStudio.bat。步驟2： 文件內(nèi)容為“eclipse -vmargs -Xmx512m”。步驟3： 保存文件，完成創(chuàng)建文件操作。步驟4： 雙擊執(zhí)行該批處理文件。(3) 在EOS Studio的快捷啟動菜單中設(shè)置內(nèi)存參數(shù)。步驟1： 在Windows操作系統(tǒng)中，鼠標(biāo)左鍵選擇開始/程序/Primeton EOS 5/EOS Studio 5.1菜單項(xiàng)。步驟2： 從彈出的快捷菜單中選擇屬性菜單項(xiàng)。步驟3： 在EOS Studio 5.1屬性對話框的“目標(biāo)”文本框中，設(shè)置內(nèi)存參數(shù)，如圖3-2所示。圖3-2 修改參數(shù)步驟4

45、： 單擊<確定>按鈕，完成設(shè)置操作。步驟5： 重新啟動EOS Studio。& 說明：若系統(tǒng)仍提示內(nèi)存不足，請用戶繼續(xù)加大-Xmx的值（不要超過機(jī)器的物理內(nèi)存）。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件以及$IDE_HOMEeclipseworkspace.metadata）反饋給華為工程師。3. 無法處理連接線右值為空的情況故障表現(xiàn)使用EOS Studio開發(fā)時，系統(tǒng)無法處理連接線屬性的簡單表達(dá)式中右值為空的情況，如圖3-1所示。圖3-1 連接線屬性處理流程有以下2種處理方法：l 由于X

46、ML特性是不對空值情況做判斷，所以請用戶改用其他數(shù)值替代。l 使用復(fù)雜表達(dá)式來處理判斷。詳情請參見ENIP BME EOS企業(yè)操作系統(tǒng) Studio 使用指南。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件以及$IDE_HOMEeclipseworkspace.metadata）反饋給華為工程師，（IDE_HOME=EOS安裝目錄ide）。4. 無法打開EOS Studio聯(lián)機(jī)幫助故障表現(xiàn)在EOS Studio中，選擇幫助/幫助內(nèi)容菜單項(xiàng)，系統(tǒng)提示無法打開聯(lián)機(jī)幫助，如圖3-1所示。圖3-1 無法打開聯(lián)機(jī)幫助處理流程

47、修改首選項(xiàng)配置，步驟如下：步驟1： 選擇窗口/首選項(xiàng)菜單項(xiàng)。步驟2： 在首選項(xiàng)對話框中，單擊“幫助”節(jié)點(diǎn)。步驟3： 在右側(cè)“幫助”編輯區(qū)，取消選擇“始終使用外部瀏閱器”選項(xiàng)按鈕。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件以及$IDE_HOMEeclipseworkspace.metadata）反饋給華為工程師。5. 調(diào)試時控制臺異常故障表現(xiàn)在EOS Studio中進(jìn)行調(diào)試操作時，控制臺出現(xiàn)如下告警信息：java.lang.ClassNotFoundException: Exceptionat .URLClass

48、Loader$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.load

49、Class(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 com.primeton.tp.core.bi

50、zservice.state.MethodBizState.invoke(MethodBizState.java:67)at service.debug.ProcessDebugThread.run(ProcessDebugThread.java:154)at java.lang.Thread.run(Thread.java:536)處理流程此故障是由于“異常線”中的“異常類型”的類路徑不完整，導(dǎo)致無法加載Exception類。故障的處理方法是把“Exception”改為“”，如圖3-1所示。圖3-1 連接線屬性收集信息如果無法處理問題，請將故障

51、信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件以及$IDE_HOMEeclipseworkspace.metadata）反饋給華為工程師。6. 增加構(gòu)件包無法加載故障表現(xiàn)增加的構(gòu)件包無法正常加載。處理流程此故障是由于項(xiàng)目的“.reference”文件屬性為只讀導(dǎo)致無法加載構(gòu)件包。步驟1： 在“資源”視圖導(dǎo)航器中，右鍵選擇項(xiàng)目下的“.reference”文件。步驟2： 從彈出的快捷菜單中選擇屬性菜單項(xiàng)。步驟3： 在屬性對話框中，將文件屬性改為非只讀狀態(tài)。3.3 調(diào)試類故障處理流程此類故障通常表現(xiàn)為無法進(jìn)行調(diào)試和調(diào)試中斷等。1. 無法調(diào)試EOS構(gòu)件故障

52、表現(xiàn)無法繼續(xù)或者中止調(diào)試EOS構(gòu)件。處理流程EOS調(diào)試構(gòu)件失敗的原因是沒有啟動調(diào)試服務(wù)器，或者調(diào)試數(shù)據(jù)設(shè)置不正確。(1) 啟動調(diào)試服務(wù)器步驟1： 單擊EOS Studio工具欄中“啟動服務(wù)器”圖標(biāo)。步驟2： 選擇項(xiàng)目對應(yīng)的服務(wù)器，如圖3-2所示。圖3-2 選擇服務(wù)器(2) 檢查調(diào)試數(shù)據(jù)是否設(shè)置正確（涉及數(shù)據(jù)處理的邏輯必須設(shè)置調(diào)試數(shù)據(jù)后才能正常調(diào)試）。步驟1： 在EOS Studio中，單擊編輯器窗口中的“調(diào)試數(shù)據(jù)”頁簽。步驟2： 在“樹狀編輯”頁面中，單擊<case>折疊按鈕展開導(dǎo)航樹。步驟3： 請用戶根據(jù)實(shí)際情況設(shè)置調(diào)試用例或者增加節(jié)點(diǎn)。(3) 檢查展現(xiàn)邏輯或業(yè)務(wù)邏輯的屬性是否設(shè)

53、置正確（如定義參數(shù)等）。(4) 檢查調(diào)試首選項(xiàng)是否設(shè)置正確。步驟1： 選擇窗口/首選項(xiàng)菜單項(xiàng)。步驟2： 單擊<運(yùn)行/調(diào)試>折疊按鈕。步驟3： 檢查“運(yùn)行/調(diào)試”的各項(xiàng)配置是否正確。(5) 如果調(diào)試時發(fā)生暫掛，檢查是否是設(shè)置了調(diào)試斷點(diǎn)。如果設(shè)置調(diào)試斷點(diǎn)，在運(yùn)行至調(diào)試斷點(diǎn)時會發(fā)生調(diào)試暫掛，此時需要用戶手動繼續(xù)調(diào)試。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件以及$IDE_HOMEeclipseworkspace.metadata）反饋給華為工程師。2. 不能將調(diào)試信息更新到EOS Server故障表現(xiàn)調(diào)試

54、時文件不能正確同步，控制臺報錯“不能連接到server:http:/localhost:8080，能將調(diào)試信息更新到server.請檢查配置”。處理流程(1) HTTP端口不一致。請確認(rèn)在EOS Studio“首選項(xiàng)”中設(shè)置的EOS調(diào)試端口是否與服務(wù)器實(shí)際運(yùn)行時使用的端口（即$JBoss_HOME serverdefaultdeployserver.xml文件中設(shè)置的端口）一致，否則EOS Studio無法從服務(wù)器獲得調(diào)試信息。(2) 檢查$JBoss_HOMEserverdefaultdeployeos4jbossdefault.warinternetdebug目錄下的5個文件（、和）是否被

55、破壞或丟失。這5個文件是EOS Studio與EOS Server進(jìn)行調(diào)試通訊的關(guān)鍵，若文件已被破壞或丟失，則將完好的相同文件復(fù)制到該目錄下（建議操作前先備份）。(3) 檢查服務(wù)器配置是否正確。步驟1： 在EOS Studio中，選擇窗口/首選項(xiàng)菜單項(xiàng)。步驟2： 在首選項(xiàng)對話框中，展開“Primeton EOS”節(jié)點(diǎn)，選擇“服務(wù)器”子節(jié)點(diǎn)。首選項(xiàng)對話框右側(cè)顯示服務(wù)器編輯區(qū)。步驟3： 在“設(shè)置”頁簽中，檢查“JBoss安裝目錄”和“EOS服務(wù)器目錄”是否正確（主要檢查所設(shè)目錄是否存在），如圖3-2所示。圖3-2 配置服務(wù)器(4) 檢查EOS項(xiàng)目屬性中是否已設(shè)置項(xiàng)目服務(wù)器。步驟1： 在項(xiàng)目資源管理

56、視圖中，鼠標(biāo)右鍵單擊項(xiàng)目名稱。步驟2： 從彈出的快捷菜單中選擇屬性菜單項(xiàng)。步驟3： 在項(xiàng)目的屬性對話框中，從左邊列表框中選擇“EOS項(xiàng)目屬性”。步驟4： 列表框右邊顯示“EOS項(xiàng)目屬性”編輯區(qū)。步驟5： 檢查“項(xiàng)目配置”頁簽中配置是否正確。如果配置錯誤，頁簽上方會出現(xiàn)錯誤提示，如圖3-2所示。圖3-2 EOS項(xiàng)目屬性步驟6： 正確設(shè)置服務(wù)器信息，單擊<確定>按鈕，完成設(shè)置操作。& 說明：在啟動EOS Server時，必須選擇項(xiàng)目的服務(wù)器。(5) 檢查$EOS_HOMEconfig的文件中的設(shè)置是否相同且有效。(6) 如果EOS與IIS安裝在同一服務(wù)器上，啟動EOS Stud

57、io中的debug，EOS Server也會出現(xiàn)此類故障。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件以及$IDE_HOMEeclipseworkspace.metadata）反饋給華為工程師。3. EOS日志中提示找不到所調(diào)用的業(yè)務(wù)邏輯故障表現(xiàn)EOS日志中提示找不到所調(diào)用的業(yè)務(wù)邏輯。處理流程(1) 業(yè)務(wù)邏輯文件的確不存在。步驟1： 檢查調(diào)用的業(yè)務(wù)邏輯名稱是否正確。步驟2： 檢查業(yè)務(wù)邏輯的所屬構(gòu)件包是否設(shè)置正確，即檢查調(diào)用業(yè)務(wù)邏輯時設(shè)置的構(gòu)件包是否為該業(yè)務(wù)邏輯所屬構(gòu)件包。步驟3： 檢查業(yè)務(wù)邏輯是否已被刪除或沒有編

58、譯。例如，檢查業(yè)務(wù)邏輯“是否已被刪除或沒有編譯”，如果沒有該文件，則表示被刪除或沒有編譯(2) 已經(jīng)編譯并加載業(yè)務(wù)邏輯，但業(yè)務(wù)邏輯中用到的Bizlets不存在。步驟1： 檢查Bizlets的引用路徑和名稱是否正確。步驟2： 檢查是否應(yīng)該包含某個Bizlets的jar包，卻未被包含在應(yīng)用服務(wù)器的classpath中。(3) 檢查classpath中的其它jar包中是否包含了相同路徑和名稱的Bizlets。 注意：業(yè)務(wù)邏輯加載不成功的原因是在系統(tǒng)啟動時打印到日志文件eos.log中的信息，不是每次調(diào)用業(yè)務(wù)邏輯時的日志信息。收集信息如果無法處理問題，請將故障信息和相關(guān)日志文件（存放在$EOS_HOMElogs目錄下的所有以“.log”為后綴名的文件以及$IDE_HOMEeclipseworkspace.metadata）反饋給華為工程師。4. 調(diào)試熱部署不成功故障表現(xiàn)在EOSStudio中啟動了EOS Server，修改BL方法或其他Java代碼后，保存時沒有出現(xiàn)任何熱替換失敗的提示信息。但是當(dāng)執(zhí)行此段修改后的代碼時，執(zhí)行的卻仍是修改前的代碼。在進(jìn)行調(diào)