小補(bǔ)丁工具使用手冊(cè)

1、PRIMETON TECHNOLOGIES, LTD. 上海普元信息技術(shù)有限責(zé)任公司小補(bǔ)丁工具使用手冊(cè)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 2006

2、by Primeton Technologies, Ltd. ALL RIGHTS RESERVED.文檔修訂記錄序號(hào) 版本號(hào) 修訂日期 修訂概述 修訂人 審批人 備注 發(fā)布小補(bǔ)丁工具1.0 帥小艷目 錄1 小補(bǔ)丁工具簡(jiǎn)介. 4 1.1 什么是小補(bǔ)丁. 4 1.2 小補(bǔ)丁結(jié)構(gòu). 4 小補(bǔ)丁工具功能列表. 5 2.1 支持列表. 5 2.2 不支持列表. 6 2.3 特殊處理點(diǎn). 6 3 查看日志文件. 9 4 關(guān)于普元. 9 

3、1 小補(bǔ)丁工具簡(jiǎn)介1.1 什么是小補(bǔ)丁小補(bǔ)丁，是指針對(duì)某一個(gè)特定的bug 處理的補(bǔ)丁包，該補(bǔ)丁包能夠通過(guò)工具直接更新客戶環(huán)境。對(duì)于一些緊急客戶和項(xiàng)目，因?yàn)閱?wèn)題比較緊急和嚴(yán)重，影響了客戶現(xiàn)場(chǎng)項(xiàng)目的開(kāi)發(fā)，需要馬上處理和解決。小補(bǔ)丁存在的形式為：小補(bǔ)丁號(hào).zip小補(bǔ)丁以zip 壓縮包形式存在，基本的目錄結(jié)構(gòu)如下：xxxx.zip |_epds |_jars | |_sys | |_app |_web | |_z.zip/epds：該目錄中存放從EOS Studio導(dǎo)出的.epd 文件，該文件也可以通過(guò)eos-governor 部署z.zip/jars/sys:該目錄中存放eos-system.jar

4、 ，eos-system-startup.jar 這兩個(gè)jar 中的補(bǔ)丁，表現(xiàn)形態(tài)為eos-system-patch.jar ，eos-system-startup-patch.jarz.zip/jars/app:該目錄中存放的是eos-access-authorization.jar eos-access-client.jar eos-access-http.jar eos-common.jar eos-das.jar eos-data.jar eos-engine-component.jar eos-engine-core.jar eos-infra.jar eos-runtime.jar

5、 eos-sca-core.jareos-sca-implementation.jar eos-access-ejb.jar這些jar 中的補(bǔ)丁，表現(xiàn)形態(tài)為xxx-patch.jar, 如修復(fù)了eos-data.jar 中的類則為eos-data-patch.jarzWEB-INFclassescomprimetoneospresentationdefinitionAbstractEnumerator.class這個(gè)類有問(wèn)題了，那么直接將修改好的AbstractEnumerator.class 放在xxx.zip/web/WEB-INFclassescomprimetoneospresenta

6、tiondefinitionAbstractEnumerator.class 即可1.3 小補(bǔ)丁號(hào)的規(guī)則產(chǎn)品版本號(hào)+”_”+小補(bǔ)丁發(fā)布日期+補(bǔ)丁類型（產(chǎn)品級(jí)為P 、項(xiàng)目級(jí)為C ）+當(dāng)天的補(bǔ)丁自然數(shù)1.4 版本說(shuō)明發(fā)布版本號(hào)： Patch_tools_1.0適用版本：EOS_Platform6.0_GA/ BPS6.0_GA（BPS 嵌入式、BPS 非嵌入式）本次補(bǔ)丁發(fā)布的內(nèi)容： 小補(bǔ)丁工具AIXRed Hat Enterprise Linux Solaris 操作系統(tǒng)Windows Websphere6.1Weblogic9.2 應(yīng)用服務(wù)器JDK JDK1.5下載地址 Patch 包2.1 支

7、持列表支持系統(tǒng)jar 的升級(jí)，包括系統(tǒng)層和應(yīng)用的產(chǎn)品jar 文件，第三方j(luò)ar 除外；支持系統(tǒng)的epd 文件升級(jí)，需要同時(shí)更新base 、working 以及應(yīng)用目錄下的相應(yīng)資源文件；支持應(yīng)用下的任意web 資源以及WEB-INF 下資源更新； 支持一次補(bǔ)丁多應(yīng)用（eos-default 、eos-governor ）的情況； 支持對(duì)已經(jīng)打過(guò)的小補(bǔ)丁的回退功能支持一次打多個(gè)小補(bǔ)?。ㄈ绻?zip 包中包含多個(gè)以小補(bǔ)丁號(hào)為單位的小補(bǔ)?。?.2 不支持列表不支持對(duì)集群和組打小補(bǔ)丁不支持新增構(gòu)件包的Patch, 只支持更新構(gòu)件包 不支持對(duì)配置文件的補(bǔ)丁 不支持對(duì)studio 的補(bǔ)丁2.3 特殊處理點(diǎn)嵌

8、入式BPS 在tomcat 、weblogic 應(yīng)用服務(wù)器下除了數(shù)據(jù)庫(kù)驅(qū)動(dòng)外的所有的jar(第三方的以及eos 系統(tǒng)和應(yīng)用的 全部放在.war/WEB-INF/lib下嵌入式BPS 在was 下，一部分第三方j(luò)ar 會(huì)放在WAS_HOME/lib/ext下，還有一部分第三方j(luò)ar 會(huì)放在共享庫(kù)里，但是eos 的jar 全部放在war/WEB-INF/lib下 嵌入式BPS 的primetonserver 中只有working 目錄需要修改，因?yàn)闆](méi)有base 和domain的目錄3 小補(bǔ)丁工具操作手冊(cè)3.2 找到批處理腳本并編輯保存z 不同操作系統(tǒng)不同產(chǎn)品對(duì)應(yīng)有如下四種批處理腳本：windows

9、 操作系統(tǒng)，非嵌入式BPS 找到patch.bat ；打補(bǔ)丁JA V A_HOME、EOS_HOME、PATCH_FILE為必填 還原RECOVERY_FILE為必填windows 操作系統(tǒng)，嵌入式BPS 找到patch_embedded.bat；JA V A_HOME 、BPS_HOME、PATCH_FILE、WAR_DIR為必填 還原RECOVERY_FILE為必填非window 操作系統(tǒng)，非嵌入式BPS 找到patch.sh 并賦予執(zhí)行權(quán)限;JA V A_HOME、EOS_HOME、PATCH_FILE為必填還原RECOVERY_FILE為必填非window 操作系統(tǒng)，嵌入式BPS 找到

10、patch_ embedded.sh并賦予執(zhí)行權(quán)限JA V A_HOME 、BPS_HOME、PATCH_FILE、WAR_DIR為必填 還原RECOVERY_FILE為必填z 四個(gè)批處理文件中參數(shù)說(shuō)明：參數(shù)名 參數(shù)說(shuō)明 舉例說(shuō)明備注JAVA_HOMEJDK 路徑，只支持JDK1.5路徑D:EOS6testeos6_peeosserverPATCH_FILE小補(bǔ)丁包所在路徑及文件以小補(bǔ)丁號(hào)為命名就能夠一目了然看到該項(xiàng)目中打了幾個(gè)小補(bǔ)丁TEMP_DIR 小補(bǔ)丁文件解壓到的臨時(shí)目錄默認(rèn)是PATCH_FILE父目錄下新建一個(gè)TEMP 目錄打完小補(bǔ)丁后會(huì)刪除LOG_DIR打小補(bǔ)丁時(shí)的日志文件和文件備份

11、的根目錄默認(rèn)是EOS_HOME/patches或是BPS_HOME/patchesRESERVE_BACKUP_FILES是否保留備份的文件默認(rèn)是true如果為false ，則無(wú)法使用恢復(fù) RECOVERY_FILE 還原日志路徑及文件如同一個(gè)a.patch 打過(guò)2次，會(huì)在EOS_HOME/patches目錄下生成路徑對(duì)于嵌入式BPS 打補(bǔ)丁必須定義這個(gè)路徑，否則會(huì)拋出異常WAR_DIR應(yīng)用服務(wù)器部署的bps war對(duì)應(yīng)的路徑對(duì)于嵌入式BPS 打補(bǔ)丁必須定義這個(gè)路徑，否則會(huì)拋出異常3.3 運(yùn)行小補(bǔ)丁工具z 停止運(yùn)行服務(wù)器z Windows 操作系統(tǒng)中，打開(kāi)DOS 窗口，到patch.bat 所

12、在的目錄，在窗口輸入patch ；對(duì)于非 z 如選擇打補(bǔ)丁，則輸入1，如果選擇對(duì)打過(guò)的補(bǔ)丁進(jìn)行還原，則輸入2，選擇好之后，根據(jù)選擇的功能進(jìn)行操作，屏幕上會(huì)出現(xiàn) 屏幕上會(huì)顯示小補(bǔ)丁工具的參數(shù)說(shuō)明以及本次補(bǔ)丁的參數(shù)列表。z 在打好補(bǔ)丁或者還原好補(bǔ)丁之后，出現(xiàn)本次補(bǔ)丁花費(fèi)的時(shí)間，表示本次補(bǔ)丁已經(jīng)成功，如果不成功，會(huì)有異常拋出來(lái)，如下屏所示： z 按任意鍵可以結(jié)束本次小補(bǔ)丁，具體打補(bǔ)丁信息可到日志文件中去查看3.4 查看日志文件z 日志文件存放目錄以及命名規(guī)則WARNING 說(shuō)明目錄中的文件，構(gòu)件包沒(méi)有處理，因?yàn)槭遣渴鸬蕉鄠€(gè)應(yīng)用，比如governor 的構(gòu)件包在eos-default 應(yīng)用下就無(wú)法部署

13、，對(duì)于” WARNING Cannot found the action that process relativepath .”可以忽略ApplyB 構(gòu)件包，jar 之類的補(bǔ)丁開(kāi)始 ApplyE 構(gòu)件包，jar 之類的補(bǔ)丁結(jié)束 CopyBackup 復(fù)制備份文件 Copy File 復(fù)制文件 Create Dir 創(chuàng)建目錄 Create File 創(chuàng)建文件 Delete File 刪除文件RenameBackup 重命名備份文件 Append Entry 將文件增加到j(luò)ar 中 RenameBackup Recover 文件恢復(fù) CopyBackup Recover 文件恢復(fù) Recover 文件恢復(fù)說(shuō)明：如果日志文件中出現(xiàn)異常會(huì)自動(dòng)恢復(fù)到打patch 之前的文件狀態(tài)，如果沒(méi)有拋異常，請(qǐng)確認(rèn)修改的功能也已經(jīng)成功，可以手工刪除日志和備份目錄。4 關(guān)于普元普元軟件（Primeton Technologies Ltd.）是全球領(lǐng)先的SOA 中間件廠商。普元軟件始終