ESb總線產(chǎn)品維護(hù)手冊

RESInfomatic?ServiceBus企業(yè)效勞總線維護(hù)手冊RESRESInfomaticServiceBus企業(yè)效勞總線維護(hù)手冊目 錄\l“_TOC_250020“版權(quán) 2\l“_TOC_250019“聲明 2\l“_TOC_250018“免責(zé)條款 2\l“_TOC_250017“關(guān)于本手冊 3\l“_TOC_250016“本手冊適合對象 3\l“_TOC_250015“手冊組織 3\l“_TOC_250014“版本說明 3\l“_TOC_250013“RESInfomaticServiceBus產(chǎn)品簡介 4\l“_TOC_250012“主要功能 4\l“_TOC_250011“RESInfomaticRegistryandRepository維護(hù)說明 5\l“_TOC_250010“產(chǎn)品簡介 5\l“_TOC_250009“RR產(chǎn)品維護(hù)手冊 5\l“_TOC_250008“RESInfomaticConfigurationManager維護(hù)說明 7\l“_TOC_250007“產(chǎn)品簡介 7\l“_TOC_250006“CM產(chǎn)品維護(hù)手冊 7\l“_TOC_250005“RESInfomaticServiceMonitor維護(hù)說明 13\l“_TOC_250004“產(chǎn)品簡介 13\l“_TOC_250003“SM產(chǎn)品維護(hù)手冊 13\l“_TOC_250002“維護(hù)要點(diǎn) 136 關(guān)于 17\l“_TOC_250001“關(guān)于本公司 17\l“_TOC_250000“關(guān)于產(chǎn)品及文檔更 171版權(quán)北京銳易特軟件技術(shù)對RESInfomatic?ServiceBus企業(yè)效勞總線產(chǎn)品擁有學(xué)問產(chǎn)權(quán)，受《中華人民共和國著作權(quán)法權(quán)條約、法律、法規(guī)，及其它學(xué)問產(chǎn)權(quán)法律和條約保護(hù)。聲明本文件的版權(quán)和最終解釋權(quán)歸北京銳易特軟件技術(shù)全部。未經(jīng)北京銳易特軟件技術(shù)事先書面許可，不得以任何方式對本文件及全部程序、圖文內(nèi)容做全部或局部復(fù)制、公布、轉(zhuǎn)載或修改。北京銳易特軟件技術(shù)保存不事先通知就可以自行更改本文件中信息的權(quán)利，并對由此造成的損失不擔(dān)當(dāng)任何責(zé)任。本文件所涉及的非北京銳易特軟件技術(shù)軟件產(chǎn)品和技術(shù)，僅作為學(xué)問傳播使用，不涉及任何商業(yè)利益，北京銳易特軟件技術(shù)對此不擔(dān)當(dāng)任何法律責(zé)任。免責(zé)條款北京銳易特軟件技術(shù)保存不事先通知就可以自行更改本文件中信息的權(quán)利文件的最終解釋權(quán)，并對由此造成的損失不擔(dān)當(dāng)任何責(zé)任。本文件所涉及的非北京銳易特軟件技術(shù)軟件產(chǎn)品和技術(shù)，僅作為學(xué)問傳播使用，不涉及任何商業(yè)利益。北京銳易特軟件技術(shù)對此不擔(dān)當(dāng)任何法律責(zé)任。北京銳易特軟件技術(shù)在任何狀況下均不就因使用或不能使用本產(chǎn)品而發(fā)生的損失〔包括但不限于業(yè)務(wù)中斷、業(yè)務(wù)信息、文檔、數(shù)據(jù)喪失及其他經(jīng)濟(jì)損失〕擔(dān)當(dāng)賠償責(zé)任。2關(guān)于本手冊本手冊適合對象本手冊主要面對以下集成團(tuán)隊(duì)成員：企業(yè)效勞總線治理人員—供給對企業(yè)效勞總線各治理工具日常維護(hù)手段及常見問題解決方法。手冊組織本手冊共四章。第一章是本手冊的總體描述，包括手冊使用對象，手冊的組織構(gòu)造和版本說明；其次章簡要介紹企業(yè)效勞總線功能第三章具體介紹RR的維護(hù)說明；第四章具體介紹CM的維護(hù)說明；第五章具體介紹SM的維護(hù)說明；版本說明RESInfomaticServiceBus企業(yè)效勞總線維護(hù)手冊Version1.0。3RESInfomaticServiceBus產(chǎn)品簡介主要功能RESInfomaticServiceBus企業(yè)效勞總線承受基于分布式SOA架構(gòu)的策略，通過注冊/存儲中心〔RESInfomaticRegistryandRepository〕為分布在不同物理位置的效勞供給底層信息，建設(shè)、實(shí)現(xiàn)信息共享、到達(dá)業(yè)務(wù)互通的重要原則和最正確支持手段。通過面對效勞架構(gòu)，實(shí)現(xiàn)了可構(gòu)建基于面對效勞的、松耦合的、敏捷拆分的信息交換平臺，完成了動態(tài)鏈接、智能路由、信息流轉(zhuǎn)等效勞總線核心功能，并供給了協(xié)議轉(zhuǎn)換、安全掌握等根底速便捷的完成SOA整合環(huán)境下總線的搭建工作供給了架構(gòu)支持。企業(yè)效勞總線下包括適配器、消息代理、效勞代理三種類型的效勞。其中，適配器效勞、消正確的配置，為企業(yè)效勞總線供給穩(wěn)定的運(yùn)行環(huán)境。企業(yè)效勞總線供給統(tǒng)一的治理掌握臺，完成對效勞部署、治理、監(jiān)控、注冊、查找等功能的統(tǒng)一操作，為用戶快速便捷的完成SOA整合環(huán)境下總線的搭建工作供給工具支持。息流轉(zhuǎn)任務(wù)；治理掌握臺關(guān)心完成對效勞注冊信息、配置信息等關(guān)鍵元數(shù)據(jù)的治理與監(jiān)控。4RESInfomaticRegistryandRepository維護(hù)說明產(chǎn)品簡介企業(yè)效勞資源注冊中心是適應(yīng)分布式SOA與企業(yè)整合實(shí)際需要的效勞資源注冊產(chǎn)品與業(yè)務(wù)效勞在整個(gè)SOA生命周期的各個(gè)階段，對企業(yè)級SOA架構(gòu)的設(shè)計(jì)、開發(fā)、部署、運(yùn)行提RESInfomaticIntegrationSuite以關(guān)心分布式RESInfomaticServiceBus企業(yè)效勞資源注冊中心基于J2EE便利的效勞注冊、查找等功能。它遵照UDDI標(biāo)準(zhǔn)實(shí)現(xiàn)，承受標(biāo)準(zhǔn)WSDL〔WebServiceDescriptionLanguage〕對效勞資源信息進(jìn)展描述，供給基于SOAP的外部訪問視、效勞信息得到了共享，效勞資源的全都性得到了保證。RR產(chǎn)品維護(hù)手冊在RR中添加編目信息，規(guī)劃各企業(yè)、效勞、資源的分類和效勞的供給者編目。例如：企業(yè)分類可為：呼叫中心廠商、彩玲廠商、計(jì)費(fèi)廠商效勞分類可為：批量裝載、批量分發(fā)、時(shí)實(shí)分發(fā)資源分類可為：web資源、Socket資源、FTP效勞節(jié)點(diǎn)可為：可以設(shè)置效勞標(biāo)識，如：BatchDelivery、BatchLoading等在RR中添加企業(yè)信息，將企業(yè)信息及分類添加全面，便利搜尋，5RESInfomaticServiceBus企業(yè)效勞總線維護(hù)手冊例如：企業(yè)標(biāo)識：NewLand(大陸) 可選擇資源分類中web資源為企業(yè)分類。在.isdl文件中確認(rèn)效勞的標(biāo)識<Name>MBSoapMB10</Name>息)注冊效勞時(shí)，效勞的URI依據(jù)根本格式：域名〔企業(yè)名工程標(biāo)識/效勞標(biāo)識的格式來設(shè)置。注冊消息代理轉(zhuǎn)發(fā)WebService效勞時(shí)，效勞URI格式建議為：/通道名/webservice/效勞標(biāo)識。建議設(shè)置通道名為企業(yè)名_效勞供給者_(dá)效勞標(biāo)識等名稱組合，如：realesoft為企業(yè)名，那么通道名可定義為realesoft_JDBCTech_Seleect等能表達(dá)出企業(yè)及效勞相關(guān)信息的注冊I通道名〔效勞標(biāo)識，建議將效勞標(biāo)識設(shè)置為通道名。效勞注冊后，需要添加效勞的供給者。假設(shè)效勞是臨時(shí)不用了，可以將效勞禁用。假設(shè)模型是臨時(shí)不用了，可以將模型禁用，同時(shí)引用此模型的全部效勞都將不能使用。6RESRESInfomaticServiceBus企業(yè)效勞總線維護(hù)手冊假設(shè)某企業(yè)下的全部模型和效勞都臨時(shí)不用了，在企業(yè)治理中，將企業(yè)禁用就可以了。假設(shè)效勞不再使用，想刪除效勞，就在效勞治理列表，將效勞刪除；然后確定效勞所用的模型是否需要同樣刪除，假設(shè)模型被別的效勞所用，就不需要?jiǎng)h除。效勞及模型的公布，保存之前版本，進(jìn)展效勞治理。改操作的記錄，查看是否有非預(yù)期的操作記錄。效勞要參加總線，在RR中進(jìn)展規(guī)劃，依據(jù)確定的效勞標(biāo)識，查詢效勞是否存在，如已經(jīng)存在，則修改效勞為的標(biāo)識，進(jìn)展效勞注冊，效勞的URI為“域名/工程標(biāo)識/效勞確實(shí)定，進(jìn)展效勞注冊。RESInfomaticConfigurationManager維護(hù)說明產(chǎn)品簡介配置治理中心供給基于Web方式的治理界面，為分布式RESInfomaticServiceBus企業(yè)效勞總線供給了集中的可視化治理操作平臺。治理。配置治理中心供給向?qū)絼?chuàng)立、信息配置、遠(yuǎn)程部署、運(yùn)行掌握、日志治理以及用戶權(quán)限治理等一系列功能，借此用戶可以對總線不同類型效勞〔適配器、消息代理、效勞訪問代理〕進(jìn)展傳輸協(xié)議、數(shù)據(jù)源連接、以及用戶訪問安全等共性治理。CM產(chǎn)品維護(hù)手冊假設(shè)想在CM7廠家的效勞節(jié)點(diǎn)分別授權(quán)，就可以讓各廠家只看到自己的效勞節(jié)點(diǎn)了。M改。環(huán)境變量設(shè)置：資源包的環(huán)境變量設(shè)置在主機(jī)下，則整個(gè)主機(jī)的全部節(jié)點(diǎn)都引入了資源包。量優(yōu)先級高于主機(jī)環(huán)境變量。主機(jī)和效勞節(jié)點(diǎn)下都有默認(rèn)的MQ_Lib_Path變量名，是為MQ量的值只需引到MQ資源包的文件夾就可以，系統(tǒng)自動在文件夾中引用MQ所需的十個(gè)資源包。而其它環(huán)境變量都需要引到變量名才可以。Windows環(huán)境Linux環(huán)境變量值之前可通過英文半角的“:”分割。在M主機(jī)列表，查看各效勞節(jié)點(diǎn)的運(yùn)行狀態(tài)〔已啟動、已停頓，環(huán)境變量提交后，在環(huán)境變量列表還需要點(diǎn)擊“保存”按鈕。效勞節(jié)點(diǎn)的運(yùn)行掌握，在效勞節(jié)點(diǎn)的相關(guān)配置有轉(zhuǎn)變時(shí)，如協(xié)議端口、隊(duì)列名稱、適配器配置、日志配置、主題配置、數(shù)據(jù)源配置等等有轉(zhuǎn)變時(shí)，都應(yīng)將效勞節(jié)點(diǎn)重啟動，所做更改才能生效。效勞節(jié)點(diǎn)啟動后，可以手動點(diǎn)擊刷按鈕進(jìn)展?fàn)顟B(tài)刷，也可以等一分鐘系統(tǒng)自動刷。假設(shè)效勞節(jié)點(diǎn)是MQ協(xié)議，且期望承受負(fù)載均衡方法，則可以設(shè)置效勞節(jié)點(diǎn)多實(shí)例，且將實(shí)例全部啟動，就可以實(shí)現(xiàn)負(fù)載均衡。ESB8Framework啟動時(shí)，效勞節(jié)點(diǎn)也會隨其自動啟動。效勞節(jié)點(diǎn)的部署方式分兩種方式，一種是文件對應(yīng)其標(biāo)簽逐個(gè)進(jìn)展上傳，另一種是上傳.deploy文件包，可一次將全部文件上傳到其對應(yīng)的文件名目下。不同的是第一種方式不行以重復(fù)掩蓋上傳，其次種方式可以直接掩蓋上傳。點(diǎn)放到.ServiceBus\servicenodes\mb中，如是適配器節(jié)點(diǎn)放到.ServiceBus\servicenodes\uaconfig中的配置文件environment.ini中的SystemEnvironmentWorkPathmessagebroker.ini或uadapter.ini中關(guān)于錯(cuò)誤、調(diào)用、跟蹤三個(gè)日志路徑是否正確。假設(shè)想在SMconfigapplication.iniSM中錯(cuò)誤級別正常警告次要主要嚴(yán)峻

Application.ini中定義級別UWIDCE在CM報(bào)錯(cuò)，效勞的懇求和返回內(nèi)容是否正常。日志查詢：可以日志按日期段查詢，也可以依據(jù)時(shí)間段進(jìn)展區(qū)間查詢，查詢結(jié)果可下載到本9地，進(jìn)展查看。在日志的設(shè)置中的日志的切換策略是指日志文件到達(dá)肯定大小或周期就會生成日志文件。略被清理掉。日志的跟蹤信息級別：是指在調(diào)試日志中輸出信息的具體程度。級別越高日志信息越具體。在調(diào)試效勞過程中，效勞的錯(cuò)誤日志有如下錯(cuò)誤：unabletofindFieldDescriptorfor”Id”inClassDescriptorofSelectAllPersonResponsesoafactoryconfig.xmlconnectionPool在調(diào)試效勞過程中，效勞的錯(cuò)誤日志有如下錯(cuò)誤：com.res.soa.message.SOAException:While trying to get a connection using noDataSourcemodel，說明數(shù)據(jù)庫配置不正確或環(huán)境變量中未添加數(shù)據(jù)庫驅(qū)動包。在調(diào)試消息代理效勞過程中，效勞的錯(cuò)誤日志有如下錯(cuò)誤：javax.jms.JMSException:CouldnotconnecttobrokerURL:tcp://:1414.Reason:java.lang.IllegalArgumentException:portoutofrange:-1如是在MBUAMBMessageOUT在調(diào)試消息代理效勞過程中，效勞的錯(cuò)誤日志有如下錯(cuò)誤：java.lang.NumberFormatException:null 可能是配置文件中的connectionpoolname寫的不對了。在調(diào)試消息代理效勞過程中〔客戶端調(diào)用公布到t中的B代理轉(zhuǎn)發(fā)S效勞時(shí)〕客戶端的報(bào)錯(cuò)如下：org.apache.axis2.AxisFault:FirstElementmustcontainthelocalname,Envelope,butfoundhtmlMB的soatopicURI不對，10可能缺少Tomcat〔war包名〕用戶端調(diào)用B代理轉(zhuǎn)發(fā)e效勞，假設(shè)客戶端報(bào)錯(cuò)為Exception in thread “main“ org.apache.axis2.AxisFault:com.ctc.wstx.exc.WstxEOFException: Unexpected EOF in prolog at [row,col{unknown-source}]:[1,0]”時(shí)，MB效勞節(jié)點(diǎn)里可有報(bào)錯(cuò)為找不到效勞描述中的URI，解決方案為：查看RRRRURIsoap方式的UA節(jié)點(diǎn)，正常調(diào)用成功。服務(wù)訪問點(diǎn)為：://00:9840/soaSoap/resWS將效勞打?yàn)閣ar包，部署到TomcatTomcat。在客戶端的soafactoryconfig中，修改服務(wù)的訪問點(diǎn)為://00:8081/JDBCTechSoapSelectAllUserByID/soaSoap/resWS在IE中加上?wsdl?wsdl其中JDBCTechSoapSelectAllUserByID為打包后部署到Tomcat中的效勞名，效勞里的一些配置文件還可能是放在原來效勞節(jié)點(diǎn)中的?！睤:\apache-tomcat-6.0.18\webapps\JDBCTechSoapSelectAllUserByID\WEB-INF中的web.xml〕〔這時(shí)原來的p也可以不啟動〕假設(shè)是效勞開啟監(jiān)控，但SM未開啟，則servicebus下的Monitor文件夾下serviceBusCM行ps–ef|grepjava查出全部的javakill-911進(jìn)程號將此進(jìn)程殺掉，再重啟動。假設(shè)效勞節(jié)點(diǎn)里有報(bào)錯(cuò)：(java.lang.OutOfMemoryError:Javaheapspace)為內(nèi)存溢出時(shí)，可調(diào)整效勞節(jié)點(diǎn)中環(huán)境變量當(dāng)中的VM-Xms??m -Xmx??m -XX:PermSize=??M -XX:MaxPermSize=??M在做MB代理轉(zhuǎn)發(fā)WebService效勞時(shí)，所用的業(yè)務(wù)為Axis<BrokerClassName>cessor.NoChunkedMessageRequestBroker</BrokerClassName>A框架、cxf<BrokerClassName>cessor.MessageRequestBroker</BrokerClassName>12RESInfomaticServiceMonitor維護(hù)說明產(chǎn)品簡介效勞監(jiān)控中心為RESInfomaticServiceBus企業(yè)效勞總線供給了可視化的總線監(jiān)控平臺，能各個(gè)環(huán)節(jié)運(yùn)行狀況。戶從多種治理角度評估業(yè)務(wù)、環(huán)境的安康性與有效性，為治理團(tuán)隊(duì)與業(yè)務(wù)執(zhí)行者供給高質(zhì)的效的數(shù)據(jù)支持，同時(shí)它還供給了關(guān)心測量SLA承諾的手段，使得企業(yè)IT部門可以實(shí)時(shí)、有效地對IT根底設(shè)施進(jìn)展治理。SM產(chǎn)品維護(hù)手冊5.2.1維護(hù)要點(diǎn)SM的域、主機(jī)拓?fù)鋱D中，效勞節(jié)點(diǎn)為紅色是停頓狀態(tài)，綠色是啟動狀態(tài)，有“黃嘆號”是效勞節(jié)點(diǎn)有未處理的特別狀況。效勞主機(jī)上的黃嘆號，說明主機(jī)下的效勞節(jié)點(diǎn)有未處理的特別。將鼠標(biāo)劃到主機(jī)拓?fù)鋱D中，可以查看主機(jī)監(jiān)控，顯示主機(jī)的CPU使用率及內(nèi)存使用量等。效勞節(jié)點(diǎn)中的特別假設(shè)不點(diǎn)擊查看〔處理〕一下，則效勞節(jié)點(diǎn)會始終顯示黃嘆號。所以效勞節(jié)點(diǎn)有黃嘆號就需要將特別信息翻開看一下。生成一次報(bào)告的時(shí)間，間隔時(shí)間短，生成的報(bào)告就多，間隔時(shí)間長，生成的報(bào)告數(shù)就少。13示的最大執(zhí)行時(shí)間、最小執(zhí)行時(shí)間、平均執(zhí)行時(shí)間、比例圖表示的成功比例、波形圖表示的交易流量實(shí)時(shí)統(tǒng)計(jì)圖等狀況。指標(biāo)中選擇不同的效勞分項(xiàng)，就可查看每個(gè)效勞的交易執(zhí)行狀況了。假設(shè)在SM中有交易失?。簞t在CM查看效勞節(jié)點(diǎn)的錯(cuò)誤日志，會有相關(guān)錯(cuò)誤的記錄。如果 FTP 服務(wù)器未啟動，調(diào)用 FTP 適配器服務(wù)時(shí)，會報(bào)一條異常錯(cuò)誤?！睸OAXMLMessageDispatchPolicy::process-anSOAExceptionencounterdduringdispatch/processofrequestsoaMessage〕同時(shí)，還會有失敗記錄，查看錯(cuò)誤日志：〔::td。在MB轉(zhuǎn)發(fā)Webservice效勞工程中，假設(shè)Webservice效勞未啟動，SM中會有特別和一條失敗。特別為：Connectionrefused:connect。SLA監(jiān)控參數(shù)配置，設(shè)置SLA監(jiān)控開關(guān)，提示歷史顯示的時(shí)間為在SLA監(jiān)控頁面顯示設(shè)置SLASLA頻率的時(shí)間持續(xù)輪詢，這兩種方式可依據(jù)實(shí)際狀況選擇使用。SLA規(guī)章的生效日期為：生效日期應(yīng)當(dāng)大于等于當(dāng)前日期，A規(guī)章開頭時(shí)間，即規(guī)章的生效時(shí)間SLA規(guī)章臨時(shí)不用，可以將其設(shè)置為無效狀態(tài)。規(guī)章級別：設(shè)置規(guī)章的嚴(yán)峻級別，分為“正常、警告、次要、主要、嚴(yán)峻、致命”等六個(gè)級別。在概要報(bào)告中，可以查詢系統(tǒng)分析〔常規(guī)監(jiān)控、SLA分析、錯(cuò)誤報(bào)告等歷史記錄信息。14系統(tǒng)分析列表中的數(shù)據(jù)進(jìn)展性能及數(shù)據(jù)重分析顯示。系統(tǒng)分析列表中的數(shù)據(jù)假設(shè)已經(jīng)分析完成，不需要保存時(shí)，可在列表中進(jìn)展刪除，此刪除是完全刪除，不行逆操作。SLA分析查詢列表：依據(jù)查詢時(shí)間、規(guī)章級別、規(guī)章名稱等條件顯示查詢結(jié)果。依據(jù)查詢結(jié)果列表可以進(jìn)展數(shù)據(jù)分析，圖形化顯示規(guī)章匯總信息等。SLA分析查詢列表中的數(shù)據(jù)假設(shè)不需要保