金蝶云星空標準版-分布式緩存使用說明書

DOCID：KDSP_T_V4.0第1頁共8頁金蝶云星空標準版分布式緩存使用說明書修改記錄Ver.No發(fā)版日期編制人批準人修改的章節(jié)號V1.02017/12/08劉兵賴碧云初始版本V1.22018/01/03劉兵賴碧云6.1.2V1.32018/02/24劉兵賴碧云6.1

目錄TOC\o"1-4"\h\z1. 概述 31.1. 目的 31.2. 范圍 31.3. 適用對象 31.4. 參考資料 32. 問題與解決策略 33. 目標和約束 34. 部署Redis服務(wù) 44.1. 安裝服務(wù)--service-install(安裝必須的步驟) 44.2. 卸載服務(wù)--service-uninstall 44.3. 啟動服務(wù)--service-start(安裝必須的步驟) 44.4. 停止服務(wù)--service-stop 54.5. 服務(wù)配置修改（服務(wù)名和端口） 54.6. Redis-cli配置(如果4.1按照2，3小點進行了修改，此節(jié)配置可以忽略) 55. Redis配置文件修改 56. Redis緩存代碼示例 66.1.1. 寫緩存和讀緩存 66.1.2. 錯誤的讀寫緩存 77. 附錄 8

概述目的為系統(tǒng)集群及分布式應(yīng)用提供基礎(chǔ)緩存服務(wù)。范圍適用版本：V6.2和后續(xù)版本適用對象本文檔適用于：開發(fā)工程師：部署和開發(fā)指導(dǎo)。實施人員：部署指導(dǎo)。參考資料Redis相關(guān)資料問題與解決策略愿景關(guān)注點描述與示例目標和約束目標：提供單據(jù)和基礎(chǔ)數(shù)據(jù)的分布式緩存支持；提供系統(tǒng)參數(shù)、單據(jù)參數(shù)、用戶參數(shù)等數(shù)據(jù)的分布式緩存支持；提供分布式緩存接口為其他類型數(shù)據(jù)提供分布式緩存支持約束：分布式緩存開關(guān)并非默認開啟；并非所有數(shù)據(jù)都使用了分布式緩存。部署Redis服務(wù)首先進入到產(chǎn)品安裝目錄K3Cloud/website/bin，將以下文件單獨拷貝到緩存服務(wù)器,新建一目錄，例如Redis，拷貝文件如下：EventLog.dll，redis.windows.conf，redis.windows-service.conf，redis-benchmark.exe，redis-check-aof.exe，redis-cli.exe，redis-server.exe然后以管理員身份進入dos系統(tǒng)，將目錄定位到Redis目錄。如未說明，后續(xù)命令都在該目錄下執(zhí)行。安裝服務(wù)--service-install(安裝必須的步驟)Thismustbethefirstargumentontheredis-servercommandline.ArgumentsafterthisarepassedintheordertheyoccurtoRediswhentheserviceislaunched.TheservicewillbeconfiguredasAutostartandwillbelaunchedas"NTAUTHORITY\NetworkService".UponsuccessfulinstallationasuccessmessagewillbedisplayedandRediswillexit.Thiscommanddoesnotstarttheservice.Forinstance:redis-server--service-installredis.windows.conf--loglevelverbose默認配置的地址是本地地址127.0.0.1端口是6379，如果多應(yīng)用部署分布式緩存，需要在啟動服務(wù)前先修改緩存服務(wù)器配置文件中的地址為具體的IP。打開配置文件，找到bind127.0.0.1，修改IP為具體的IP地址，例如：bind172.17.2.100打開配置文件，找到protected-modeyes修改為protected-modenoredis緩存服務(wù)和k3cloud不在一臺服務(wù)器時，需要此項設(shè)置打開配置文件，找到stop-writes-on-bgsave-errorno修改為stop-writes-on-bgsave-errorno強制停止快照導(dǎo)致不能持久化錯誤處理卸載服務(wù)--service-uninstallThiswillremovetheRedisserviceconfigurationinformationfromtheregistry.UponsuccessfuluninstallationasuccessmessagewillbedisplayedandRediswillexit.Thisdoescommandnotstoptheservice.Forinstance:redis-server--service-uninstall啟動服務(wù)--service-start(安裝必須的步驟)ThiswillstarttheRedisservice.Uponsuccessfulstart,asuccessmessagewillbedisplayedandRediswillbeginrunning.Forinstance:redis-server--service-start停止服務(wù)--service-stopThiswillstoptheRedisservice.UponsuccessfulterminationasuccessmessagewillbedisplayedandRediswillexit.Forinstance:redis-server--service-stop服務(wù)配置修改（服務(wù)名和端口） Thisoptionalargumentmaybeusedwithanyoftheprecedingcommandstosetthenameoftheinstalledservice.Thisargumentshouldfollowtheservice-install,service-start,service-stoporservice-uninstallcommands,andprecedeanyargumentstobepassedtoRedisviatheservice-installcommand.ThefollowingwouldinstallandstartthreeseparateinstancesofRedisasaservice:redis-server--service-install--service-nameredisService1--port10001redis-server--service-start--service-nameredisService1Redis-cli配置(如果4.1按照2，3小點進行了修改，此節(jié)配置可以忽略)使用redis-cli.exe進行配置時，需要先雙擊打開redis-server.exe（打開前如果之前已經(jīng)啟動了服務(wù)，先停止）打開redis-server后，再雙擊打開redis-cli.exe在窗口依次輸入以下配置指令：1）configsetprotected-modenoredis緩存服務(wù)和k3cloud不在一臺服務(wù)器時，需要此項設(shè)置2）configsetstop-writes-on-bgsave-errorno強制停止快照導(dǎo)致不能持久化錯誤處理Redis配置文件修改在金蝶云星空website/app_data/KCache.config文件中：<RCacheSettingCacheTypeID="RedisCache"Switch="ON"LogSwitch="OFF"><RCachePathID="Redis1"Switch="ON"Timespan="28800"Host="127.0.0.1"Port="6379"/></RCacheSetting>端口號默認使用6379，可以配置多個緩存服務(wù)器，如果不想使用Redis緩存，則設(shè)置Swith="OFF"，多應(yīng)用服務(wù)器部署，需要明確Host的地址。Redis緩存代碼示例寫緩存和讀緩存調(diào)用參考：publicCacheProcessGetCacheProcessByVersionId(Contextctx,stringversionId){IKCacheManagercacheMgr=RCacheManagerFactory.Instance.GetCacheManager(CacheProcess.CacheKey,ctx.GetAreaCacheKey());CacheProcesscacheProcess=cacheMgr.Get<CacheProcess>(versionId);if(cacheProcess==null){WorkflowModelRepositoryrep=newWorkflowModelRepository();cacheProcess=rep.ReadProcess(ctx,versionId);cacheMgr.Set<CacheProcess>(versionId,cacheProcess);}returncacheProcess;}注意：業(yè)務(wù)插件代碼讀寫緩存的時候，如果是自己使用KCacheManagerFactory來管理緩存，則需要替換成RCacheManagerFactory，其他的如Put和Get的寫法保持不變。使用CacheUtil的代碼不需要處理，平臺統(tǒng)一進行了處理。另外如果是循環(huán)從緩存讀寫數(shù)據(jù)，需要參考以下寫法，否則可能引發(fā)性能問題，如果循環(huán)讀取使用的是CacheUtil，則建議在循環(huán)外使用RCacheManagerFactory來管理緩存。循環(huán)讀寫緩存示例：（重點關(guān)注紅色注釋）//使用using括起來，便于自動釋放連接對象using(IKCacheManagerkcmger=RCacheManagerFactory.Instance.GetCacheManager(strUserParameterRegion,ctx.GetAreaCacheKey())){IRCacheManagerrcmger=kcmgerasIRCacheManager;if(rcmger!=null){//SetConnectionCloseFlag，設(shè)置Redis連接不自動關(guān)閉，減少每次訪問Redis都去重新建立連接的開銷rcmger.SetConnectionCloseFlag(false);}DynamicObjectCollectionobjs=DBUtils.ExecuteDynamicObject(ctx,sql,null,null,CommandType.Text,paramlist.ToArray());if(objs!=null&&objs.Count>0){//省略代碼foreach(DynamicObjectiteminobjs){//嘗試從緩存取longuserId=long.Parse(item["FUserId"].ToString());stringstrCacheKey=UserParameterUtils.ReturnUserParameterCacheKey(userId,parameterFormId,parameterObjId,KeyConst.USERPARAMETER_KEY);DynamicObjectobj=kcmger.Get(strCacheKey)asDynamicObject;//省略代碼}//清除所有用戶參數(shù)緩存stringstrUserId="selectFUserIdfromt_sec_user";