书柜远程维护相关说明 - DigitalPlatform/dp2 GitHub Wiki
书柜远程维护的原理，是维护人员通过dp2managecenter向书柜上的dp2commander或者dp2SSL发送指令，从而获得书柜各项运行数据，或者进行重启书柜系统等操作。
维护人员通过向书柜上的dp2commander发送指令，可以重启dp2SSL或者重启书柜电脑。
维护人员通过向书柜上dp2SSL发送指令发送指令，可以获得书柜各项运行数据。
维护人员通过dp2managecenter向书柜上的dp2commander或dp2SSL发送的指令消息是通过dp2mserver来传递的。
所以，要想实现远程维护书柜系统，必须具备以下几个条件：
-
维护人员的工作电脑上安装dp2managecenter模块。dp2managecenter安装地址：http://dp2003.com/dp2ManageCenter/v1/publish.htm
-
在dp2mserver上为维护人员开通一个账户。
-
在dp2mserver上为书柜上的dp2commander模块开通一个通讯账户。
-
书柜电脑上安装dp2commander模块。详细步骤见文档dp2Commander的安装
-
在dp2mserver上为书柜上的dp2SSL模块开通一个通讯账户。并且书柜上dp2SSL系统参数的【消息服务器】配置好该账户。
-
在dp2mserver上为维护人员和书柜上的dp2commander/dp2SSL开通账户的时候要注意：三个账号要设置到同一个群组下面。这样才能相互通讯。
在dp2内务里，点【帮助/参数设置/消息】，在“消息”属性页，设置dp2mserver服务器的URL和用户名。
服务器的URL固定设置为：http://dp2003.com:8083/dp2mserver 以supervisor登录dp2mserver服务器（设置supervisor的账号和密码）
在内务右侧【固定窗口】打开【分享】属性页，左下角点【用户管理】，弹出对话框后，可以从列表中看到目前已有的账号信息。
点【新增】按钮，给dp2SSL 创建一个消息账号，在弹出的“用户”窗口，输入相关信息。
【用户名】：用户名设置要简单易记，并且要具有唯一性。与书柜远程通讯其实是把一个书柜看成一个“人”，以后维护中看到用户名，要能对应到通讯的是哪个书柜。
【单位】：写使用书柜的用户单位名称简写，尽量一目了然。
【权限】：维护人员和dp2SSL上的账号要配权限searchHistory,setHistory；dp2Commander账号不用配置权限。
【义务】：不用分配。
【群组】：输入gn:<group> ，表示它加入了一个名为 "group"的群组。group是举例，建议群组名字用图书馆单位名字的拼音首字母命名，群组名字要尽量一目了然。因为后面开展的维护管理工作，是在群内共享这些信息的，所以所有参与维护的相关人员和书柜账号要加入到同样的群组，才能相互看到这些讯息。
一个维护人员只需要一个账号就可以，一个账号的在群组参数里面可以包含多个群组，表示这个账号加入了多个群，可以接收多个书柜所发送的讯息。
以上都完成后，维护人员可以通过dp2managecenter发送指令。
配置本地账户：
在dp2managecenter中，点击菜单【消息】-【设置消息账户】，在对话框空白处右击-【新建账户】，输入维护人员在MServer中的账号和密码，勾选“保存密码”选项，点【确定】-【确定】。
此后，点【消息】-【书柜查询】，就可以对当前账户所在的群组中书柜进行相关数据检索。
配置聊天群组：
点菜单【消息】-【聊天】，先添加需要聊天的群组。在右侧群名区域右击鼠标-【添加群名】，在【添加群名】对话框里面输入需要访问的书柜所在的群名，注意一定要带<>输入，比如<dpm>,点【确定】。
如果书柜处于运行状态，在右侧上部的显示区域可以看到书柜的状态的记录。在右侧下半部分的输入框里面输入指令就可以与书柜对话。
如果书柜当前未运行，则看不到任何状态信息。
目前支持的交互命令如下(以下假设书柜dp2SSL上的用户名叫做 robot，dp2Commander上的用户名叫robotcommander)： 控制命令
| 指令目的 | 发送的指令 | 书柜回复/备注 |
|---|---|---|
| 和书柜打招呼 | @robot hello | hello! |
| 查看 dp2SSL 版本号 | @robot version | dp2SSL 前端版本: 1.3.7396.26040 |
| 下载新版本 | @robot update | 开始更新 |
| 查看 dp2SSL 界面底部红色的报错信息 | @robot error | 若没有报错信息，回复：dp2SSL 当前界面报错: []; 书柜初始化是否完成: True。 有错误信息，回复：dp2SSL 当前界面报错: [发送消息失败: The connection has not been established.]; 书柜初始化是否完成: False |
| 列出当前全部书柜本地数据库中的历史动作 | @robot list history | list history 当前共有 0 个历史事项（如果有事项，会列出所有事项详细信息) |
| 列出本地数据库中的尚未成功同步到 dp2library 的动作 | @robot list history new | - |
| 列出本地数据库中的同步到 dp2library 发生错误的动作(即：状态为 normalerror 或 commerror 的那些事项) | @robot list history error | |
| 列出本地数据库中的已经成功同步到 dp2library 的动作 | @robot list history sync | - |
| 列出指定的单个柜门的图书清单 | @robot list book 柜门完整编号，比如@robot list book 6号门 | 需要查询多个柜门时，分柜门发多次指令 |
| 列出指定的前方一致柜门号的图书清单 | @robot list book 1*，表示列出以1开头的所有柜门 | - |
| 列出书柜里面全部图书清单 | @robot list book或者@robot list book *号门 | - |
| 检查一个册当前的状态。其中 xxx 要用册的 PII 代替，大小写不敏感。这个命令会列出本地数据库中和这一册有关的最近 10 个动作状态，和 dp2library 中的这一册的册记录 | @robot check xxx | - |
| 查看书柜本地操作历史信息中的在借(未还)册情况 | @robotcheck patron | - |
| 显示当前最顶层的对话框或者窗口的文字。其中按钮用 [停止] 这样的形态表示 | @robot dialog | - |
| 按下界面上的按钮。xxx 代表按钮上的文字，可以是按钮上文字的中间一部分即可 | @robot press xxx | - |
| 重启dp2ssl | @robot restart | - |
| 要显示的文字 | @robot led | - |
| 启动消毒 | sterilamp | |
| 查本地动作记录的合法性。先找到本地动作记录，然后再从 dp2library 服务器获取册记录，检查是否有矛盾之处，如果发现问题会报告出来 | check book | |
| 查本地动作记录的合法性。先找到本地动作记录，然后再从 dp2library 服务器获取册记录，检查是否有矛盾之处，如果发现问题会报告出来 | check patron | |
| commander命令 | @c_xxx hello | 和commander打招呼 |
| commander命令 | @c_xxx restart dp2SSL | 让commander启动dp2ssl |
| commander命令 | @c_xxx restart computer | dp2SSL运行状态下可以自启动；dp2Commander也可以启动dp2SSL运 |
| dp2managecenter获取actions.db文件 | 在dp2managecenter获取文件功能下，书柜端路径固定为：data/actions.db | 远程路径和本地文件路径中的文件名部分可以不一样 |
| dp2managecenter获取书柜日志文件 | 在dp2managecenter获取文件功能下，书柜端路径固定为：“data/log/log_20200101.txt”形式 | 不能获取当天的日志。远程路径和本地文件路径中的文件名部分可以不一样 |