联机写卡一卡通服务安装指引

介绍

联机写卡一卡通服务程序 YKTOnlineService.exe；该程序是windowsX64服务程序，双击无法运行；
它需要注册成系统服务后才能正常运行，该服务具有排他性，一套一卡通系统只能安装一个服务；

环境依赖

操作系统:Windows X64系统
数据库：MSSQL 2008 R2以上

安装位置

需安装在MSSQL所在服务器上；
路径中不能有中文及特殊符号；
建议直接放在D盘(非系统盘即可)根目录下；

如何安装

• 解压程序目录YKTOnlineService到非系统盘根目录下；例如解压到D盘，路径中不能有中文及特殊符号
  

• 用文本编辑器（如：NotePad++、记事本等）打开《SYSTEM.ini》；根据现场情况设置数据库登录名、密码、数据库名等信息
  
• 配置中的ZEROMQ 的 PortPub和PortPull为MQ服务端口，一般不需要调整；如果遇到其他程序占用，才进行调整
  

• 设置程序的兼容性 - 以管理员身份运行此程序
  

YKTOnlineService.exe及intallServices.exe两个程序均需要设置

• 注册服务
  

双击运行 intallServices.exe；并点击注册服务按钮

如果遇到有安全软件(360、电脑管家、金山卫士等)提示，请选择-允许程序所有操作

注册成功时结果为True; 注册失败时结果为Fail

确认安装

• 检查服务运行是否正确
  

检查 控制面板->服务中，一卡通服务(YQSHOnlineService)是否正常运行

检查服务日志(安装路径下\Log\)
如果服务日志中出现Err、Fail或者异常等字样，表明配置项或运行环境不符合要求
以下是配置正确并正常启动后的日志

在工作站（非MSSQL数据库服务器）上使用telnet检测服务端口(默认:5556和5558)是否正常服务；
在命令提示符(CMD)内输入 telnet IP 5556 其中的IP使用部署一卡通服务主机的IP；然后回车

如果服务端口正常，会如下显示

如果服务端口未开启或防火墙拦截，会如下显示

一卡通配置

• 联机写卡一卡通的配置
  

需要使用管理员账户(默认:admin)登录一卡通；
基础设置->系统参数设置->数据库设置中，设置ZeroMQ服务
服务IP必须设置内网有效IP，不能设置为127.0.0.1;原因是这个配置，所有工作站共用的；
如果配置错误，工作站运行时会报断网锁定错误；