如何创建SIP2账户 - DigitalPlatform/dp2 GitHub Wiki

当dp2系统搭配助借还机，漂流柜或者其他系统的馆员工作站工作时，需要先为这些设备创建SIP2账户。

由于此操作涉及到服务器端的修改，一般建议由级别较高的系统管理员来进行。

创建SIP2账户分为三个阶段：

  1. 到服务器所在的电脑上创建SIP2账户

  2. 通过内务访问服务器创建SIP2账户

  3. 验证账户是否可以正常登录

以下是具体操作。

1. 在服务器所在的电脑上创建SIP2账户

先登录到服务器所在的电脑上，打开【Chord Installer安装实用工具】，进入【ChordInstaller--Chord安装工具】。点击【dp2capo】-【配置实例】，进入【配置dp2Capo的实例】对话框，在需要创建SIP账户的实例名上双击，系统弹出【一个实例】对话框，点击【SIP服务】一栏右侧的【...】按钮，系统弹出【SIP服务参数】对话框。

点击其中的【SIP】标签，进入【SIP】属性页。【SIP】属性页左侧为SIP账号显示区，右侧为账户信息区。

首先勾选【启用本实例的SIP服务】（默认情况下该选项处于不勾选状态）；然后点击【新增】按钮，系统弹出【创建新用户事项】对话框，在对话框里面输入账户名称，一般采用字母和数字的组合，给账户起名时注意名字最好能体现当前设备的类型。比如自助借还机账号取名为“zizhu_”+分馆缩写；馆员工作站取名为“guanyuan_”+分馆缩写的形式。然后点【确定】。这时新建账户名称显示在左侧区域。

界面右侧账户信息区内，显示了当前账户的编码方式，显示时间格式。【编码方式】默认为“UTF-8”,【时间格式】默认为yyyy-MM-dd，用户可以根据需要从下来列表选择设置其他方式。

【通道自动清理】一栏，建议设置为120，表示当前账户登录前端后，如果120秒没有进行任何操作，系统将自动清理当前通道，这样可以防止账号登录后忘记退出，而被其他无关人员使用账号的情况。

以上都设置好后，点击【确定】按钮，关闭【SIP服务参数】对话框；再点击【确定】，关闭【一个实例】对话框。

在【配置dp2Capo的实例】对话框右上角，点击【全局参数】，系统弹出【全局参数】对话框。

点击【SIP服务】标签，进入【SIP服务】属性页。确保【启用SIP服务】处于勾选状态，抄下【监听端口号】一栏里的数值。这个端口号数值需要连同SIP账号一并提供给相关用户。

点击【确定】，关闭【全局参数】对话框；

另外，如果服务器部署的时候采用了多实例部署，要注意在【配置dp2Capo的实例】对话框上查看当前配置SIP2所在的服务器的数据目录名称，并记下“capo_data\”后面的内容。这一段需要连同所创建的账号一起提供给用户，整体作为一个账号才能正常登录。

点击【确定】，关闭【配置dp2Capo的实例】对话框。

最后在【ChordInstaller--Chord安装工具】对话框上，点击【文件】-【退出】，退出ChordInstaller-安装工具。

2. 通过内务前端访问服务器创建SIP账户

在前端电脑上，用dp2内务访问创建SIP账户的服务器。点击菜单【功能】-【系统维护】-【用户窗】进入【用户窗】界面。在【用户窗】创建SIP账户。

创建时需要注意：

A. 内务中创建的SIP账号名称须要与通过【Chord Installer安装实用工具】创建的名称完全一致。

B. 为前端配置的权限，各项业务所需的权限请参考各类业务帐号权限配置文档中各业务权限配置。

具体创建过程请参考文档如何建立账号

3. 验证账户是否可以正常登录

打开工具【dp2SIP2 Client】,在【服务参数】表格里，【IP地址】一栏输入服务器IP地址，【端口】一栏输入端口号，【编码方式一栏】根据账户的编码方式进行下拉选择。

在【登录】表格里，输入所创建的账户名。注意，如果服务器部署的时候采用了多实例部署，账户名这里一定要加上当前实例的后缀，比如@instance1,这个后缀需要与服务器上的实列名后缀一致，然后输入密码（在内务中创建账号时所赋予的密码），先点击左侧的【连接】按钮，连接上服务器后，点击【登录】按钮，【dp2SIP2 Client】右侧固定面板显示出登录状况，941代表登录成功。

4. 提供SIP账户信息给相关用户

提供SIP账户信息给相关用户时，要一并提供服务器IP地址，账户名（多实例时，账户名一定要加上实例名后缀），初始密码，以及端口号。

如何排查SIP登录问题：

  1. 让用户提供报错截图

  2. 登录内务访问相关服务器，从【用户窗】查看相关用户名，核对用户输入的账号密码是否正确。

  3. 远程登录到服务器上打开capoinstaller,打开对应实例，看看SIP服务中各项设置是否正常（"打开当前实例SIP"是否勾选，账号是否创建，端口号），记下当前实例的实例名。

  4. 在本机用SIP小前端访问服务器,看看连接登录是否正常（小前端访问多实例服务器时，用户名后缀为@+实例名，不能输错）。

  5. 如果用户是密码不正确而导致的登录失败，可以重新修改密码后用小前端测试。