1、密文檔級(jí)：一般：公共同步服務(wù)安裝配置手冊(cè)鄭州新電子總頁(yè)數(shù)版本1.0建立日期2011/12/07編制人審核人批準(zhǔn)人批準(zhǔn)日期保管人存放位置文件修改控制*變化狀態(tài)：A增加，M修改，D刪除序號(hào)版本*變化狀態(tài)修改內(nèi)容、頁(yè)碼及條款修改人批準(zhǔn)人修改日期011.0A新功能模塊凡2011-12-07目錄1. 簡(jiǎn)介4目的4讀者對(duì)象4術(shù)語(yǔ)定義42. 系統(tǒng)架構(gòu)和部署4系統(tǒng)環(huán)境要求4硬件環(huán)境4軟件環(huán)境5網(wǎng)絡(luò)環(huán)境52.2. 軟件介紹53. 安裝說明53.1 安裝注意事項(xiàng)54. 設(shè)置說明6配置工具主界面6配置說明65. 日志說明105.1. 日志分布及說明106. 常見問題10表或視圖不存在10同步數(shù)據(jù)由空轉(zhuǎn)零情況107.

2、 同步任務(wù)配置說明(技術(shù)) . 11單個(gè)同步任務(wù)增加11增加一個(gè)客戶的同步任務(wù)11注意事項(xiàng)11公共同步服務(wù)安裝配置手冊(cè)1.簡(jiǎn)介1.1.目的本部署手冊(cè)，對(duì)公共(移動(dòng)、電信多客戶)同步服務(wù)系統(tǒng)架構(gòu)進(jìn)行說明，并提供系統(tǒng)中逐個(gè)環(huán)節(jié)的安裝配置介紹，以對(duì)現(xiàn)場(chǎng)安裝部署、技術(shù)技術(shù)支持工作提供幫助。1.2. 讀者對(duì)象本說明書預(yù)期讀者為項(xiàng)目實(shí)施、技術(shù)支持。1.3. 術(shù)語(yǔ)定義本說明書使用到的術(shù)語(yǔ)如表 1 所示。表 1術(shù)語(yǔ)表2.系統(tǒng)架構(gòu)和部署2.1. 系統(tǒng)環(huán)境要求2.1.1. 硬件環(huán)境系統(tǒng)硬件基本要求如下：處理器：雙核 2.6 GHz 或更快的處理器；RAM：術(shù)語(yǔ)名稱術(shù)語(yǔ)說明同步服務(wù)一卡通(中心門戶（公共庫(kù)）提供數(shù)據(jù)

3、傳輸同步的 Windows服務(wù)同步標(biāo)記當(dāng)前同步服務(wù)同步到的標(biāo)記最小 1GB；4GB 以上硬盤：5400 RPM 以上硬盤驅(qū)動(dòng)器，40GB 以上可用空間。2.1.2. 軟件環(huán)境支持操作系統(tǒng)（僅限 32 位）如表 2 所示。表 2應(yīng)用支持操作系統(tǒng)表環(huán)境：.NET Framework 2.0 以上版本。2.1.3. 網(wǎng)絡(luò)環(huán)境100Mbps 以上以太網(wǎng)。2.2. 軟件介紹公共同步服務(wù)是 Windows 服務(wù)程序，主要負(fù)責(zé)，通訊方式為 TCP/IP。公共同步服務(wù)主要功能如下：向一卡通（中心庫(kù)）Web 服務(wù)發(fā)起數(shù)據(jù)同步請(qǐng)求，收到待同步數(shù)據(jù)后，再向門戶（公共庫(kù)）Web 服務(wù)向發(fā)起同步申請(qǐng)。并返回同步結(jié)果，并

4、同步標(biāo)記。3.安裝說明3.1 安裝注意事項(xiàng)如上圖所示，安裝包里有兩個(gè)可執(zhí)行文件，安裝的時(shí)候，setup.exe.該可執(zhí)行程序會(huì)在安裝前檢查公共同步服務(wù)運(yùn)行所需要的環(huán)境是否具備。不具備的時(shí)候會(huì)提示安裝。支持但不不支持Windows Server 2003 SP1 以上 Windows Server 2008Windows XP Win7Windows 20004.設(shè)置說明4.1. 配置工具主界面4.2. 配置主界面說明1、選擇配置文件：同步服務(wù)安裝目錄下的“DistributionService.exe.config”文件2、同步間隔時(shí)間：同步服務(wù)主線程的啟動(dòng)頻率，此線程主要負(fù)責(zé)獲取同步服務(wù)的配

5、置任務(wù)，并針對(duì)最大線程數(shù)均分異步執(zhí)行。3、日志保留天數(shù)：允許同步服務(wù)日志在電腦系統(tǒng)中保留的天數(shù)。4、同步服務(wù)類型：同步服務(wù)通過什么方式實(shí)現(xiàn)數(shù)據(jù)的同步傳輸。5、最大線程數(shù)：同步服務(wù)啟動(dòng)時(shí)允許同時(shí)啟動(dòng)最大的線程數(shù)量，識(shí)同步服務(wù)的部署環(huán)境、待同步數(shù)據(jù)量而定。6、線程間隔時(shí)間：同步服務(wù)在啟動(dòng)每個(gè)同步子線程時(shí)的時(shí)間間隔，此項(xiàng)只對(duì)最大線程數(shù)大于 1 是生效。7、配置表來(lái)源：配置信息表（base_distribution）和配置類型表（BASE_DTYPE）所在位置（base_distribution、BASE_DTYPE 放于一卡通定）。是門戶而8、日志文件路徑：同步服務(wù)運(yùn)行過程志的保存路徑，此路徑必須存

6、在。4.3. 配置子界面4.4. 配置子界面說明1、請(qǐng)選擇配置分類：同步服務(wù)可能是從中心公共庫(kù)同步，同時(shí)也從公共中心庫(kù)同步數(shù)據(jù)，有多種分類。請(qǐng)選擇配置分類默認(rèn)是全部，當(dāng)選擇后，列表隨其變化。第一次配置時(shí)列表為空。2、同步數(shù)據(jù)列表：要同步的信息列表。3、配置分類名稱：同步分類的名稱。第一次配置時(shí)或新增配置分類時(shí)，填該名稱。第一次配置或?yàn)樾略龅男畔⑴渲脮r(shí)，同步數(shù)據(jù)來(lái)源和同步數(shù)據(jù)目標(biāo)為空，需為其設(shè)置配置分類。 4、已配置分類：已增加過的配置分類，當(dāng)需要修改同步信息所屬的分類時(shí)可選擇其應(yīng)所屬的分類。5、同步數(shù)據(jù)來(lái)源：同步程序?qū)⑼ㄟ^哪里獲取待同步數(shù)據(jù)（指一卡通管理Web 服務(wù)），可點(diǎn)后面的“測(cè)試連接”進(jìn)

7、試。6、同步數(shù)據(jù)目標(biāo)：同步程序?qū)⑼ㄟ^哪里將獲取的待同步數(shù)據(jù)傳送到目標(biāo)源（指門戶Web服務(wù)），可點(diǎn)后面的“測(cè)試連接”進(jìn)試。7、是否啟用：同步信息是否啟用。當(dāng)選擇啟用時(shí)，服務(wù)開啟后就會(huì)同步該信息，選擇“否”時(shí)，該信息不會(huì)發(fā)生同步。8、刪除：若配置信息列表有選中的，刪除時(shí)只會(huì)刪除配置信息表相應(yīng)的。若都沒有選中，已配置分類下拉列表有選中的分類，則會(huì)刪除分類。4.5. 配置步驟首先配置主界面：1、 選擇配置文件后，配置工具會(huì)自動(dòng)用配置文件中的配置項(xiàng)的值初始化配置工具。2、點(diǎn)“測(cè)試連接”之后出現(xiàn)如下提示方為成功！否則失敗。3、配置主界面信息填寫完整后，點(diǎn)擊“配置”按鈕設(shè)置配置信息表信息的同步數(shù)據(jù)來(lái)源和同步

8、數(shù)據(jù)目標(biāo)，若配置表來(lái)選填寫正確，彈出如下子界面，否則彈出失敗原因提示。4、若配置信息列表為空，表示還沒執(zhí)行，應(yīng)執(zhí)行。若執(zhí)行了，配置列表會(huì)顯示要同步的信息，這時(shí)服務(wù)名稱，同步數(shù)據(jù)來(lái)源和同步數(shù)據(jù)目標(biāo)都為空，尚未為其設(shè)置。5、選擇這些類型相同的信息，填寫配置分類名稱、同步數(shù)據(jù)來(lái)源、同步數(shù)據(jù)目標(biāo)，選擇“是否啟用”后，點(diǎn)擊保存，保存配置信息。6、若同步分多種情況（有從中心公共庫(kù)同步的，也有從公共中心庫(kù)同步，或其他同步情況的），可選擇后，重復(fù)步驟 5，增加分類和設(shè)置相應(yīng)的配置信息。7、若某些配置錯(cuò)誤，需調(diào)整配置分類，可選擇“已配置分類”下拉列表，選擇后，點(diǎn)擊“保存”，保存配置信息。8、若某些已不需再執(zhí)行同

9、步任務(wù)，可選擇后，點(diǎn)擊“刪除”按鈕，刪除。9、配置好后的子界面如下圖所示：10、配置好后，點(diǎn)擊“退出”按鈕，關(guān)閉該子界面，回到主界面，如下圖：10、主界面信息填完整后，點(diǎn)擊“確定”按鈕保存配置信息5.日志說明5.1. 日志分布及說明日志文件默認(rèn)路徑為：D:LogServiceLog.txt 文件中按例子所配置的：日志的分布如下圖所示6.常見問題6.1. 表或視圖不存在同步服務(wù)剛啟動(dòng)就出現(xiàn)此問題，請(qǐng)確認(rèn)同步任務(wù)配置信息表 base_distribution 所在“的庫(kù)與同步服務(wù)安裝目錄下的Web 服務(wù)地址指向的庫(kù)是否一至，保持一直此問題可解決。6.2. 同步數(shù)據(jù)由空轉(zhuǎn)零情況例如：一卡通(中心庫(kù))

10、中的某個(gè)字段為空，但同步到門戶(公共庫(kù))后發(fā)現(xiàn)其值從空變成了 0,這屬于正?，F(xiàn)，為了保證數(shù)據(jù)順序同步不受空值影響已對(duì)數(shù)值類型和字符類型的字段進(jìn)行了判斷，為空進(jìn)為其賦上默認(rèn)值“0”。7.同步任務(wù)配置說明(技術(shù))7.1. 單個(gè)同步任務(wù)增加此項(xiàng)工作由技術(shù)負(fù)責(zé)完成，里面要寫好取數(shù)據(jù) SQL(GETSQL)和入庫(kù) SQL(SSQL)及待同步數(shù)據(jù)依據(jù)(VERKEY、VER)后在 base_distribution 表中添加一條，ID 增量保存即可。7.2. 增加一個(gè)客戶的同步任務(wù)將現(xiàn)有客戶(某一個(gè)客戶)的同步任務(wù)導(dǎo)出修改其 ID(增量)及獲取數(shù)據(jù)來(lái)源(GETURL)和同步數(shù)據(jù)目標(biāo)(SURL),并在庫(kù)中執(zhí)行即可。7.3. 注意事項(xiàng)1、 新加同步任務(wù)不為空的字段必須填寫，不得以任何方式修改庫(kù)中的 base_distribution 表結(jié)構(gòu)，需經(jīng)過測(cè)試通過之后的同步任務(wù)才能對(duì)客戶發(fā)