04、公共同步服务安装配置说明

1、密文档级：一般：公共同步服务安装配置手册郑州新电子总页数版本1.0建立日期2011/12/07编制人审核人批准人批准日期保管人存放位置文件修改控制*变化状态：A增加，M修改，D删除序号版本*变化状态修改内容、页码及条款修改人批准人修改日期011.0A新功能模块凡2011-12-07目录1. 简介4目的4读者对象4术语定义42. 系统架构和部署4系统环境要求4硬件环境4软件环境5网络环境52.2. 软件介绍53. 安装说明53.1 安装注意事项54. 设置说明6配置工具主界面6配置说明65. 日志说明105.1. 日志分布及说明106. 常见问题10表或视图不存在10同步数据由空转零情况107.

2、 同步任务配置说明(技术) . 11单个同步任务增加11增加一个客户的同步任务11注意事项11公共同步服务安装配置手册1.简介1.1.目的本部署手册，对公共(移动、电信多客户)同步服务系统架构进行说明，并提供系统中逐个环节的安装配置介绍，以对现场安装部署、技术技术支持工作提供帮助。1.2. 读者对象本说明书预期读者为项目实施、技术支持。1.3. 术语定义本说明书使用到的术语如表 1 所示。表 1术语表2.系统架构和部署2.1. 系统环境要求2.1.1. 硬件环境系统硬件基本要求如下：处理器：双核 2.6 GHz 或更快的处理器；RAM：术语名称术语说明同步服务一卡通(中心门户（公共库）提供数据

3、传输同步的 Windows服务同步标记当前同步服务同步到的标记最小 1GB；4GB 以上硬盘：5400 RPM 以上硬盘驱动器，40GB 以上可用空间。2.1.2. 软件环境支持操作系统（仅限 32 位）如表 2 所示。表 2应用支持操作系统表环境：.NET Framework 2.0 以上版本。2.1.3. 网络环境100Mbps 以上以太网。2.2. 软件介绍公共同步服务是 Windows 服务程序，主要负责，通讯方式为 TCP/IP。公共同步服务主要功能如下：向一卡通（中心库）Web 服务发起数据同步请求，收到待同步数据后，再向门户（公共库）Web 服务向发起同步申请。并返回同步结果，并

4、同步标记。3.安装说明3.1 安装注意事项如上图所示，安装包里有两个可执行文件，安装的时候，setup.exe.该可执行程序会在安装前检查公共同步服务运行所需要的环境是否具备。不具备的时候会提示安装。支持但不不支持Windows Server 2003 SP1 以上 Windows Server 2008Windows XP Win7Windows 20004.设置说明4.1. 配置工具主界面4.2. 配置主界面说明1、选择配置文件：同步服务安装目录下的“DistributionService.exe.config”文件2、同步间隔时间：同步服务主线程的启动频率，此线程主要负责获取同步服务的配

5、置任务，并针对最大线程数均分异步执行。3、日志保留天数：允许同步服务日志在电脑系统中保留的天数。4、同步服务类型：同步服务通过什么方式实现数据的同步传输。5、最大线程数：同步服务启动时允许同时启动最大的线程数量，识同步服务的部署环境、待同步数据量而定。6、线程间隔时间：同步服务在启动每个同步子线程时的时间间隔，此项只对最大线程数大于 1 是生效。7、配置表来源：配置信息表（base_distribution）和配置类型表（BASE_DTYPE）所在位置（base_distribution、BASE_DTYPE 放于一卡通定）。是门户而8、日志文件路径：同步服务运行过程志的保存路径，此路径必须存

6、在。4.3. 配置子界面4.4. 配置子界面说明1、请选择配置分类：同步服务可能是从中心公共库同步，同时也从公共中心库同步数据，有多种分类。请选择配置分类默认是全部，当选择后，列表随其变化。第一次配置时列表为空。2、同步数据列表：要同步的信息列表。3、配置分类名称：同步分类的名称。第一次配置时或新增配置分类时，填该名称。第一次配置或为新增的信息配置时，同步数据来源和同步数据目标为空，需为其设置配置分类。 4、已配置分类：已增加过的配置分类，当需要修改同步信息所属的分类时可选择其应所属的分类。5、同步数据来源：同步程序将通过哪里获取待同步数据（指一卡通管理Web 服务），可点后面的“测试连接”进

7、试。6、同步数据目标：同步程序将通过哪里将获取的待同步数据传送到目标源（指门户Web服务），可点后面的“测试连接”进试。7、是否启用：同步信息是否启用。当选择启用时，服务开启后就会同步该信息，选择“否”时，该信息不会发生同步。8、删除：若配置信息列表有选中的，删除时只会删除配置信息表相应的。若都没有选中，已配置分类下拉列表有选中的分类，则会删除分类。4.5. 配置步骤首先配置主界面：1、 选择配置文件后，配置工具会自动用配置文件中的配置项的值初始化配置工具。2、点“测试连接”之后出现如下提示方为成功！否则失败。3、配置主界面信息填写完整后，点击“配置”按钮设置配置信息表信息的同步数据来源和同步

8、数据目标，若配置表来选填写正确，弹出如下子界面，否则弹出失败原因提示。4、若配置信息列表为空，表示还没执行，应执行。若执行了，配置列表会显示要同步的信息，这时服务名称，同步数据来源和同步数据目标都为空，尚未为其设置。5、选择这些类型相同的信息，填写配置分类名称、同步数据来源、同步数据目标，选择“是否启用”后，点击保存，保存配置信息。6、若同步分多种情况（有从中心公共库同步的，也有从公共中心库同步，或其他同步情况的），可选择后，重复步骤 5，增加分类和设置相应的配置信息。7、若某些配置错误，需调整配置分类，可选择“已配置分类”下拉列表，选择后，点击“保存”，保存配置信息。8、若某些已不需再执行同

9、步任务，可选择后，点击“删除”按钮，删除。9、配置好后的子界面如下图所示：10、配置好后，点击“退出”按钮，关闭该子界面，回到主界面，如下图：10、主界面信息填完整后，点击“确定”按钮保存配置信息5.日志说明5.1. 日志分布及说明日志文件默认路径为：D:LogServiceLog.txt 文件中按例子所配置的：日志的分布如下图所示6.常见问题6.1. 表或视图不存在同步服务刚启动就出现此问题，请确认同步任务配置信息表 base_distribution 所在“的库与同步服务安装目录下的Web 服务地址指向的库是否一至，保持一直此问题可解决。6.2. 同步数据由空转零情况例如：一卡通(中心库)

10、中的某个字段为空，但同步到门户(公共库)后发现其值从空变成了 0,这属于正常现，为了保证数据顺序同步不受空值影响已对数值类型和字符类型的字段进行了判断，为空进为其赋上默认值“0”。7.同步任务配置说明(技术)7.1. 单个同步任务增加此项工作由技术负责完成，里面要写好取数据 SQL(GETSQL)和入库 SQL(SSQL)及待同步数据依据(VERKEY、VER)后在 base_distribution 表中添加一条，ID 增量保存即可。7.2. 增加一个客户的同步任务将现有客户(某一个客户)的同步任务导出修改其 ID(增量)及获取数据来源(GETURL)和同步数据目标(SURL),并在库中执行即可。7.3. 注意事项1、 新加同步任务不为空的字段必须填写，不得以任何方式修改库中的 base_distribution 表结构，需经过测试通过之后的同步任务才能对客户发