“联机写卡一卡通服务安装指引”的版本间的差异

2023年9月28日 (四) 13:28的最新版本

介绍

联机写卡一卡通服务程序 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；然后回车；
例如： telnet 192.168.2.67 5556 和 telnet 192.168.2.67 5558

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

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

一卡通配置

联机写卡一卡通的配置

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

如果配置错误，工作站运行时会报断网锁定错误；
如果配置错误，服务器日志中也会出现 “初始化错误-本机无使用授权”的提示，如下图；

解决方法

在联机写卡一卡通进行重新配置ZeroMQ的服务IP，然后重启一卡通服务即可

@@ 第1行： / 第1行： @@
 === 介绍 ===
-联机写卡一卡通服务程序  YKTOnlineService.exe；该程序是windows服务程序，双击无法运行；<br>
+联机写卡一卡通服务程序  YKTOnlineService.exe；该程序是windowsX64服务程序，双击无法运行；<br>
-它需要注册成系统服务后才能正常运行，该服务具有排他性，一套一卡通系统只能安装一个服务；<br>
+它需要注册成系统服务后才能正常运行；<br>
+<font color="red">'''该服务具有排他性，一套一卡通系统只能安装一个服务；'''</font>   <br>
+<font color="red">'''特别注意:一卡通服务和一卡通程序要使用同一个数据库；'''</font>
+=== 硬件要求 ===
+请参看 [[配置要求|配置要求]]
+=== 环境依赖 ===
+操作系统:Windows X64系统<br>
+数据库：MSSQL 2008 R2以上<br>
 === 安装位置 ===
@@ 第11行： / 第20行： @@
 * 解压程序目录YKTOnlineService到非系统盘根目录下；例如解压到D盘，路径中不能有中文及特殊符号<br>
 [[文件:YKTOnlineM1 Service Path.png|有框|无]]<br>
-<br>
 * 用文本编辑器（如：NotePad++、记事本等）打开《SYSTEM.ini》；根据现场情况设置数据库登录名、密码、数据库名等信息<br>
-[[文件:YKTOnlineService System.png|有框|无]]
+* 配置中的ZEROMQ 的 PortPub和PortPull为MQ服务端口，一般不需要调整；如果遇到其他程序占用，才进行调整<br>
-<br>
+[[文件:YKTOnlineService System.png|有框|无]]<br>
-* 设置程序的兼容性 - 以管理员身份运行此程序  YKTOnlineService.exe及intallServices.exe均需要设置<br>
+* 设置程序的兼容性 - 以管理员身份运行此程序<br>
+YKTOnlineService.exe及intallServices.exe两个程序均需要设置<br>
 [[文件:YKTOnlineService Exe1 Set.png|有框|无]]
 [[文件:YKTOnlineService Exe2 Set.png|有框|无]]
 <br>
-* 注册服务并检查运行情况<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|有框|无]]
-检查 控制面板->服务中，一卡通服务是否正常运行<br>
+* 检查服务端口是否正常
-[[文件:YKTOnlineService Install 05.png|有框|无]]
 在工作站（非MSSQL数据库服务器）上使用telnet检测服务端口(默认:5556和5558)是否正常服务；<br>
-在命令提示符(CMD)内输入 telnet IP 5556  其中的IP使用部署一卡通服务主机的IP；然后回车
+在命令提示符(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>
-如果配置错误，工作站运行时会报断网锁定错误；<br>
 [[文件:YKTOnline Set 01.png|有框|无]]
+* 如果配置错误，工作站运行时会报断网锁定错误；<br>
+* 如果配置错误，服务器日志中也会出现 “初始化错误-本机无使用授权”的提示，如下图；<br>
+[[文件:企业微信截图 167886351585.png|有框|无]]
+* 解决方法<br>
+在联机写卡一卡通进行重新配置ZeroMQ的服务IP，然后重启一卡通服务即可