伺服器插件管理

1.1 版本

1.2 應用場景

使用者工程部署在伺服器上，若需要插件實現某一功能時，可在伺服器中下載插件進行使用。

1.3 功能簡介

11.0.18 及之後版本，插件管理介面全面優化，並支援批量管理插件。本文將對插件管理的使用進行介紹。

管理者登入數據決策系統，點選「管理系統>插件管理」，如下圖所示：

• 應用商城：提供插件商城安裝、本地安裝插件功能。

• 我的插件：提供已安裝插件的資訊以及多種插件管理操作，包括：刪除、更新、禁用/啟用、批量禁用/啟用和全部更新操作。

注：IE8 及以下版本瀏覽器不支援。

插件管理支援以下特性：

• 支援熱部署，安裝、刪除、更新、禁用、啟用不需要重啟

• 配置 license 不需要重啟

• 自動安裝和更新插件的依賴（包括插件之間的依賴關係）

• 自動刪除不再使用的檔案和服務依賴

• 遠端環境下自動檢查插件是否匹配，並實時同步插件的運作狀態

注1：當設計器遠端連結伺服器時，伺服器如需使用某插件功能，則伺服器端和設計器端均需安裝該插件，方可正常使用。

注2：FineReport 設計器中下載插件請參見： 設計器插件管理

注3：FineReport 設計器切換工作區間到遠端環境，遠端環境下「伺服器」Tab 頁中沒有「插件管理」選項。

伺服器上安裝插件有三種方法：下載安裝、本地安裝、手動安裝。

2.1 下載安裝

1）管理者登入數據決策系統，點選「管理系統>插件管理>應用商城」，在搜尋框中輸入插件名稱進行搜尋，選中需要安裝的插件，點選「安裝」，如下圖所示：

2）插件安裝成功後，彈出安裝成功彈窗。如下圖所示：

2.2 本地安裝

1）在 帆軟市場 內下載需要安裝的插件，得到的壓縮包如下圖所示：

注：在帆軟市場中需使用帆軟通行證登入後，才能下載插件。

2）管理者登入數據決策系統，點選「管理系統>插件管理>應用商城」，點選「從本地安裝」按鈕，選擇已下載（準備）的插件的.zip壓縮包。

插件安装成功后，弹出安装成功弹窗，点击「确定」，如下图所示：

注：請勿解壓上文得到的壓縮包，直接安裝即可。

2.3 手動安裝

注：當使用者環境不允許上傳檔案或 War 包部署時，可手動安裝插件。

2.3.1 確定插件資料夾

1）FineReport 設計器所安裝的插件儲存在%FR_HOME%\webapps\webroot\WEB-INF\plugins 路徑中，如下圖所示：

注：路徑下的資料夾必須是在設計器中安裝插件生成的，不是官網下載的插件壓縮包解壓後得到的資料夾。

2）開啟某個插件資料夾下的plugin.xml檔案，可確定具體插件。如下圖所示：

2.3.2 複製貼上插件檔案

將設計器路徑%FR_HOME%\webapps\webroot\WEB-INF\plugins下的某個插件資料夾plugin-com.fr.plugin.decision.background.sso.v11-1.2.2複製貼上到伺服器%Tomcat_HOME%\webapps\webroot\WEB-INF\plugins 路徑下。如下圖所示：

2.3.3 重啟報表工程

手動安裝插件後，需要重啟報表工程，插件方可生效。

2.3.4 效果展示

重啟後，管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，搜尋插件名稱，可以看到伺服器中已成功安裝插件。如下圖所示：

管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，「我的插件」頁面中以列表形式展示已安裝插件的資訊，並支援對插件進行管理操作。

• 插件資訊包括：插件名稱、版本、待更新（僅在插件可更新時出現）、費用類別、狀態。

• 插件操作包括：搜尋、更新、禁用/啟用、刪除、全部更新、批量禁用/啟用。如下圖所示：

3.1 更新插件

3.1.1 單獨更新

管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，當插件可更新時，插件版本右側會新增「待更新」標識。

點選「更新」按鈕，更新完成後出現彈窗提示：XXX插件更新成功，點選「確定」即可。如下圖所示：

3.1.2 全部更新

管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，點選「全部更新」按鈕，將對已安裝的所有插件進行更新。

更新過程中提供進度條，便於獲知更新進度，全部插件更新完成後，出現彈窗提示：插件更新成功，點選「確定」即可，如下圖所示：

若部分插件更新失敗，將彈窗提示：XXX項插件處理失敗，XXX項插件處理成功，並提供更新失敗原因，如下圖所示：

3.2 禁用/啟用插件

3.2.1 單獨禁用/啟用

管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，點選「禁用/啟用」按鈕，出現彈窗提示：XXX插件已被禁用/啟用，點選「確定」即可，如下圖所示：

3.2.2 批量禁用/啟用

管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，勾選需要禁用/啟用的插件，點選「禁用/啟用」按鈕，如下圖所示：

出現彈窗提示：所選插件禁用/啟用成功，點選「確定」即可，如下圖所示：

3.3 刪除插件

管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，點選「刪除」按鈕，點選彈窗上的「確定」按鈕即可，如下圖所示：

4.1 關閉插件自動更新功能

「當機處理」、「雲端健檢分析」等插件，在工程啟動時、啟動一段時間後、每晚 23 點會自動檢查插件版本並更新。

超級管理者可透過「fine_conf_entity視覺化配置插件」關閉此類插件的自動更新。重啟伺服器後設定生效。

注：修改 FineDB 資料庫表欄位值的方法請參考 FineDB 常用表欄位修改 。

4.2 插件完整性校驗

功能說明：

本地安裝/手動安裝插件時，為了防止惡意篡改插件包中的代碼，提供插件完整性校驗功能。該功能預設開啟。

下載安裝/本地安裝插件時，若該插件未透過完整性校驗，則提示「XXX插件安裝包簽章損壞，存在安全風險，無法安裝」。如下圖所示：

解決方案：

如需關閉插件包完整性校驗，管理者可透過修改finedb中的PluginFileValidateConfig.fileValidateOpen欄位值為false。

如需开启插件包完整性校验，但仍必须要安装某个签名无法通过校验的插件（例如二开插件），则可通过手动安装的方式安装插件。

詳情請參見：第三方插件安裝失敗說明