分布式緩存管理平臺(tái)-系統(tǒng)用戶使用手冊(cè)

金關(guān)工程二期

海關(guān)相關(guān)系統(tǒng)采購(gòu)項(xiàng)目（二）

01包:分布式緩存二次開(kāi)發(fā)項(xiàng)目

系統(tǒng)用戶使用手冊(cè)

文件狀態(tài)：文件標(biāo)識(shí)：分布式緩存管理平臺(tái)用戶使用手冊(cè)

[]草稿

當(dāng)前版本：

[V]正式發(fā)布

作者：

[]正在修改

完成日期：

批準(zhǔn)單

項(xiàng)目：版本:

批準(zhǔn)人簽字日期

項(xiàng)目經(jīng)理

SQA負(fù)責(zé)人

SCM負(fù)責(zé)人

其他人員

變更歷史

變更章變更

版本變更時(shí)間性質(zhì)變更內(nèi)容修改人批準(zhǔn)人

節(jié)ID

VI.0

VI.0.1

VI.0.2

VI.0.3

VI.0.4

注：性質(zhì)可以為N-新建、A-增加、M-更改、D-刪除。

目錄

引言.........................................................1

1.1編寫目的..................................................1

1.2背景......................................................1

二術(shù)語(yǔ)解釋.....................................................1

三系統(tǒng)要求.....................................................3

3.1運(yùn)行環(huán)境..................................................3

3.2用戶范圍..................................................3

四系統(tǒng)概述.....................................................4

4.1功能簡(jiǎn)介..................................................4

4.2系統(tǒng)特點(diǎn)..................................................6

五安裝與初始化.................................................6

六授權(quán)定義.....................................................6

七使用說(shuō)明.....................................................7

7.1登錄......................................................8

7.1.1用戶界面.............................................8

7.1.2操作方法..............................................8

7.2緩存服務(wù)發(fā)布管理..........................................9

7.2.1服務(wù)發(fā)布..............................................9

7.2.2查詢.................................................22

7.2.3查看.................................................24

7.2.4刪除.................................................25

7.3緩存集群管理.............................................26

7.3.1緩存集群樹(shù)..........................................26

7.3.2集群管理.............................................38

7.3.3節(jié)點(diǎn)管理............................................40

7.3.4配置管理.............................................44

7.3.5緩存數(shù)據(jù)備份.........................................46

7.3.6Cohql控制臺(tái).............................................48

7.3.7服務(wù)器運(yùn)行指標(biāo)展示......................................50

7.3.8節(jié)點(diǎn)運(yùn)行指標(biāo)展示........................................51

7.3.9安全認(rèn)證.................................................52

7.3.10指標(biāo)管理...............................................53

7.3.11集群指標(biāo)展示............................................58

7.4預(yù)警報(bào)警管理.................................................59

7.4.1預(yù)警預(yù)報(bào)規(guī)則管理........................................59

7.4.2預(yù)警報(bào)警記錄管理........................................66

7.5集群監(jiān)控.....................................................67

7.5.1集群監(jiān)控展示............................................67

7.6日志管理......................................................68

7.6.1操作日志.................................................69

7.6.2運(yùn)行日志.................................................70

7.7統(tǒng)計(jì)分析.....................................................71

7.7.1統(tǒng)計(jì)分析.................................................72

7.8系統(tǒng)管理.....................................................74

7.8.1服務(wù)器資源管理..........................................74

7.8.2集群分組管理............................................77

7.8.3系統(tǒng)參數(shù)管理............................................80

7.8.4Coherence及組件版本管理................................82

7.8.5數(shù)據(jù)權(quán)限管理............................................85

A參考資料........................................................88

九附錄.............................................................88

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

一引言

1.1編寫目的

本文檔用于指導(dǎo)用戶如何正確使用分布式緩存管理平臺(tái)，適用于項(xiàng)目合同規(guī)定的用戶及相關(guān)領(lǐng)

導(dǎo)。

1.2背景

本項(xiàng)目由中國(guó)海關(guān)信息中心提出，由神州數(shù)碼具體實(shí)施，為海關(guān)各應(yīng)用系統(tǒng)在緩存設(shè)計(jì)方面基

本采用在服務(wù)器或客戶端設(shè)置本地緩存的方式，對(duì)于如企業(yè)信息、匯率、HS編碼等通用的數(shù)據(jù)在

不同系統(tǒng)中會(huì)緩存多份，無(wú)法實(shí)現(xiàn)緩存數(shù)據(jù)的共享以及漫游，緩存數(shù)據(jù)的利用率不高，同時(shí)本地緩

存的緩存數(shù)據(jù)量受到機(jī)器內(nèi)存的限制，設(shè)計(jì)時(shí)需要對(duì)緩存隊(duì)列的更新機(jī)制進(jìn)行針對(duì)性優(yōu)化以提高緩

存數(shù)據(jù)的命中率，導(dǎo)致產(chǎn)生較多數(shù)據(jù)庫(kù)的訪問(wèn)請(qǐng)求，降低了緩存的應(yīng)用效果。

分布式緩存平臺(tái)是金關(guān)二期應(yīng)用支撐平臺(tái)的子項(xiàng)目。分布式緩存平臺(tái)為海關(guān)業(yè)務(wù)系統(tǒng)提供了分

布式高性能的key-value結(jié)構(gòu)存儲(chǔ)的NoSql緩存服務(wù)。

二術(shù)語(yǔ)解釋

分布式分布式系統(tǒng)（distributedsystem）是建立在網(wǎng)絡(luò)之上的軟

件系統(tǒng)。正是因?yàn)檐浖奶匦?，所以分布式系統(tǒng)具有高度

的內(nèi)聚性和透明性。因此，網(wǎng)絡(luò)和分布式系統(tǒng)之間的區(qū)別

更多的在于高層軟件（特別是操作系統(tǒng)），而不是硬件。

協(xié)議服務(wù)協(xié)議是實(shí)體（即服務(wù)提供者和使用者）之間就相關(guān)事

項(xiàng)達(dá)成的一致意見(jiàn)。這些協(xié)議基于服務(wù)規(guī)范，而不是實(shí)現(xiàn)。

分布式緩存管理平臺(tái)，提供緩存集群發(fā)布、集群管理、監(jiān)

管理平臺(tái)控管理、預(yù)警管理、統(tǒng)計(jì)分析等功能的一套定制化開(kāi)發(fā)系

統(tǒng)。

1

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

分布式緩存運(yùn)行平臺(tái)，采用OracleCoherence產(chǎn)品提供具

運(yùn)行平臺(tái)

體的分布式緩存服務(wù)能力。

CoherenceQueryLanguage簡(jiǎn)稱CohQL,是Coherence弓1入

類似SQL的查詢語(yǔ)言，方便開(kāi)發(fā)人員及運(yùn)營(yíng)部門訪問(wèn)和控

CohQL

制大規(guī)模連續(xù)可用的生產(chǎn)環(huán)境，從而提高開(kāi)發(fā)人員的工作

效率和公司的運(yùn)營(yíng)效率。

PortableObjectFormat簡(jiǎn)稱POF,是coherence用來(lái)指定的

POF文件自定義的緩存數(shù)據(jù)對(duì)象序列化結(jié)構(gòu)的文件。例如

pof?config.xml文件，配置了以POF方式實(shí)現(xiàn)序列化的對(duì)象。

Coherence運(yùn)行所依賴的jar文件，包含了Oracle提供的產(chǎn)

庫(kù)文件品本身的Jar文件和使用緩存特定功能需要定制化的一些

jar文件，例如數(shù)據(jù)庫(kù)jdbc驅(qū)動(dòng)等。

Coherence運(yùn)行所依賴的配置文件，例如

tangosol-coherence-override.xml文件，提供了緩存集群的

配置文件連接信息；coherence-cache-config.xmlX#,提供了緩存

方案信息（包括緩存數(shù)據(jù)存儲(chǔ)方式、緩存數(shù)據(jù)失效策略、

緩存數(shù)據(jù)備份數(shù)量等）。

安裝在OracleCoherence服務(wù)器上的代理應(yīng)用，每臺(tái)Oracle

Coherence服務(wù)器安裝一個(gè)Agent,通過(guò)Agent實(shí)現(xiàn)對(duì)Oracle

Agent

Coherence集群節(jié)點(diǎn)的創(chuàng)建、啟停以及采集集群節(jié)點(diǎn)運(yùn)行

狀況指標(biāo)數(shù)據(jù)和服務(wù)器運(yùn)行狀況指標(biāo)數(shù)據(jù)。

Token身份令牌，是應(yīng)用系統(tǒng)訪問(wèn)分布式緩存集群的安全憑證。

獨(dú)立的Collector集群，負(fù)責(zé)接收agent采集的數(shù)據(jù)，同時(shí)

Collector

執(zhí)行預(yù)警監(jiān)控功能。

分組是指按照海關(guān)的業(yè)務(wù)領(lǐng)域?qū)ｊP(guān)各種應(yīng)用系統(tǒng)進(jìn)行

分組歸類管理，通過(guò)服務(wù)發(fā)布功能新建的緩存集群再分配到應(yīng)

用系統(tǒng)下。

2

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

數(shù)據(jù)持久化是把內(nèi)存中的數(shù)據(jù)保存到可永久保存的存儲(chǔ)

數(shù)據(jù)持久化

設(shè)備中（如磁盤文件）。

JMX（JavaManagementExtensions,即Java管理擴(kuò)展）是

一個(gè)為應(yīng)用程序、設(shè)備、系統(tǒng)等植入管理功能的框架。通

JMX端口

常使用JMX來(lái)監(jiān)控系統(tǒng)的運(yùn)行狀態(tài)或管理系統(tǒng)的某些方

面，比如清空緩存、重新加載配置文件等。

JVM的垃圾回收機(jī)制，針對(duì)不再被使用的年老代對(duì)象進(jìn)行

FullGC內(nèi)存釋放和回收，發(fā)生的情況比較少，但一旦發(fā)生，耗費(fèi)

的時(shí)間和占用內(nèi)存會(huì)比較多。

三系統(tǒng)要求

3.1運(yùn)行環(huán)境

用戶在使用分布式緩存管理平臺(tái)時(shí)，要求瀏覽器是IE8及以上版本或者Chrome42或者更新版

本，瀏覽器必須安裝FlashPlayer插件。

硬件名稱職責(zé)/硬件配置軟件配置數(shù)量備注

客戶端分布式緩存CPU:雙核IE8及以上1

管理平臺(tái)內(nèi)存：4G瀏覽器或者

硬盤：剩余空間Chrome瀏

20G以上覽器，安裝

FlashPlayer

插件

3.2用戶范圍

本產(chǎn)品面向的用戶群體是使用分布式緩存運(yùn)行平臺(tái)的應(yīng)用系統(tǒng)開(kāi)發(fā)人員，以及使用分布式緩存

3

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

管理平臺(tái)的運(yùn)維人員、系統(tǒng)管理人員。

四系統(tǒng)概述

4.1功能簡(jiǎn)介

功能類別功能名稱、標(biāo)識(shí)描述

符

緩存服務(wù)發(fā)布管對(duì)服務(wù)進(jìn)行發(fā)布，還可以按一定的查詢條

理件對(duì)相應(yīng)服務(wù)進(jìn)行查詢，還可以對(duì)服務(wù)進(jìn)

緩存服務(wù)發(fā)布管理

行詳細(xì)查看，對(duì)發(fā)布不成功的服務(wù)可以進(jìn)

行刪除。

緩存集群管理對(duì)集群進(jìn)行查看，按查詢條作進(jìn)行查詢要

找的集群，并對(duì)集群中的集群管理，進(jìn)行

修改所屬系統(tǒng)，修改集群信息，刪除集群

操作;對(duì)節(jié)點(diǎn)管理進(jìn)行新增，部署，開(kāi)啟，

關(guān)閉，修改刪除的操作;對(duì)配置管理下面的

集群環(huán)境，應(yīng)用系統(tǒng)擴(kuò)展，后停腳本，配

緩存集群管理置文件，節(jié)點(diǎn)專屬配置文件，版本控制，

這些的操作，對(duì)饋存數(shù)據(jù)備份進(jìn)行備份和

刪除的操作;對(duì)Cohql控制臺(tái)進(jìn)行Cohql語(yǔ)

句的執(zhí)行;對(duì)服務(wù)器運(yùn)行指標(biāo)展示;對(duì)節(jié)點(diǎn)

運(yùn)行指標(biāo)展示，對(duì)安全認(rèn)證，對(duì)指標(biāo)管理

的信息展示，還有預(yù)設(shè)指標(biāo)的添加，修改，

刪除操作，集群指標(biāo)展示。

4

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

預(yù)警預(yù)報(bào)規(guī)則管按查詢條件對(duì)預(yù)警預(yù)報(bào)規(guī)則管理進(jìn)行查

理詢。并且可以顯示規(guī)則的詳卯信息，同時(shí)

可以對(duì)規(guī)則進(jìn)行新建，啟用，失效這些操

預(yù)警報(bào)警管理

作。

預(yù)警報(bào)警記錄管按查詢條件對(duì)預(yù)警報(bào)警記錄管理進(jìn)行查

理詢。

集群監(jiān)控展示點(diǎn)擊要查看的集群，然后把集群節(jié)點(diǎn)內(nèi)存

集群監(jiān)控

的使用情況進(jìn)行一個(gè)展示。

操作日志按查詢條件對(duì)操作日志進(jìn)行查詢。

日志管理

運(yùn)行日志按查詢條件對(duì)運(yùn)行日志進(jìn)行查詢。

統(tǒng)計(jì)分析按照指標(biāo)類型中，集群及節(jié)點(diǎn)運(yùn)行指標(biāo)和

統(tǒng)計(jì)分析服務(wù)器運(yùn)行指標(biāo)的不同選擇不同的條件

進(jìn)行添加服務(wù)器指標(biāo)圖。

服務(wù)器資源管理對(duì)服務(wù)器信息進(jìn)行展示，并且可以添加服

務(wù)器，進(jìn)行更新AGENT,修改服務(wù)信息，

或者是進(jìn)行刪除相應(yīng)的服務(wù)

集群分組管理對(duì)集群分組進(jìn)行添加，修改和刪除操作

系統(tǒng)參數(shù)管理對(duì)系統(tǒng)參數(shù)進(jìn)行查看，并且可以列出詳細(xì)

編碼，還可以對(duì)編碼進(jìn)行新增，刪除和修

系統(tǒng)管理改操作

Coherence及組對(duì)Coherence及組件版本進(jìn)行行查看，并

件版本管理列出每個(gè)版本中的詳細(xì)文件，還可以對(duì)版

本進(jìn)行添加，刪除，修改操作。

數(shù)據(jù)權(quán)限管理對(duì)數(shù)據(jù)的權(quán)限進(jìn)行查看，按查詢條件進(jìn)行

查詢要找的權(quán)限，還可以對(duì)權(quán)限進(jìn)行新

增，修改和刪除操作。

5

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

4.2系統(tǒng)特點(diǎn)

分布式緩存集群管理平臺(tái)的建設(shè)目標(biāo)是通過(guò)統(tǒng)一的圖形化管理控制臺(tái)完成對(duì)分布式緩存集群

的統(tǒng)一資源管理、統(tǒng)一部署配置管理、統(tǒng)一監(jiān)控預(yù)警管理以及統(tǒng)一安全管理，并與海關(guān)現(xiàn)有的應(yīng)用

系統(tǒng)進(jìn)行集成，來(lái)保障分布式緩存集群的長(zhǎng)期健康運(yùn)行，為分布式緩存集群運(yùn)行平臺(tái)提供有力支撐。

通過(guò)定制化開(kāi)發(fā)的分布式緩存管理平臺(tái)，利用圖形化的操作實(shí)現(xiàn)對(duì)緩存集群的自動(dòng)部署、緩存

節(jié)點(diǎn)的管理、緩存集群配置的管理，彌補(bǔ)了Coherence產(chǎn)品本身在圖形化管理上的欠缺，根據(jù)緩存

集群所屬系統(tǒng)和業(yè)務(wù)領(lǐng)域?qū)哼M(jìn)行分組管理，提供多種方式對(duì)緩存數(shù)據(jù)進(jìn)行管理，包括了CohQL

控制臺(tái)、應(yīng)用程序緩存數(shù)據(jù)操作接口、緩存數(shù)據(jù)持久化等，此外，借助Coherence提供的JMX接

口實(shí)現(xiàn)對(duì)緩存集群的運(yùn)行指標(biāo)監(jiān)控以及對(duì)緩存節(jié)點(diǎn)所在服務(wù)器設(shè)備的運(yùn)行指標(biāo)監(jiān)控，并通過(guò)圖表對(duì)

監(jiān)控?cái)?shù)據(jù)進(jìn)行展示，通過(guò)對(duì)運(yùn)行指標(biāo)進(jìn)行預(yù)警規(guī)則定義，設(shè)置指標(biāo)預(yù)警閥值，實(shí)現(xiàn)對(duì)緩存集群和集

群節(jié)點(diǎn)所在設(shè)備的監(jiān)控報(bào)警，并根據(jù)預(yù)警任務(wù)發(fā)送報(bào)警通知，以便對(duì)故障進(jìn)行及時(shí)響應(yīng)和排查，確

保緩存服務(wù)的持續(xù)可用。除此之外，對(duì)運(yùn)行指標(biāo)進(jìn)行統(tǒng)計(jì)分析，定時(shí)生成運(yùn)行報(bào)告。

五安裝與初始化

參考《安裝部署手冊(cè)》。

六授權(quán)定義

分布式緩存管理平臺(tái)的用戶權(quán)限包含兩部分內(nèi)容：功能權(quán)限和數(shù)據(jù)權(quán)限。

1）功能權(quán)限

功能權(quán)限以功能為基礎(chǔ)，通過(guò)三統(tǒng)一系統(tǒng)管理和維護(hù)，可靈活創(chuàng)建隹色，并為角色分配相應(yīng)的

功能，下表中的角色作為系統(tǒng)所必須的基本角色，并將每個(gè)角色擁有的功能權(quán)限進(jìn)行梳理，當(dāng)需要

創(chuàng)建新的角色以滿足實(shí)際業(yè)務(wù)需求時(shí)，分布式緩存管理平臺(tái)應(yīng)支持在三統(tǒng)一平臺(tái)中動(dòng)態(tài)添加新的角

色，且無(wú)需對(duì)管理平臺(tái)進(jìn)行額外的修改和配置。

角色分類說(shuō)明

平臺(tái)管理員平臺(tái)管理員通過(guò)服務(wù)器資源管理、Coherence版本管理來(lái)

6

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

對(duì)可分布式緩存運(yùn)行平臺(tái)可使用的物理服務(wù)器資源和使

用的Coherence產(chǎn)品版本進(jìn)行配置，通過(guò)系統(tǒng)參數(shù)配置對(duì)

分布式緩存管理平臺(tái)運(yùn)行需要的相關(guān)參數(shù)進(jìn)行配置，同時(shí)

通過(guò)數(shù)據(jù)權(quán)限管理為需要使用分布式緩存管理平臺(tái)的其

它用戶分配數(shù)據(jù)權(quán)限。

緩存集群管理員緩存集群管理員負(fù)責(zé)對(duì)應(yīng)用系統(tǒng)使用分布式緩存運(yùn)行平

臺(tái)提供的緩存服務(wù)情況進(jìn)行統(tǒng)一管理，通過(guò)分布式緩存管

理平臺(tái)來(lái)進(jìn)行服務(wù)發(fā)布、管理緩存集群、對(duì)集群運(yùn)行情況

也進(jìn)行監(jiān)控和查看統(tǒng)計(jì)分析的圖表。

緩存集群監(jiān)控人員通過(guò)分布式緩存管理平臺(tái)提供的對(duì)分布式緩存運(yùn)行平臺(tái)

的監(jiān)控、預(yù)警、統(tǒng)計(jì)分析功能負(fù)責(zé)對(duì)運(yùn)行平臺(tái)的運(yùn)行情況

進(jìn)行監(jiān)控、日志信息審查等工作。

2）數(shù)據(jù)權(quán)限

當(dāng)用戶需要操作分布式緩存管理平臺(tái)中管理的緩存集群時(shí)，對(duì)當(dāng)前登錄的用戶進(jìn)行數(shù)據(jù)權(quán)限的

檢查。數(shù)據(jù)權(quán)限實(shí)現(xiàn)對(duì)用戶所能操作分組和緩存集群范圍的限定。該功能的實(shí)現(xiàn)結(jié)合了三統(tǒng)一管理

平臺(tái)提供的業(yè)務(wù)服務(wù)范圍基礎(chǔ)服務(wù)。用戶登錄后，三統(tǒng)一管理平臺(tái)發(fā)送當(dāng)前登錄用戶所擁有的業(yè)務(wù)

服務(wù)范圍數(shù)據(jù)給分布式緩存管理平臺(tái)，分布式緩存管理平臺(tái)接收到該用戶擁有的業(yè)務(wù)服務(wù)范圍數(shù)據(jù)

后，跟自身維護(hù)的數(shù)據(jù)權(quán)限表中的記錄進(jìn)行對(duì)比，如果找到對(duì)應(yīng)的數(shù)據(jù)權(quán)限規(guī)則，則允許用戶操作

相應(yīng)分組和集群，否則用戶將只有功能菜單而不能操作具體的數(shù)據(jù)內(nèi)容。

七使用說(shuō)明

分布式緩存管理平臺(tái)在用戶登錄以后的使用場(chǎng)景大體分為三類：1、需要為某個(gè)應(yīng)用系統(tǒng)創(chuàng)

建新的緩存服務(wù)，使用緩存服務(wù)發(fā)布管理菜單；2、對(duì)已經(jīng)存在的緩存服務(wù)進(jìn)行緩存集群管理、

監(jiān)控，使用緩存集群管理菜單、日志管理菜單、集群監(jiān)控菜單，其中緩存集群管理菜單包括緩

存集群樹(shù)、集群管理（集群基本信息管理）、節(jié)點(diǎn)管理、配置文件管理、緩存數(shù)據(jù)持久化、CohQL

控制臺(tái)，服務(wù)器運(yùn)行指標(biāo)、節(jié)點(diǎn)運(yùn)行指標(biāo)、指標(biāo)管理、集群運(yùn)行指標(biāo)等功能；3、為系統(tǒng)運(yùn)行

7

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

進(jìn)行全局參數(shù)、資源的管理，通過(guò)系統(tǒng)管理菜單下的服務(wù)器資源管理、分組管理、系統(tǒng)參數(shù)管

理、Coherence版本管理者四個(gè)功能來(lái)實(shí)現(xiàn)。在第七章節(jié)中對(duì)每個(gè)功能點(diǎn)的使用進(jìn)行依次闡述。

用戶根據(jù)使用場(chǎng)景查找對(duì)應(yīng)的功能點(diǎn)進(jìn)行查閱即可。

7.1登錄

分布式緩存管理平臺(tái)的登錄功能，為用戶提供統(tǒng)一的登錄入口，結(jié)合三統(tǒng)一平臺(tái)實(shí)現(xiàn)。

7.1.1用戶界面

登錄界面跳轉(zhuǎn)到三統(tǒng)一的登錄界面，使用三統(tǒng)一的登錄功能登錄分布式緩存管理平臺(tái)。

iixhoM.您好.歡迎使用新管平臺(tái)!

埃分布式緩存管理平臺(tái)

，存善秀發(fā)布?理

O

osuxte

OB￡M

。緩諸分析

7.1.2操作方法

1.運(yùn)行分布式緩存管理平臺(tái)，在瀏覽器地址欄輸入http:〃localhost:8000/cache（實(shí)際情況需

要將localhost：8000換成真實(shí)IP地址及端口），頁(yè)面跳轉(zhuǎn)到三統(tǒng)一的登錄界面。

2.輸入用戶名密碼，點(diǎn)擊登錄。

3.如果通過(guò)驗(yàn)證，登錄成功，跳轉(zhuǎn)到分布式緩存管理平臺(tái)主頁(yè)面，如果失敗再次返回登錄頁(yè)

面。

8

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

7.2緩存服務(wù)發(fā)布管理

當(dāng)應(yīng)用系統(tǒng)要使用緩存集群并通過(guò)分布式緩存管理平臺(tái)進(jìn)行管理時(shí)，需要應(yīng)用系統(tǒng)提供緩存集

群的相關(guān)信息，并在分布式緩存管理平臺(tái)通過(guò)服務(wù)發(fā)布功能來(lái)創(chuàng)建一個(gè)緩存集群。

服務(wù)發(fā)布分為手動(dòng)發(fā)布和自動(dòng)發(fā)布，手動(dòng)發(fā)布是指：用戶線下手動(dòng)創(chuàng)建的集群，需要在分布式

緩存管理平臺(tái)錄入服務(wù)相關(guān)配置信息，分布式緩存管理平臺(tái)才能對(duì)其進(jìn)行管理。自動(dòng)發(fā)布是指：通

過(guò)分布式緩存管理平臺(tái)自動(dòng)發(fā)布服務(wù)，部署到各個(gè)機(jī)器節(jié)點(diǎn)，并對(duì)其進(jìn)行管理，同樣也需要錄入服

務(wù)相關(guān)配置信息。

手動(dòng)發(fā)布和自動(dòng)發(fā)布的區(qū)別在于當(dāng)管理平臺(tái)無(wú)法提供服務(wù)或者自動(dòng)發(fā)布多次失敗，而應(yīng)用系統(tǒng)

又急需使用分布式緩存集群時(shí)，作為一種應(yīng)急方法，緩存集群管理員登錄到分布式緩存運(yùn)行平臺(tái)的

某個(gè)服務(wù)器上，手T創(chuàng)建目錄，復(fù)制相應(yīng)的文件到目錄下，手動(dòng)創(chuàng)建集群；自動(dòng)發(fā)布則是緩存集群

管理員登錄分布式緩存管理平臺(tái)，錄入集群基本信息，通過(guò)管理平臺(tái)功能頁(yè)面上傳相應(yīng)的資源文件

后，管理平臺(tái)自動(dòng)推送這些文件到服務(wù)器相應(yīng)目錄下，自動(dòng)創(chuàng)建緩存服務(wù)并發(fā)布。如無(wú)特殊情況,

不允許進(jìn)行手工發(fā)布。

7.2.1服務(wù)發(fā)布

在應(yīng)用系統(tǒng)需要使用分布式緩存服務(wù)但目前還沒(méi)有可供其使用的緩存服務(wù)時(shí)，通過(guò)服務(wù)發(fā)布功

能創(chuàng)建一個(gè)新的緩存服務(wù)，滿足其需求。

操作方法

1.通過(guò)左側(cè)“緩存服務(wù)發(fā)布管理”功能入口進(jìn)入服務(wù)發(fā)布列表，如圖

-血&件

■?物發(fā)有狀布■魚(yú)位組，

友011僦%至哈

tB

1—門------->?務(wù)友石入口

吟雜發(fā)商人波布植布發(fā)若奇勺發(fā)布弭日■律用作

京友壽Jt

CluUr%日均左希中日功龍布0305:40(jj*

】“14M3)自iJX發(fā)毫819*8-1201口5*$1616聞613?&€119?勢(shì)煙《?煙圖8??舒勢(shì)網(wǎng)對(duì)6161，1613?煙11湖畫X

j<01IIXIMC成功自闞有2015*0161025:02(￡|*

1M?.1???-<*XWX

elliO4M成功自湖tWi2012-1311:8:3值jX

9

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

2.點(diǎn)擊“服務(wù)發(fā)布”列表頭部的“服務(wù)發(fā)布”按鈕，進(jìn)入“服務(wù)基本信息”頁(yè)面。如圖:

服努更本偌息->

應(yīng)《系的濾

.系統(tǒng)編碼|"］等期增

應(yīng)用系統(tǒng)：

SD啊||

“使用時(shí)可的

?至.電

*注冊(cè)發(fā)布原因：I

下一步返回

3.輸入服務(wù)基本信息和應(yīng)用系統(tǒng)信息。

服務(wù)基本信息包括：

>服務(wù)名稱：分布式緩存集群唯一的名稱標(biāo)識(shí)。必須字母開(kāi)頭，可以包含數(shù)字英文下劃

線。建議是ClusterOOl形式。

>是否獨(dú)享：緩存集群是否能被其他應(yīng)用系統(tǒng)申請(qǐng)使用。是：則可以使用，否：不允許

使用。

>節(jié)點(diǎn)數(shù)量：節(jié)點(diǎn)數(shù)量最低為3個(gè)，最多為1000,可以通過(guò)系統(tǒng)參數(shù)來(lái)控制邊界，節(jié)點(diǎn)

的數(shù)量為緩存集群最終創(chuàng)建緩存集群節(jié)點(diǎn)的個(gè)數(shù)，不包括管理節(jié)點(diǎn)。

>節(jié)點(diǎn)內(nèi)存大小：節(jié)點(diǎn)內(nèi)存的大小，所有節(jié)點(diǎn)相同。在緩存中存放應(yīng)用系統(tǒng)的哪些數(shù)據(jù),

數(shù)據(jù)量大小，需要多少個(gè)Cache,并估算緩存內(nèi)存容量，緩存內(nèi)存容量的估算方式參考如下：

緩存內(nèi)存大小=（（緩存數(shù)據(jù)大小+索引大?。?2（主數(shù)據(jù)和備份數(shù)據(jù)））+JVM工作內(nèi)存（大約

1GBJVM內(nèi)存的30%）,假設(shè)緩存數(shù)據(jù)大小為1GB,索引大小為0.4GB,JVM為0.3東1GB,那么總

的內(nèi)存大小為（1GB+0.4GB）2+1GB*0.3=3.1GB0

確保在FullGC之后內(nèi)存的使用量不超過(guò)JVM總內(nèi)存的75%（例如1GB的JVM,不要超過(guò)

10

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

750MB),空閑的內(nèi)存空間會(huì)用于其它目的，比如備份等；

最后算出的總內(nèi)存大小為3.1GB/0.75=4.13GB

>數(shù)據(jù)分區(qū)模式：建議使用復(fù)制緩存。

(1)復(fù)制緩存(ReplicatedCache)

數(shù)據(jù)在集群成員中進(jìn)行全復(fù)制，每個(gè)節(jié)點(diǎn)都有一個(gè)完整的數(shù)據(jù)拷貝。這種集群下，read性能最

iW(cache.get(key)操作),容錯(cuò)性好，但cache.put(key,value)操作性能較低。如果Node很多，

每次put操作都要在所有成員上執(zhí)行一次。

(2)分區(qū)緩存(Distributed(Partitioned)Cache)

Coherence的亮點(diǎn)。默認(rèn)情況下，一份數(shù)據(jù)A只在兩個(gè)節(jié)點(diǎn)上有拷貝，第二份作為備份數(shù)據(jù)

(Backup),用于容錯(cuò)。

從整體上看，假設(shè)應(yīng)用需要的Cache總內(nèi)存為M,該模式將數(shù)據(jù)分散到N個(gè)節(jié)點(diǎn)上，每個(gè)

JVM只占用M/N的內(nèi)存消耗，與復(fù)制緩存每節(jié)點(diǎn)消耗M量的內(nèi)存形成對(duì)比，它可以極大節(jié)

省內(nèi)存資源。

(3)Near緩存(NearCache)

分區(qū)緩存的改進(jìn)版。分區(qū)緩存將數(shù)據(jù)全部存到CacheNode上，而Near緩存將緩存數(shù)據(jù)中

使用頻率最高的數(shù)據(jù)(熱點(diǎn)數(shù)據(jù)Hotspot)放到應(yīng)用的本地緩存(LocalCache)區(qū)域。由于本地內(nèi)

存訪問(wèn)的高效性，它可以有效提升分區(qū)緩存的read性能。

>訪問(wèn)安全類型：有或無(wú)，如果設(shè)置有，則集群采用身份令牌(token)的方式控制集群

的安全。如果用戶需要訪問(wèn)安全控制，則選擇有，如果選擇無(wú)，別的應(yīng)用系統(tǒng)也可以訪問(wèn)該集

群，無(wú)安全控制。

>數(shù)據(jù)持久化類型：

Write-Through：

Write-Through對(duì)應(yīng)于數(shù)據(jù)修改操作,如update,也具有同步的特點(diǎn)。

應(yīng)用調(diào)用CacheStoreupdate教據(jù)X,CacheStore先updateCache中的數(shù)據(jù)，然后再向

數(shù)據(jù)庫(kù)執(zhí)行update操作。這種模式在一個(gè)同步過(guò)程中，先改Cache,再改數(shù)據(jù)庫(kù)。因此性

能也不是最理想的。

Refresh-Ahead：

與Read-Through相對(duì)，它是異步的。Coherence在Cache數(shù)據(jù)過(guò)期前，有CacheStore自

11

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

動(dòng)重新從數(shù)據(jù)庫(kù)加載數(shù)據(jù)。而前臺(tái)應(yīng)用在查詢數(shù)據(jù)時(shí)，CacheStore僅調(diào)用Cache.get(X)。因

此這種模式的效率明顯高于read-througho自動(dòng)重載數(shù)據(jù)的時(shí)間可以設(shè)定。

Write-behind：

與write-through相對(duì)，它是異步的。

應(yīng)用調(diào)用CacheStore進(jìn)行update時(shí)，CacheStore不去操作數(shù)據(jù)庫(kù)，直接返回結(jié)果。而

Coherence集群自動(dòng)對(duì)操作進(jìn)行排隊(duì)(queue),在間隔一段時(shí)間后(interval),CacheStore在執(zhí)行

隊(duì)列中的update操作。這樣，減少的同步操作數(shù)據(jù)庫(kù)的時(shí)間被節(jié)省，修改類功能的性能

就能得到大幅提高。這也是Coherence的一大特色。

>服務(wù)訪問(wèn)方式：

(1)集群成員：

使用這種方式連接緩存集群，集群管理員要保證待上傳的配置文件

tangosol-coherence-override.xml中關(guān)于集群網(wǎng)絡(luò)配置、集群名稱與服務(wù)基本信息中

的對(duì)應(yīng)配置保持一致即可(該XML文件需要事先準(zhǔn)備好，在服務(wù)發(fā)布配置頁(yè)面上

傳)。

<?xnlversion=*1.0,?>

xmlr；；：：<Z//2001/XMLSchama-instancaw

：.^a-https//xmlns.oracle.com/coherence/coherence"

xsi:schemaLocation="http://xmlns.oracle.co*/coherei

>200<

600000

.y.：tam-prr：rcrttangosol.coharance.guard.tiaMOUt">605000

與藤務(wù)基本信息頁(yè)面中服務(wù)名稱保持一致

</roember-ide

least與服務(wù)基本信息頁(yè)面中多播地址及注口保持一致

如臬緩存中不需要存放POF對(duì)象則不需要這

段配置內(nèi)容

com?tangosol?io?pof?ConfigurablePofContext

String

->pof-config.xml

init

12

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

安全訪問(wèn)相關(guān)配置一＞

Specifieswhethertheaccesscontrollersecurityfeatureisenabled.

Logalvaluesaretruoorfalso.Thedefaultvalueisfals?.

一一7

?；,,=*cangosol.coherence.security"true

<login-nodu:y^teaL-property**cotexence.security.loginmodule"HTCoherence</login-AOdule-naae>

<acc*ss~con^rolloz>

「c-r.am^>cn?gov.custoc&s.casp.sdk.hmdg.cluster.controller.HTAccessController</'二aa-nam@>

《/ACCESS"Con^xollor>

<identity"assorter>

<<.："cn.gov.customs.casp.sdk.hoKig.clustor.axtond.iTTIdantityAssortor

</id?ntity-as8erter>

<!-usedformanagenbean

<callback-handlar>

<c1ass-nam>cn.gov.customs?c^sp.sdk.hmdg.jaas.HTCohorencoCalXbackHandl9r</class-naD?>

1/callback-hand工?工》—>

</*acurity-confiq>

<!-日志輸出相關(guān)配■->

<logging-config>0如果集群不啟用安全訪向控制,則這段

<destinationsysten-proporty-=**tangosol.coherence.log*Iog4j</d9sti配■內(nèi)容注蕤抻即可

syste?-prop^i.="tanqosol.coherence.log.level-S

<character-1imitsystem-property-~tangosol.coherence.log.limit-0

</logging-config>

</coherence>

(2)ExtendClient:

通過(guò)在集群端開(kāi)啟代理節(jié)點(diǎn)作為服務(wù)端，然后SDK客戶端通過(guò)客戶端的方式連

接到服務(wù)端的方式。且保證應(yīng)用系統(tǒng)與緩存集群間的網(wǎng)絡(luò)環(huán)境支持TCP/IP協(xié)議即可

(在緩存集群這一端的開(kāi)啟代理的節(jié)點(diǎn)使用的節(jié)點(diǎn)專屬配置文件

Coherence-cache-config.xml中添加如下內(nèi)容，在服務(wù)發(fā)布配置頁(yè)面上傳)。

>ExtendlcpProxyService</service-nane>

<occeptor-config>

<tcp-acceptor>

<local-address>

<address>localhost</dddre&s>-需要修改成開(kāi)啟21蘋□的節(jié)點(diǎn)所在服務(wù)鐳的IP地址及空閑共□?如臬一個(gè)集群內(nèi)有多個(gè)節(jié)點(diǎn)

<part>9099</part>開(kāi)2代II.則計(jì)對(duì)這些節(jié)點(diǎn)都需要上作其專屬配置(這里都需要改成耳個(gè)節(jié)點(diǎn)對(duì)應(yīng)的內(nèi)容)

</local-address)

</tcp-accej>tor>

</acceptor-confx|>

<proxy-config>

<cocbe-serviceT>roxy>

<enabled>true</enabled>

</cache-service-proxy>

<invoc?tion-service-proxy>

<enabled>true</enabled>

</invocation-servicen>roxy>

</proxy-config>

<autostart>true</8utostart>

:hing.schemes〉

(3)Rest:

如果為Rest方式，可以通過(guò)WEB瀏覽器直接訪問(wèn)這個(gè)Rest服務(wù)，而且Rest形式

發(fā)布的緩存服務(wù)是分布式緩存管理平臺(tái)專用的，不能被其它應(yīng)用系統(tǒng)使用。

13

分布式緩存二次開(kāi)發(fā)項(xiàng)目用戶使用手冊(cè)

<scheme-name>authinfo-replicated</scheme-name>

<service-name>ReplicatedCache/service-naxne>

<backing-msp-schov&G〉

<local-flchmo/>

UdWm—_在需要啟用Res■務(wù)的緩存集群節(jié)點(diǎn)的節(jié)點(diǎn)電屬配置文件中上傳8hereng

cad)e-config.xml,在這個(gè)文件中漆加框中內(nèi)容,其余郃分參考同集群其它節(jié)

-----------------------------------------------------------------------------------------------4f-------------------------------------------------------------------------------1

<proxy-scheM>

<service-name>ExtendHttpProxySGrvice</service-name>

<thread-count>5</thread-coxmt>

如臬需要對(duì)外提供Res斕務(wù),則此郃分內(nèi)容需要修改成該節(jié)點(diǎn)所在廉務(wù)器真實(shí)IP

localhost及一個(gè)空閑的堵口

8888</port>--**

<ins^*nc<>

<class-name>cn.gav,customs.casp?hmdg?net,resource.HTResourceConfig</class-naro€

</instance>

</resource-config>

</http-acceptor>

</acceptor-config>

<autostart>true</autostart>

</proxy-?ch?me>

〈/caching-3chemes>

</cache-config>

>多播地址:

即組播地址，是一組主機(jī)的標(biāo)示符，它已經(jīng)加入到一個(gè)多播組中。

示例：55o

>多播端口：

與多播地址配套使用的一個(gè)通訊端口。

>描述：

寫的是發(fā)布服務(wù)的情況的一些信息。

服務(wù)發(fā)布頁(yè)面中的應(yīng)用系統(tǒng)信息包括如下幾項(xiàng)：

>