1. 概述
1.1 版本
| 報表服務器版本 | JAR 包版本 |
|---|---|
| 10.0 | 2018-12-27 |
1.2 應用場景
一般都使用本地機器信息認證，一個 license 文件只适用於一台服務器，若要換服務器就需要重新注冊。
對於一些大型的項目，同一個報表工程可能會發布到多台服務器上或者有些項目不能随便透露服務器的 MAC 地址。
目前不綁定機器的情況下可以通過私有雲認證的方式，但是私有雲仍需要一台物理信息不變的認證服務器。
此時，就可以使用加密鎖注冊，通過綁定報表應用名稱來實現授權。
1.3 功能簡介
帆軟商務針對工程的應用名稱生成對應的加密鎖（類似 U 盤），只有當服務器上報表應用名稱與加密鎖匹配，且服務器插着 USB 接口的加密鎖時，注冊才會生效。
注1：加密鎖認證不支持集群。
注2：加密鎖認證不支持 Mac。
注3：加密鎖要一直插在服務器上，一旦拔掉，注冊就會失效。
2. Windows 系統注冊方法
FineReport 商務生成對應的加密鎖後，會郵寄給用戶，用戶獲得 USB 接口的加密鎖後即可按照下文進行注冊驗證。
便可以使用了，注意服務器上的報表應用名必須與注冊時使用的應用名相同。
2.1 安裝驅動
在寄送的光盤中找到 drivers.zip 文件：drivers.rar
将文件上傳至報表工程服務器，解壓後，點擊 InstWiz3.exe 程序，安裝加密鎖驅動程序，如下圖所示：
2.2 插入加密鎖
在報表工程服務器 USB 接口插入加密鎖，查看設備管理器，正常如下圖所示：
注：加密鎖要一直插在服務器上，一旦拔掉，注冊就會失效。
2.3 放置 EL.dll 庫文件
在寄送的光盤中找到EL文件.zip文件：ET文件.rar
解壓後，将 JDK 對應版本的 EL.dll 文件上傳至報表工程服務器\%tomcat_home%\bin目錄下面，或C:\Windows\System32目錄下。
注：使用的 EL.dll 庫文件需要與服務器上的 JDK 一緻。
如果 JDK 爲 64 位，則需配 64 位的 EL.dll 文件。（在 EL 文件壓縮包的 Windows 64 目錄下面）
如果 JDK 爲 32 位，則需配 32 位的 EL.dll 文件（在 EL 文件壓縮包的 Windows 32 目錄下面）
查看 JDK 多少位：按快捷鍵 Win+R，在運行内輸入 cmd，回車，輸入 java -version，可以看到 JDK 的位數。
2.4 重啓 Web 服務器
重啓 Web 服務器。
2.5 開啓加密鎖認證
管理員登錄決策系統，點擊「管理系統>注冊管理>版本信息」，認證方式選擇「加密鎖認證」，點擊「檢測加密鎖」，如下圖所示：
注冊成功如下圖所示：
3. Linux 系統注冊方法
3.1 插入加密鎖
在報表工程服務器 USB 接口插入加密鎖，Linux 系統在硬件上能夠檢測到加密鎖，不需要安裝加密鎖驅動。
注：加密鎖要一直插在服務器上，一旦拔掉，注冊就會失效。
Linux 下，用 lsusb 命令，可以查看是否有多一個 USB 設備（拔插一下），如下圖所示：
3.2 放置 libEL.so 庫文件和 JAR 包
在寄送的光盤中找到 EL文件.zip 文件：ET文件.rar
解壓後，将 JDK 對應版本的 libEL.so 文件上傳至報表工程服務器\usr\lib或\usr\lib64目錄下面。
注：EL.dll 庫文件需要與 JDK 的一緻。
如果 JDK 爲 64 位，則需配64位的 libEL.so 文件（在 EL 文件壓縮包的 Linux 64 目錄下面）。
如果 JDK 爲 32位，則需配 32 位的 libEL.so 文件（在 EL 文件壓縮包的 Linux 32 目錄下面）。
3.3 重啓 Web 服務器
重啓 Web 應用服務器，以 Tomcat 爲例：
關閉服務器：./shutdown.sh
查找進程：ps -ef|grep tomcat
殺死進程：kill -9 進程号
重啓服務器：./startup.sh
注1：Linux 系統中必須以最高權限用戶 root 啓動，不然權限不夠，無法注冊成功。
注2：2019-12-05及之後版本的 JAR 包可正常使用 shutdown 完全清理所有進程。
3.4 開啓加密鎖認證
管理員登錄決策系統，點擊「管理系統>注冊管理>版本信息」，認證方式選擇「加密鎖認證」，點擊「檢測加密鎖」，如下圖所示：
注冊成功如下圖所示：
4. 注冊失敗
4.1 現象描述
若注冊失敗，頁面将出現提示彈窗，如下圖所示：
4.2 失敗原因
點擊詳細信息即可查看注冊失敗的原因，根據具體失敗原因進行排查。
| 失敗原因 | 具體提示 |
|---|---|
| 加密鎖序列号不匹配 | 認證加密鎖序列号：xxx 本地加密鎖序列号：xxx |
注：除上述外失敗原因外，其他統一報錯：證書内容不正确。
有多個失敗原因時，平台中會全部顯示出來。
5. 插件授權注冊
購買付費插件點擊 插件的授權注冊，只是把綁定類型修改爲加密狗，下方再填寫上加密狗序列号即可，如下圖所示：
加密狗序列号在注冊頁面查看，如下圖所示：
