查看“联机写卡一卡通服务安装指引”的源代码

=== 介绍 ===
联机写卡一卡通服务程序  YKTOnlineService.exe；该程序是windowsX64服务程序，双击无法运行；<br>
它需要注册成系统服务后才能正常运行；<br>
<font color="red">'''该服务具有排他性，一套一卡通系统只能安装一个服务；'''</font>   <br>
<font color="red">'''特别注意:一卡通服务和一卡通程序要使用同一个数据库；'''</font> 

=== 硬件要求 ===
请参看 [[配置要求|配置要求]]

=== 环境依赖 ===
操作系统:Windows X64系统<br>
数据库：MSSQL 2008 R2以上<br>

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

=== 如何安装 ===
* 解压程序目录YKTOnlineService到非系统盘根目录下；例如解压到D盘，路径中不能有中文及特殊符号<br>
[[文件:YKTOnlineM1 Service Path.png|有框|无]]<br>
* 用文本编辑器（如：NotePad++、记事本等）打开《SYSTEM.ini》；根据现场情况设置数据库登录名、密码、数据库名等信息<br>
* 配置中的ZEROMQ 的 PortPub和PortPull为MQ服务端口，一般不需要调整；如果遇到其他程序占用，才进行调整<br>
[[文件:YKTOnlineService System.png|有框|无]]<br>
* 设置程序的兼容性 - 以管理员身份运行此程序<br>
YKTOnlineService.exe及intallServices.exe两个程序均需要设置<br>
[[文件:YKTOnlineService Exe1 Set.png|有框|无]]
[[文件:YKTOnlineService Exe2 Set.png|有框|无]]
<br>
* 注册服务<br>
双击运行 intallServices.exe；并点击注册服务按钮<br>
[[文件:YKTOnlineService Install 01.png|有框|无]]
如果遇到有安全软件(360、电脑管家、金山卫士等)提示，请选择-允许程序所有操作<br>
[[文件:YKTOnlineService Install 02.png|有框|无]]
注册成功时结果为True; 注册失败时结果为Fail<br>
[[文件:YKTOnlineService Install 03.png|有框|无]]

=== 确认安装 ===
* 检查服务运行是否正确<br>
检查 控制面板->服务中，一卡通服务(YQSHOnlineService)是否正常运行<br>
[[文件:YKTOnlineService Install 05.png|有框|无]]
* 检查服务日志(安装路径下\Log\)<br>
如果服务日志中出现Err、Fail或者异常等字样，表明配置项或运行环境不符合要求<br>
以下是配置正确并正常启动后的日志<br>
[[文件:YKTOnlineService Install 04.png|有框|无]]
* 检查服务端口是否正常
在工作站（非MSSQL数据库服务器）上使用telnet检测服务端口(默认:5556和5558)是否正常服务；<br>
在命令提示符(CMD)内输入 telnet IP 5556  其中的IP使用部署一卡通服务的主机IP；然后回车；<br>
例如： telnet 192.168.2.67 5556 和  telnet 192.168.2.67 5558
[[文件:Telnet 5556 01.png|有框|无]]
如果服务端口正常，会如下显示
[[文件:Telnet 5556 02.png|有框|无]]
如果服务端口未开启或被防火墙拦截，会如下显示
[[文件:Telnet 5556 03.png|有框|无]]

=== 一卡通配置 ===
* 联机写卡一卡通的配置<br>
需要使用管理员账户(默认:admin)登录一卡通；<br>
基础设置->系统参数设置->数据库设置中，设置ZeroMQ服务<br>
服务IP必须设置内网有效IP，不能设置为127.0.0.1;原因是这个配置，所有工作站共用的；<br>
[[文件:YKTOnline Set 01.png|有框|无]]

* 如果配置错误，工作站运行时会报断网锁定错误；<br>
* 如果配置错误，服务器日志中也会出现 “初始化错误-本机无使用授权”的提示，如下图；<br>
[[文件:企业微信截图 167886351585.png|有框|无]]