dp2ssl 绿色版的安装 - DigitalPlatform/dp2 GitHub Wiki

绿色版dp2SSL具有如下特点:

1.可以由普通 Windows 用户和 Administrator 用户(Windows Service 的 LocalSystem 身份)来启动。而 ClickOnce 难以被后者启动;

2.可以由 dp2ssl 具有的远程管理界面进行重启。包括自动升级后重启新版本。

3.安装时加入当前 Windows 用户的 startup 组,当 Windows 操作系统重启后进入桌面时 dp2ssl 可以自动启动;

4.适应某些不适合 ClickOnce 安装的场合。

由于绿色版具有clickonce安装版本不可比拟的优点,目前确定用户书柜和自助借还机上使用的的dp2SSL都要用绿色版

绿色版dp2SSL的安装步骤

绿色版dp2SSL的安装条件:电脑上预先装好 .NET Core 3.1 的 Runtime 模块和Microsoft.NET Framework 4.7.2。

.NET Core 3.1 的 Runtime 下载地址:https://dotnet.microsoft.com/download/dotnet-core/3.1 。选择页面右侧的“Desktop Runtime 3.1.5”下载。它包含了 .NET Core Runtime,不需再下载后者)

Microsoft.NET Framework 4.7.2下载地址:https://github.com/DigitalPlatform/dp2/issues/121

安装时先装对应的英文版,再装中文版。

绿色版dp2SSL地址:http://dp2003.com/dp2ssl/v1/greensetup.exe。先用浏览器下载文件到本地。启动 greensetup.exe,程序会自动安装好绿色版。安装过程将把可执行程序复制到 c:\dp2ssl 子目录。

如果当前电脑以前曾经安装过 dp2ssl 的 ClickOnce 版本,则安装绿色 dp2ssl 过程中,会自动把原先版本在 Windows 当前用户目录下的 dp2ssl 子目录(称为用户文件夹)复制到 c:\programdata\dp2\dp2ssl 下,并且会在原先用户文件夹中创建一个 userDirectoryMask.txt 的文件,这个文件的作用是当 dp2ssl ClickOnce 版本启动的时候探测到它的存在,会警告并退出。

当 dp2ssl 绿色版装好以后,原先的 ClickOnce 版本就不允许再继续使用了。建议用户卸载掉 ClickOnce 版本的 dp2ssl。卸载 ClickOnce 版本的时候,不会删除原先的用户文件夹。

注意后面为 dp2ssl 进行数据备份的时候,数据已经存储在 c:\programdata\dp2\dp2ssl 这个新位置了。

绿色版自动升级原理

绿色版的 c:\dp2ssl 目录中有两个可执行文件,greensetup.exe 和 dp2ssl.exe。

两个 .exe 的作用:

安装为桌面创建的“dp2SSL 自助借还(绿色)”快捷方式,和当前 Windows 用户 startup 命令组里面的快捷方式,都是指向 greensetup.exe 的。

当 dp2ssl 第一次进行绿色安装的时候,greensetup.exe 是会自动下载 app.zip 和 data.zip 文件并进行安装,这和安装后的日常启动过程有所不同。

后续运行过程中 greensetup.exe 并不负责直接下载 .zip 文件,而是由dp2ssl.exe每隔两小时探测并下载新版本。新版本下载后书架界面上会出现黄色底色的文字,提醒重启以后可以使用新版本。

如果 greensetup.exe 本身更新了,dp2ssl.exe 也能探测到并自动下载到 c:\dp2ssl 目录。

greensetup.exe 每次启动后,会进行如下检查:

  1. 如果 install_state.txt 文件中的状态信息表明此前成功下载了 app.zip 和 data.zip 但尚未来得及展开,则展开它们(升级,覆盖原来的相关文件),然后启动 dp2ssl.exe。

(注:dp2ssl.exe 本身在启动状态时无法展开两个 .zip 文件到 c:\dp2ssl 目录,所以当 dp2ssl 自身进行了 .zip 文件的下载以后,只能借助别的程序来展开 .zip 文件)

  1. 如果 install_state.txt 文件中的状态信息未表明需要升级,会直接启动 dp2ssl.exe

升级原理和处理方式

一般来说,启动绿色版dp2SSL后如果有新版本,会在主菜单的版本号位置显示为橙色,用户重启就可以使用新版本。

如果绿色版dp2SSL升级出现问题,可以关闭软件后,手动将c\dp2ssl\dp2ssl.exe删除,再启动时系统会下载新版本。

如果自助机原来安装的是clickonce版的dp2SSL,更换成绿色版的时候没有删除原来的数据目录,绿色版无法自动下载新版本时,可以先将c\dp2ssl整个目录删除,再重新下载安装最新的绿色版dp2ssl。

绿色版界面顶上的图书馆名称是否显示,与所配置的账号权限有关。所配置的账号具备getsystemparameter权限时,会显示配置到服务器上的图书馆名称。

界面下方的字样也可以去掉。

如果想要卸载现有的绿色版dp2SSL,只要删除c盘下整个dp2ssl文件,并删除桌面上的快捷方式就好了,不用删除programdata下的dp2ssl文件(这里是数据文件)。重新下载后原有的数据文件仍然可用。

重新安装绿色版dp2SSL后,如果是书柜相关的照明灯设置以及LED设置不需要重新配置,原来的配置仍然生效。