EAS執(zhí)行腳本問題處理指南

1、EAS執(zhí)行腳本問題處理指南1. EAS腳本分類及執(zhí)行方式腳本類型存放路徑執(zhí)行方式創(chuàng)建腳本easserverpropertiessql.jar新建數(shù)據(jù)中心時調(diào)用升級腳本easserverpropertiesupgradescript在數(shù)據(jù)中心點“升級”時執(zhí)行補丁腳本easadminpatchpatchlist在補丁管理中選中補丁點“執(zhí)行腳本”按鈕多語言腳本easserverpropertiesmultilanguage_sql.jar在企業(yè)應(yīng)用中執(zhí)行“多語言初始化”2. EAS腳本執(zhí)行途徑執(zhí)行途徑操作路徑特點查詢分析器數(shù)據(jù)中心-數(shù)據(jù)庫管理-查詢窗口執(zhí)行單位：語句一次可以執(zhí)行一個或多條語句支持自定

2、義腳本執(zhí)行丁腳本補丁管理-執(zhí)行腳本執(zhí)行單位：補丁必須是已安裝補丁一次可以執(zhí)行單個或多個補丁腳本執(zhí)行入口：補丁包中的patch.xml文件升級數(shù)據(jù)中心-升級執(zhí)行單位：版本一次執(zhí)行升級版本需要的所有腳本單個腳本文件執(zhí)行失敗，會導(dǎo)致整個版本升級失敗執(zhí)行入口:每個目錄下的update.xml文件執(zhí)行腳本文件數(shù)據(jù)中心-數(shù)據(jù)庫管理-執(zhí)行腳本文件執(zhí)行單位：腳本文件可以一次選擇一個多個腳本文件多個腳本文件可以跨版本、跨補丁UNIX環(huán)境下EAS升級，建議用一臺不關(guān)機的Windows機器打開Xmanager等工具，再用這臺Windows機器遠程登陸到UNIX等EAS所在的操作系統(tǒng)進行EAS升級，以防止升級過程中界

3、面斷開，無法直觀判斷升級進度！如升級界面消失，可以查看admin.log日志判斷升級進度（UNIX可以進入easadmin目錄，使用tail f admin.log動態(tài)查看當前升級進度）3. EAS各版本腳本執(zhí)行順序版本執(zhí)行方式執(zhí)行順序EAS701EAS702EAS703新建創(chuàng)建腳本-升級-已安裝補丁腳本升級升級腳本(先升級BOS平臺版本，再升級EAS應(yīng)用版本)-已安裝補丁腳本EAS600新建創(chuàng)建腳本-SP1補丁腳本-升級-PTM038103補丁腳本-PTM037265及PTM038103之后的已安裝補丁腳本升級*（參見說明）SP1補丁腳本-升級-PTM038103補丁腳本-PTM037265

4、及PTM038103之后的已安裝補丁腳本SP1與SP2之間的BOS小補丁腳本已經(jīng)包含在SP2中，可以不需要再單獨執(zhí)行EAS6.0與PTM038103之間的EAS小補丁腳本已經(jīng)包含在PTM038103中，可以不需要再單獨執(zhí)行在安裝了PTM037265及PTM038103的EAS6.0環(huán)境中，執(zhí)行完成這2個合并補丁的腳本后，新建或升級數(shù)據(jù)中心時，還需要執(zhí)行這兩個補丁之后發(fā)布的BOS及EAS小補丁腳本（如果有安裝）升級過程中，如果跨越多個版本，系統(tǒng)會自動按順序先升級BOS的版本，然后再升級EAS版本。升級：指在數(shù)據(jù)中心對帳套進行版本升級4. EAS執(zhí)行腳本常見問題處理方法4.1屏蔽法屏蔽法是指將執(zhí)行

5、過程中出錯的腳本臨時屏蔽掉不執(zhí)行，主要適用于客戶不使用的功能或模塊相關(guān)的腳本。如客戶安裝了EAS標準版，但是只啟用了總帳、應(yīng)收、應(yīng)付、固定資產(chǎn)、HR模塊，在升級過程中出現(xiàn)生產(chǎn)制造模塊的腳本執(zhí)行出錯，由于客戶并沒有使用到生產(chǎn)制造模塊，這里就可以采用臨時屏蔽的方法將該腳本屏蔽掉后再重新升級即可。根據(jù)屏蔽范圍的不同，主要分為2種：1. 屏蔽某條語句：找到該語句所在的腳本文件并將對應(yīng)的行注釋或刪除掉2. 屏蔽某個腳本文件：找到該腳本的入口，屏蔽執(zhí)行該腳本的入口即可，不需要將該腳本文件刪除（如果只是刪除了文件而沒有刪除入口，則執(zhí)行時會提示找不到文件）。查找入口的一般思路如下：l 補丁文件：打開補丁壓縮包

6、中的patch.xml文件，找到需要屏蔽的腳本文件；l 升級腳本：定位到要屏蔽文件所在的目錄，打開該目錄下的update.xml文件，根據(jù)要屏蔽的文件名搜索，找到要屏蔽的文件所在的行。屏蔽示例如下：屏蔽前：./qm/depyzyjdzfa/deletescheme.sql ./qm/depyzyjdzfa/t_con_dynamicmetadata/t_con_dynamicmetadata.xml ./qm/depyzyjdzfa/t_con_entitypkmapping/t_con_entitypkmapping.sql屏蔽后：!-./qm/depyzyjdzfa/deleteschem

7、e.sql ./qm/depyzyjdzfa/t_con_dynamicmetadata/t_con_dynamicmetadata.xml ./qm/depyzyjdzfa/t_con_entitypkmapping/t_con_entitypkmapping.sql-找到后將該行注釋或刪除掉即可。4.2增補法增補法是指在執(zhí)行腳本過程中由于缺少依賴的對象（表、字段、視圖、索引等）導(dǎo)致腳本執(zhí)行不成功，通過先單獨執(zhí)行創(chuàng)建該依賴對象的腳本成功后，再重新執(zhí)行出錯時的腳本。查找依賴的對象方法可以參見4.4。找到依賴的腳本文件后，可以使用下面三種方法的任意一種執(zhí)行即可：1. 在補丁管理中選中包含該腳本的

8、補丁，執(zhí)行該補丁的腳本；2. 將補丁腳本文件解壓出來放到某個目錄，通過“數(shù)據(jù)中心-數(shù)據(jù)庫管理-執(zhí)行腳本文件”功能選擇該腳本執(zhí)行即可；3. 將創(chuàng)建該對象的腳本直接復(fù)制到“數(shù)據(jù)中心-數(shù)據(jù)庫管理-查詢窗口”中執(zhí)行。4.3日志上下文分析法通過執(zhí)行腳本時寫入的admin.log，定位當前執(zhí)行的腳本文件。EAS在執(zhí)行腳本文件時，在執(zhí)行這個文件完成或出錯時才開始寫入日志。因此，在該補丁文件過程中，在admin.log中還不會有該腳本的日志信息，這時就需要通過上下文分析法來判斷當前在執(zhí)行那一個腳本文件。參考示例如下：步驟1打開admin.log，定位到最后的日志記錄，查看最后執(zhí)行的文件腳本名稱：2011-08

9、-20 12:09:09,023 INFOExecute providerPTM036507/PT033441_bd_scm_im_update_table.sql successful!2011-08-20 12:09:10,498 INFOExecute providerPTM036507/PT033441_scm_im_update_table.sql successful!2011-08-20 12:09:10,512 WARN= Find format character in ?-變更描述：采購增加業(yè)務(wù)分類：15VMI采購、借入采購, skip it!2011-08-20 12:0

10、9:14,127 INFOExecute providerPTM036507/PT033441_bd_scm_common_update_data.sql successful!2011-08-20 12:09:14,255 INFOExecute providerPTM036507/PT033441_bd_scm_im_update_data.sql successful!2011-08-20 12:09:14,256 WARN= Find format character in ?-庫存余額表增加庫存類型字段, skip it!步驟2根據(jù)上面的日志信息，可以確定最后執(zhí)行腳本文件為PTM03

11、6507/PT033441_bd_scm_im_update_data.sql步驟3找到該腳本的所在目錄（easserverpropertiesupgradescriptproductPTM036507）步驟4打開該目錄下的update.xml文件，搜索步驟2中的定位的文件名PT033441_bd_scm_im_update_data.sql PT033441_scm_cal_update_table.sql PT033441_scm_cal_update_data.sql步驟5根據(jù)上面的文件內(nèi)容，可以確認當前要執(zhí)行的腳本文件為（update.xml文件中當前執(zhí)行完成的腳本文件的下一條記錄）:

12、 PT033441_scm_cal_update_table.sql。步驟6用文件編輯工具（如記事本）打開該腳本文件（PT033441_scm_cal_update_table.sql）了解該腳本執(zhí)行內(nèi)容為給庫存余額表增加4個字段。與供應(yīng)鏈負責(zé)庫存余額計算的同事聯(lián)系分析確認，在使用了供應(yīng)鏈庫存模塊的客戶中，一般該表的數(shù)據(jù)量比較大，因此添加多個字段的時間比較長，可以等待該腳本執(zhí)行完成即可。4.4依賴腳本查找方法當出現(xiàn)因缺少依賴對象而導(dǎo)致腳本執(zhí)行失敗的問題時，通常是因為當前帳套中有部分腳本沒有執(zhí)行，或者在之前有執(zhí)行出錯，但是當時沒有處理導(dǎo)致。要保證當前出錯的腳本執(zhí)行成功，必須找到依賴的對象創(chuàng)建腳本

13、并執(zhí)行。那么如何才能找到依賴對象的創(chuàng)建語法在什么地方呢？可以使用下面的方法：從第一章我們已經(jīng)了解到，腳本的存放位置有4個地方，因此，要查找依賴的腳本，也就是在這4處地方進行查找。l 多語言包：一般只有在初始化多語言時才用到，因此一般的依賴腳本問題與多語言無關(guān)l sql.jar：創(chuàng)建帳套時使用到的腳本，該部分內(nèi)容一般也不會存在沒有執(zhí)行或遺漏的情況l 補丁腳本：補丁存放路徑（easadminpatchpatchlist）下的補丁包l 升級腳本：以及升級腳本的存放位置easserverpropertiesupgradescript。前面2種基本不會用到，下面分別說明如何從后面2個地方搜索依賴的腳本。

14、在實際應(yīng)用中，一般需要將兩種方式結(jié)合起來同時使用（如在補丁文件中找不到時，再到補丁存放路徑下查找）。如果一次出現(xiàn)缺少多個依賴對象的情況，依照此方法一個一個的處理即可。補丁文件搜索補丁文件搜索是指在所有補丁壓縮包中搜索的依賴的腳本，由于補丁包采用的是zip壓縮格式，因此，需要借助第三方工具進行處理。通常使用winrar工具進行。具體方法如下：找到依賴的腳本文件后，可以使用下面三種方法的任意一種執(zhí)行即可：1. 在補丁管理中選中包含該腳本的補丁，執(zhí)行該補丁的腳本；2. 將補丁腳本文件解壓出來放到某個目錄，通過“數(shù)據(jù)中心-數(shù)據(jù)庫管理-執(zhí)行腳本文件”功能選擇該腳本執(zhí)行即可；3. 將創(chuàng)建該對象的腳本直接復(fù)

15、制到“數(shù)據(jù)中心-數(shù)據(jù)庫管理-查詢窗口”中執(zhí)行。升級路徑搜索升級路徑搜索是指在升級路徑下的腳本文件中搜索依賴的腳本文件。在該目錄下，腳本文件一般都是以文本格式保存，但由于采用了多種后綴名稱（如sql、ksql、xml等），使用操作系統(tǒng)提供的搜索方式，有時會匹配不到；并且由于缺少預(yù)覽功能，如果依賴對象存在的位置過多，必須一一打開才能定位到需要的腳本，非常耗時。因此，一般也是通過第三方工具協(xié)助處理。這里推薦使用ultraedit編輯器。具體操作方法如下：找到依賴的腳本文件后，可以使用下面三種方法的任意一種執(zhí)行即可：1. 在補丁管理中選中包含該補丁的腳本，執(zhí)行該腳本的腳本；2. 將補丁腳本文件解壓出來

16、放到某個目錄，通過“數(shù)據(jù)中心-數(shù)據(jù)庫管理-執(zhí)行腳本文件”功能選擇該腳本執(zhí)行即可；3. 將創(chuàng)建該腳本的腳本直接復(fù)制到“數(shù)據(jù)中心-數(shù)據(jù)庫管理-查詢窗口”中執(zhí)行。5. EAS腳本執(zhí)行時常見解答（公共部分）問題1：為什么DB2數(shù)據(jù)庫執(zhí)行腳本的時間特別長分析解答：由于DB2執(zhí)行的處理邏輯與其它數(shù)據(jù)庫存在差異。為避免執(zhí)行過程中出現(xiàn)中斷，在處理DB2腳本時、每執(zhí)行一個語句都會首先刪除一個一般情況下不存在的存儲過程（但如果存在而沒有刪除會導(dǎo)致整個過程中斷），因此會產(chǎn)生大量的錯誤日志。所以同等條件下，DB2數(shù)據(jù)庫環(huán)境下執(zhí)行腳本的時間會是Oracle或其它數(shù)據(jù)庫的幾倍時長。問題2：EAS6.0 SP1也是升級補丁

17、，為什么執(zhí)行該補丁的腳本不是通過“升級”方式執(zhí)行？分析解答：補丁包制作不規(guī)范導(dǎo)致，安裝該補丁后升級腳本沒有存放到“升級腳本”所在的路徑下，因此只能作為普通補丁執(zhí)行腳本。問題3：升級數(shù)據(jù)中心時，過了幾個小時仍然在執(zhí)行中，也沒有報錯，如何判斷是在正常執(zhí)行還是有問題？分析解答：根據(jù)要升級帳套的數(shù)據(jù)量的差異，升級時長也存在相應(yīng)的差異。一般帳套越大，耗費的時間越長（如有個客戶的帳套超過了200G，整個升級過程耗費了48小時才執(zhí)行完成）。檢查是否執(zhí)行正常，可以使用第4章中“日志上下文分析法”來檢查當前執(zhí)行的位置。一般情況下比較耗時的腳本包括：l 添加或修改字段、索引l 表中的數(shù)據(jù)量過大（如總帳的輔助帳余額

18、表、供應(yīng)鏈的XXXX表等）通常是上面兩種情況的組合，即在大數(shù)據(jù)量的表中添加或修改字段、索引。問題4：為什么在測試帳套中升級很快，正式帳套所耗費的時間卻非常長？分析解答：此情況一般主要原因是測試帳套的數(shù)據(jù)量較小。另外，不同的硬件配置及數(shù)據(jù)庫參數(shù)（如正式帳套長時間未更新執(zhí)行計劃、索引等）也可能存在影響。一般建議在預(yù)升級時采用將正式帳套備份恢復(fù)的方式建立測試帳套，以便較準確地評估出正式帳套的升級時長。問題5：補丁腳本執(zhí)行成功后，能否回退？分析解答：針對數(shù)據(jù)庫導(dǎo)致的修改，一旦執(zhí)行成功后，其影響就是永久性，一般是無法回退的。具體可分為以下2種情況：l 包含DDL語法的腳本：如增加字段、索引、表等，這種操

19、作一般是不可逆的，如果要反向操作的難度與復(fù)雜性高。l 不包括DDL語法的腳本：如修改、添加或刪除數(shù)據(jù)等。反向操作的難度相對較小。但是在一次升級過程中會通常會執(zhí)行多個補丁的腳本，由于數(shù)量眾多，要進行回退的評估及反向操作會非常的費時費力。理論上雖然可行，但是一般情況下不建議進行回退。6. EAS 6.0 SP1升級過程中常見問題及處理問題1：執(zhí)行腳本過程中提示插入”對話框測試”錯誤Execute provider./sql/PT027018.sql, sqlINSERT INTO T_BAS_Form VALUES (/lroPSgZF0W9xZWtaqjO7s=, N對話框測試, N對話框測試,

20、 N對話框測試, -220, , 1, NULL, NULL, , NULL, IujhGNLpS2ukptyIouI8GAfnBlk=) failed, sqlcode947 sqlstat42000,CausedbyORA-00947: not enough values,DBType=Oracle分析解答：腳本編寫不規(guī)范。在插入前由于表結(jié)構(gòu)已經(jīng)變更，而插入數(shù)據(jù)時沒有采用精確匹配，導(dǎo)致缺少列而插入失敗。由于該條數(shù)據(jù)已經(jīng)存在，故可以忽略該錯誤。問題2：執(zhí)行腳本過程中提示插入資金管理的一條數(shù)據(jù)違反唯一鍵約束Execute provider./sql/PT022871_FM_FIN_Update

21、Table.sql, sqlINSERT INTO t_bas_sysmenuitem (FCONTROLUNITID, FCREATETIME, FCREATORID, FDESCRIPTION_L1, FDESCRIPTION_L2, FDESCRIPTION_L3, FDISPLAYNAME_L1, FDISPLAYNAME_L2, FDISPLAYNAME_L3, FENABLED, FFUNCTION, FID, FIMAGEPATH, FINDUSTRY, FISLEAF, FISREPORT, FLASTUPDATETIME, FLASTUPDATEUSERID, FLEVEL,

22、 FLONGNUMBER, FNAME_L1, FNAME_L2, FNAME_L3, FNUMBER, FOPENMETHOD, FORDER, FPARENT, FSHORTCUTCODE, FSIMPLENAME, FUICLASSNAME, FUICLASSPARAM, FUIOPRT, FVISIBLE, FNOSUIT) VALUES (00000000-0000-0000-0000-000000000000CCE7AED4, TO_DATE(2009-06-23 17:25:40, YYYY-MM-DD HH24:MI:SS), 00000000-0000-0000-0000-00000000000013B7DE7F, NULL, N授信額度使用情況分析, N授信額度使用情況分析, N資金管