OWS-DFP官网动态功能更新方法

官網更新方法步驟 (一)21.系统數據庫配置修改方法22.保存系统计划作业方法53.系统IP 修改方法64.系统對外接口修改方法75.官网邮箱账号配置方法76.建立flexcache 緩存, ip 修改方法87.屏蔽後台98.OCEE 配置109.停用自動建立 索引1210.修改Hibernate引用类13步驟 (二)161. 系统數據庫配置修改方法162、系统对外接口修改方法16步驟 (三)1701_SQL:17a)執行 01_SQL 中的腳本1702_module:1703_content:181.1.R11475-官网系统静态功能分离优化方案需求18步驟 (四) 發布26步驟 (五) 手工清理缓存27步驟 (六) 重新初始化工作区27步驟 (七) 建立 flexcache 緩存28步驟 (八) 清除squid缓存28步驟 (九) 檢查日志文檔28步骤(十) 上线失败回滚方案29附录 定時批量發布文件291.2.定時批量發布文件目的?291.3.基礎設定方法301.3.1.建立组织机构301.3.2.建立用户321.3.3.建立 “计划作业”35 注意更新前備份數據庫及ROOT.WAR 以用作回滾之用注：OWS-DFP官网动态功能平台的切换上线除了需要修改dfp应用包的配置文件外，还需要对官网ows应用的配置文件进行修改；步驟 (一) 部署ROOT.WAR，用UAT 的ROOT.WAR部署包 1. 系统數據庫配置修改方法l 配置文檔 - WEB-INF/applicationContext.xml!- 沒有連接洩漏情況下, 不會在生產上設定-配置說明preferredTestQuery默認值：null定義的SQL查詢, 被執行測試所有連接測試.maxIdleTime未使用而被丟棄的時間(秒), 連接可以保持在連接池。零表示空閒連接永遠不會過期。idleConnectionTestPeriod每相隔這秒數, 和大於0，C3P0的將測試所有的空閒連接.數值少於 maxIdleTimemaxPoolSize維持在池中的最大連接數。minPoolSize維持在池中的最小連接數。numHelperThreadsC3P0 是異步操作的，緩慢的 JDBC 操作通過幫助進程完成。擴展這些操作可以有效的提升性能，通過多線程實現多個操作同時被執行。默認為 3 ； )unreturnedConnectionTimeout秒。如果設置，如果應用程序取得連接，但未能釋連接即close()，在指定時間內的連接池會破壞destroy（）連接。這允許偶爾連接洩漏的應用程序生存，而不是最終耗盡連接池。零意味著沒有超時，應用程序將 close（）自己的連接。這基本上是一個壞主意，但是這是一個普遍要求的功能。修復您的應用程序，使他們不漏連接！使用此debugUnreturnedConnectionStackTraces找出借出的連接，而未被返回連接池的連接！l 配置文檔 - WEB-INF/config/pertiesdb.pool.default.jdbcUrl=jdbc:mysql:/DATABASE_IP_ADDRESS:PORT/SCHEMA db.pool.default.user=DATABASE USER NAMEdb.pool.default.password=PASSWORDdb.pool.default.maxActive=300db.pool.default.maxWait=2000db.pool.default.minIdle=10db.pool.default.maxIdle=30db.pool.default.whenExhaustedAction=growdb.pool.default.timeBetweenEvictionRuns=3600000db.pool.default.numTestsPerEvictionRun=3db.pool.default.minEvictableIdleTime=1800000db.pool.default.testQuery=select 1配置說明db.pool.default.maxActive最大活動連接數，可以在同一時間從這個池中分配.小於0沒有限制。db.pool.default.maxWait連接池等待的最大的毫秒數，如果沒有可用的連接.-1無限期地等待。db.pool.default.minIdle最小連接數，可以保持空閒，無額外的被創建.0是不創建。db.pool.default.maxIdle最大連接數，可以保持空閒，無額外的被釋放小於0沒有限制。db.pool.default.whenExhaustedAction維持在池中的最小連接數。db.pool.default.timeBetweenEvictionRunstimeBetweenEvictionRuns和minEvictableIdleTime一起使用.每timeBetweenEvictionRuns毫秒检查一次连接池中空闲的连接,把空闲时间超过minEvictableIdleTimeMillis毫秒的连接断开,直到连接池中的连接数到minIdle为止小於0，沒有空閒對象的線程將被逐出運行。db.pool.default.numTestsPerEvictionRun设定在进行后台对象清理时，每次检查对象数db.pool.default.minEvictableIdleTime连接池中连接可空闲的时间,毫秒db.pool.default.testQuerySQL查詢，從這個池中驗證連接，然後返回給調用者。如果指定了此查詢, 必須是一個 SQL SELECT語句, 至少返回一行。2. 保存系统计划作业方法官网在操作使用的过程中会添加很多定时计划作业，这些定时作业会保存在“ROOT/WEB-INF/config/”目录下的opencms-system.xml这个文件中，所以在发布新包或者上新版本的时候，需要用当前版本的opencms-system.xml文件将即将发布的ROOT.war包中的WEB-INF/config/opencms-system.xml文件覆盖，然后再发布新包，这样就可以防止计划作业被取消；3. 系统IP 修改方法l 配置文檔 - WEB-INF/config/opencms-system.xmlhttp:/WORKPLACE_SERVER_IP_ADDRESS:PORT/sites/default/WORKPLACE_SERVER_IP_ADDRESS 後台登錄 ipWEB_SERVER_HOSTNAME 網站對外域名4. 系统對外接口修改方法l 配置文檔 - WEB-INF/classes/pertiesws_exrate_service_url=汇率查询接口ws_codexrate_service_url=到付汇率查询接口 沒有使用 ws_fuel_fee_service_url=运费(国际件)查询接口ws_prod_price_service_url=运费(国内件)查询接口ws_customer_code_search_url=客户编码查询接口 ws_service_time_url=时效查询接口ws_service_time_omp_url=新时效查询接口ws_invoice_url=发票接口ws_csslogin_url=檢查網上服務大廳用戶登錄資料接口css_login_url=登錄網上服務大廳內嵌頁css_logout_url=登出網上服務大廳內嵌頁css_changelang_url=切換網上服務大廳內嵌頁顯示語言css_register_url=網上服務大廳內嵌頁的注册頁css_forget_password_url=網上服務大廳內嵌頁的忘記密碼頁css_login= 网上服务大厅登录页track_url=網上服務大廳內嵌頁的快件追蹤頁(官網自助查詢頁) track_url_index=網上服務大廳內嵌頁的快件追蹤頁(官網首頁)ws_ConsignDetail_url=香港海关清关系统编号查询接口ws_prod_price_service_url_bsp=接口平台系统-快件运费港澳台查询（燃油附加费版）接口ws_cbs_cos_advice_url=客服投诉模块系统-提供“你的建议”自助工单流转（存储）接口ws_service_time_addTimeAddr_omp_url=时效系统加时地址接口ws_conenienceStore_url=电子地图接口5. 官网邮箱账号配置方法l 配置文檔 - WEB-INFpertiesENCODING = UTF-8UNDER_DEVELOP = truemail.host =邮箱服务器（）mail.smtp.auth = 是否默认通过smtp协议（true）mail.smtp.timeout = 连接smtp协议时长（25000）mail.smtp.port =smtp协议应用端口（25）excel.saverootpath =导出的excel文档的主文件夹（/opt/openCmsEmail/）ps:excel.saverootpath对应的路径需真实存在于官网后台服务器中，如果不存在，需自行创建该文档.island =发送港澳台地区的公共邮箱.island =发送港澳台地区的公共邮箱账户.island =发送港澳台地区的公共邮箱密码mail.from.overseas=发送海外其他国家的公共邮箱mail.username.overseas =发送海外其他国家的公共邮箱账户mail.password.overseas =发送海外其他国家的公共邮箱密码6. 建立flexcache 緩存, ip 修改方法l 配置文檔 - WEB-INF/classes/pertiestomcat_url= tomcat server的 ip 地址 , 用 “,” 分隔. 如64:8080/,65:8080/ 7. 屏蔽後台只開放一台opencms 後台登錄頁. 在需屏蔽後台的主機上, 修改opencms 配置文件.WEB-INF/config/opencms-system.xml 如兩台 tomcat server, l 64 l 65不開放64後台, 修改64 的opencms 配置文件. 64:8080 /sites/default/ 修改成 /sites/default/ 8. OCEE 配置1. ocee - cluster.xml配置文件：$ OPENCMS_HOME / WEB-INF/config/ocee-cluster.xml 15 This is the secret cluster event passphrase! org.opencms.ocee.cluster.CmsClusterEventHandler ip96 6:8080/opencms/handleCluster 6 ip95 5:8080/opencms/handleCluster 5 ip95 元素：/ OpenCms/ cluster /servers / server / name說明：一個好聽的名字為服務器，例如域名。它必須跟perties的是相同的，用於確定當前workplace服務器。元素：/ OpenCms/ cluster / wp - server描述：表明workplace服務器名稱 (主服務器)，只有這workplace服務器能把事件轉發到群集中。減少發布時對服務器負荷. 減少從屬opencms 服務器對其他從屬opencms 服務器的訪問. 主opencms 服務器和 從屬opencms 服務器的配置會有不同每一台從屬opencms服務器:“”元素部分只需要配置本機及主opencms 兩項. 如上面的配置主opencms服務器:不需改動, “”元素部分保留配置主opencms 及所有從屬opencms.2. 編輯 $ OPENCMS_HOME / WEB-INF/config/pertiesl 修改 成workplace服務器名稱. 要跟其他workplace服務器不同l 修改server.ethernet.address成workplace服務器 mac地址. 要跟其他workplace服務器不同3. 編輯ocee - license.xml配置文件：$ OPENCMS_HOME / WEB-INF/config/ocee-license.xmlSF ExpressH8TWV-IN5JM-BTNJV-438MR-AZM9Kkey 是ocee的license key9. 停用自動建立 索引以下方法可減少發布時對服務器負荷.每一台從屬opencms:編輯 $ OPENCMS_HOME WebContent/WEB-INF/config/opencms-search.xml注意:完成” 7.停用自動建立 索引” 這部份後, 文件 $ OPENCMS_HOME WebContent/WEB-INF/config/opencms-search.xml 可保留作下次升級使用. 不用重複設定這部份.大約第167 行, index 元素中的 rebuid 元素 改 manual加入 standard修改前修改後Online project EN (VFS)autoOnlineensource1 Online project EN (VFS) manual Online en standard source1 大約第185 行, index 元素中的 rebuid 元素 改 manual加入 standard修改前修改後Offline project EN (VFS)autoOfflineensource1 Offline project EN (VFS) manual Offline en standard source1 10. 修改Hibernate引用类編輯 $ OPENCMS_HOME WebContent/WEB-INF/applicationContext.xml把文件中以下代码： org.hibernate.dialect.MySQLDialect true50!-create- 修改为： com.sf.www.util.MySQL5LocalDialect true 50 檢查從屬opencms的索引模式:在主opencms後台, 點cluster manager. 點 Configuration Overview點 Search Indexes每一台從屬opencms 的索引模式會是manual. ( 只有 “EN” )步驟 (二) 部署OWS-DFP_V1.0.WAR，用UAT 的OWS-DFP_V1.0.WAR部署包 1. 系统數據庫配置修改方法l 配置文檔 - WEB-INFpertiesjdbc.url=jdbc:mysql:DATABASE_IP_ADDRESS:PORT/SCHEMAjdbc.key=DEFINED KEYjdbc.username=DATABASE USER NAMEjdbc.password =PASSWORDjdbc.driverClassName =com.mysql.jdbc.Driverjdbc.initialSize=12jdbc.maxActive=255jdbc.maxWait=60000jdbc.maxIdle=5jdbc.poolPreparedStatements=true部分配置說明jdbc.driverClassName默认值：com.mysql.jdbc.Drivermysql 的数据连接驱动jdbc.url数据库连接URLjdbc.key数据库加密密钥（密文），发布人员自定义jdbc.username数据库连接名称（密文）jdbc.password数据库连接密码（密文）jdbc.initialSize最大session数jdbc.maxActive最大活动连接数，可以在同一时间从这个池中分配；小于0表示没有限制；jdbc.maxWait连接池等待的最大的毫秒数，如果没有可用的连接；-1 表示无限期地等待jdbc.maxIdle最大连接数，可以保持空闲，无额外的被创建小于0 表示不没有限制jdbc.poolPreparedStatements表示SQL预编译2、系统对外接口修改方法l 配置文檔 - WEB-INF/classes/ config / perties ws_customer_code_search_url = 客户编码查询接口ws_service_time_omp_url =新时效查询接口ws_service_time_addTimeAddr_omp_url = 时效系统加时地址接口accstr_cda_url =香港海关清关系统编号查询接口cos_client_advice_url = 客服投诉模块系统-提供“你的建议”自助工单流转（存储）接口cms_exrate_query_url = 阿修罗-汇率查询接口www_invoice_invoice_url = 阿修罗-手持终端发票查询接口bsp_rate_enquiry_url = 接口平台系统-快件运费港澳台查询（燃油附加费版）接口ws_prod_price_service_url = 阿修罗cms 快件运费查询接口（国际业务）sfmap_store_url = 电子地图门店地址查询接口ws_service_waybill_url = 网服快件追踪查单接口ws_service_emailSubscibe_url = 网服快件追踪邮件订阅功能接口ws_service_waybillSatisfactionService_url = 网服快件追踪收派员满意度调查接口ows_name=owsIP=7;localhost;;15;ows_path= （生产环境配生产域名，UAT环境配UAT域名）index_coverage_submit_host=/ （生产环境配生产域名，UAT环境配UAT域名）index_coverage_submit_url=/delivery_step/enquiry/coverageArea.html步驟 (三) 解壓patch_dfp_v1.0.rar. 從解壓後的檔, 依次序更新 01_sql, 02_module, 03_content 01_SQL:a) 執行 01_SQL 中的腳本1. 在mysql 的linux server到, 01_SQL 的位置, 假設是 /opt/sql/patch/01_SQLcd /opt/sql/patch/01_SQL02_module:1. 在opencms 後台的系統管理視圖 模組管理 通過HTTP導入模組 導入02_module中的zip. 03_content:1. 在opencms 後台的系統管理視圖 數據庫管理 通過HTTP導入 03_content 中的zip ( 注意選擇正確 站點 )1. import_from_root : 站點要選擇“/” 2. import_from_site_default : 站點要選擇“sites/default” (该步骤暂时不执行，请根据后面详细操作来执行该动作)1.1. R11475-官网系统静态功能分离优化方案需求功能描述：新起应用，将现官网上的13个功能客户编码查询，海关货物编号查询，手持终端发票查询，门店地址查询，汇率查询，应急热线查询，常用表格查询，进出口物品条例查询，常见问题，收送范围，您的建议，快件运费查询，时效查询；迁移到新应用上，然后通过官网模板嵌套新应用的方式，使整体效果保持跟官网一致；适用范围：全网；适用地区：全网所有地区语言版本。具体操作如下：一、先导出原官网功能模块的代码及页面：1、进入官网后台 系统管理视图 数据库管理 导出数据库，将官网现有的功能页面导出： 具体要导出的文档见下面列表：功能链接客户编码查询cn/(sc/en)/delivery_step/enquiry/customerCodeSearch.html海关货物编号查询hk/(sc/en/tc)/delivery_step/enquiry/CcrnSearch.html手持终端发票查询cn/(sc/en)/ support/invoice.html门店地址查询cn/sc/delivery_step/sf_stores/query_sfstores.html汇率查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/enquiry/exchangerate.html应急热线查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ hotline.html常用表格查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/formdownload.html进出口物品条例查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/enquiry/export_regulations.html常见问题（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/faq.html收送范围（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/enquiry/coverageArea.html您的建议（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ contact_us/clientAdvice.html快件运费查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/enquiry/rate_enquiry.html时效查询cn/(sc/en)/ delivery_step/enquiry/serviceTime.html2、进入官网系统管理视图 模块管理下，选择com.sf，进入编辑模块，选择导出模块，将com.sf导出；3、依照此方法依次导出com.sf.index.page，com.sf.functionpage 这两个包；4、导出完成之后，进入官网发布包目录：“ROOTWEB-INFpackages”以及“ROOTWEB-INFpackagesmodule”下，看是否分别有名称为ows_bak的zip包和com.sf.zip等3个zip包，有则表示导出成功，后续需将zip包保存到一个稳定的路径下；防止重新上包将该文档删除；5、完成备份之后，再进入 系统管理视图 模块管理 通过http导入，将content中03_content 中的import_from_root 中的zip包导入二、删除原官网功能模块的页面（以“您的建议”为例）；1、以系统管理员帐号进入官网后台，并进入“/cn/sc/contact_us/”路径下，选中clientAdvice.html、hotline.html，右键删除，进入删除页面直接将它删除；2、在文件删除页面上，默认单击ok即可；3、完成完成后，回到页面上，找到文件“clientAdvice.html、hotline.html”，右键“直接发布”，将修改后的文件发布； 4、发布完成后，打开官网首页，看菜单栏下是否已经没有该导航，且在浏览器地址栏输入地址无法访问，则表示已经删除完成；5、依次按照此方法，将其他功能页面删除，并发布：功能链接客户编码查询cn/(sc/en)/delivery_step/enquiry/customerCodeSearch.html海关货物编号查询hk/(sc/en/tc)/delivery_step/enquiry/CcrnSearch.html手持终端发票查询cn/(sc/en)/ support/invoice.html门店地址查询cn/sc/delivery_step/sf_stores/query_sfstores.html汇率查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/enquiry/exchangerate.html应急热线查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ hotline.html常用表格查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/formdownload.html进出口物品条例查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/enquiry/export_regulations.html常见问题（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/faq.html收送范围（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/enquiry/coverageArea.html您的建议（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ contact_us/clientAdvice.html快件运费查询（cn/hk/tw/sg/my/us/jp/kr）/(sc/en/tc/ja/ko)/ delivery_step/enquiry/rate_enquiry.html时效查询cn/(sc/en)/ delivery_step/enquiry/serviceTime.html三、修改需要配置的内容：1、进入官网后台 站点“site/default”下，找到文件“/_config_/sfConfig.cfg”，右键编辑进入编辑页面，修改页面的属性值； 具体修改如下：属性值DFP 嵌套链接(DFPUrlLink)UAT：http:/ :81/ows-dfpPRO：http:/ /ows-dfp首页收送范围链接(IndexIframeUrl)UAT：/coverage_area!forwardCoverArea.actionPRO：/coverage_area!forwardCoverArea.action首页收送范围维护图(ErrorImageUrl)UAT：/images/maintenance/system_busy.pngPRO：/images/maintenance/system_busy.png2、完成属性值的修改配置之后，保存，并发布；发布完成之后，进入官网首页，点击首页我的寄件服务下的收送范围，如果显示如下图所示，表示修改成功；四、导入已经配置好的文件；1、进入官网后台 系统管理视图 数据库管理 通过HTTP导入 03_content/ import_from_site_default 中的所有zip包2、成功导入包之后，会发现官网上多了类型为“iframePage”的页面，将官网上所有这些页面发布即可：3、发布完成后，进入官网首页，点击菜单栏上的各个交互功能的导航，如快件运费等，看其链接是否已经更改成对应的iframepage的链接；步驟 (三) 修复XML内容修复XML内容系统管理视图 内容工具 修复XML内容 目标文件夹:/包含所有子文件夹:YES選擇類型:SflayoutIframepageSfconfig 步驟 (四) 發布後台發布1. 後台的系統管理視圖 项目管理 2. 選擇查看项目文件： Offline (根组织机构)3. 發布以下文檔:發布時間規範: 生產環境 避免在高峰期進行發布 - 正常內容發布定在清晨03:00, 緊急情況定在當日下午7:00, 突發情況實時發布並同時通知官網管控同事.l 如果是直接發布, 用批量的方式發布, “ctrl” + 左click 複選要發布的檔案, 再用直接發布. 每次發布相隔5分鐘l 如果是定時發布, 每次定時發布相隔5分鐘相关需要发布的文件请根据步骤中所提到进行发布system/modules/com.sf.functionpage/ 下所有未发布的文件/system/modules/com.sf.index.page/ 下所有未发布的文件/system/modules/com.sf/ 下所有未发布的文件4. 在系统管理视图, 系统管理 发布队列 5. 查看发布队列, 確定发布完成,. 步驟 (五) 手工清理缓存1. 後台的系統管理視圖 缓存管理步驟 (六) 重新初始化工作区2. 後台的系統管理視圖 工作区工具3. 按“重新初始化工作区”步驟 (七) 建立 flexcache 緩存 生產環境 如有執行文檔發布, 就要到後台點一下 request.jsp. 之後待flexcache 建立完成, 關閉即可步驟 (八) 清除squid缓存登录官网squid服务器:停止squid因为squid的官网总部服务器的缓存文件都是配置在/cache目录下, 所以进入/cache目录删除此目录下的文件, 不要把这个目录删除了.cd /cacherm rf *进入squid的启动目录运行 ./squid z 生产缓存文件执行完成以后看看/cache目录下是否生成了目录Ps: 记得一定要执行此命令,不然squid不能启动成功启动squid查看squid服务器是否正常启动,运行没有问题步驟 (九) 檢查日志文檔1. 後台的系統管理視圖 工作区工具日志文件2. 下载日志, 檢查是否有錯誤信息步骤(十) 上线失败回滚方案方案一（备份数据库）、在执行任何操作中之前，先备份备份一个完整的数据库，如果切换上线失败，则应用旧的war包，并修改数据库信息为已备份的数据库；方案二（无备份数据的情况下）、1、先将导进系统的类型为iframePage的文件删除，并发布；2、在系统管理视图-模块管理下，重新导入模块“com.sf.index.page.zip”，“com.sf.zip” “com.sf.functionpage.zip”这三个模