dp2ssl 绿色版的安装

绿色版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 文件)

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

升级原理和处理方式

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

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

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

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

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

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

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