【问题描述】

多应用服务器环境下，某个应用服务器更新缓存后，缓存通知系统会立即上报管理中心，管理中心再下发通知到该数据中心绑定的其它应用服务器，从而实现多个应用服务器间缓存的自动同步。

如果部署不当，会造成缓存自动同步功能失效。

失效场景1：

<1>登录B应用服务器的客户端，打开某个业务单据。

<2>登录A应用服务器的BOSIDE，修改了某个业务单据的元数据，例如加个字段。

<3>再次登录B应用服务器的客户端，打开某个业务单据，界面上看不到步骤2新加的字段。

【排查步骤】

<1>检查每台应用服务器的星空安装目录下的Kingdee\K3Cloud\WebSite\App_Data\Common.config配置文件的appSettings节点下的参数IsNoticeUpdateCache，该参数默认值为true。只有当该参数配置为true的时候，多应用服务器间才会同步缓存。

<!--是否允许通知其他站点更新缓存，默认允许-->

<add key="IsNoticeUpdateCache" value="true" />

<2>检查每台应用服务器的星空安装目录下的Kingdee\K3Cloud\WebSite\App_Data\Common.config配置文件的appSettings节点下的参数managementSiteUrl，集群内的所有应用服务器应该指向同一个管理中心。

<!--管理中心Url-->

<add key="managementSiteUrl" value="http://HSZC1707-0189:8000" />

<3>登录管理中心，检查当前数据中心是否已关联了集群内的所有应用服务器。

<4>检查管理中心后台服务运行是否正常，即使运行正常，也可尝试重启该服务（可随时重启）。

检查管理中心后台服务是否在运行。

检查管理中心后台服务日志是否存在异常。

检查管理中心后台服务的组件版本是否存在异常。

如有必要，可重新注册该服务，重新启动该服务。

【K3CloudManager服务详解】https://vip.kingdee.com/article/8772

<5>检查管理中心站点和应用站点的站点配置文件是否正常。

管理中心站点：

C:\Program Files (x86)\Kingdee\K3Cloud\ManageSite\App_Data\KDEnvironment.xml

C:\Program Files (x86)\Kingdee\K3Cloud\ManageSite\App_Data\SiteInfo.xml

应用站点：

C:\Program Files (x86)\Kingdee\K3Cloud\WebSite\App_Data\SiteInfo.xml

检查MCUrl地址是否正确。

<6>检查管理中心站点和应用站点的日志文件是否有异常日志输出。

管理中心日志地址：

C:\Program Files (x86)\Kingdee\K3Cloud\ManageSite\App_Data\Log

应用站点日志地址：

C:\Program Files (x86)\Kingdee\K3Cloud\WebSite\App_Data\Log

日志查询关键字：

NoticeMcToUpdateCache（如果缓存刷新的通知发送异常，发起该通知的应用服务器的Log文件，会输出此日志）

UpdateFormTypeVersion2MCAppCache

MetaVersionAsyncCache.AsyncMetaCacheFromMC

UpdateCacheByKey（被通知到的应用服务器的Log文件，会输出此日志）

<7>如果排查到此，仍未解决问题，可调整日志输出等级，获取更多的异常线索。

检查每台应用服务器的星空安装目录下的Kingdee\K3Cloud\WebSite\App_Data\Common.config配置文件的appSettings节点下的参数OpenLogModel，该参数默认值为false。

<!--开启日志记录模式-->

<add key="OpenLogModel" value="true"/>

重启IIS后，再对新输出的日志进行分析。

---------------------------------------------------------------------------------------------------------

【注意事项】

所有的Common.config参数，都需要重启IIS后才能生效。

---------------------------------------------------------------------------------------------------------

【金蝶云星空BOS二次开发案例演示】https://vip.kingdee.com/article/94751030918525696