1. 概述
1.1 版本
FineDataLink 版本 | 功能變動 |
|---|---|
| 4.0 | - |
| 4.0.27 | 插件管理全面優化： 1）支援批量管理插件，包括：批量禁用/啟動、全部更新 2）插件管理介面拆分為「應用商城」和「我的插件」介面，並採用全新介面風格
|
1.2 應用場景
若需要插件實現某一功能時，可在「插件管理」中下載插件進行使用。
1.3 功能簡介
4.0.27 及之後版本，插件管理介面全面優化，並支援批量管理插件。本文將對插件管理的使用進行介紹。
管理者登入數據決策系統，點選「管理系統>插件管理」，如下圖所示：
應用商城：提供插件商城安裝、本地安裝插件功能。
我的插件：提供已安裝插件的資訊以及多種插件管理操作，包括：刪除、更新、禁用/啟動、批量禁用/啟動和全部更新操作。
注1：IE8 及以下版本瀏覽器不支援。
注2：登入的帳號並非 FineDataLink 資料平台帳號，而是帆軟社群通行證帳號。
插件管理支援以下特性：
支援熱部署，安裝、刪除、更新、禁用、啟動不需要重啟。
配置 license 不需要重啟。
自動安裝和更新插件的依賴（包括插件之間的依賴關係）。
自動刪除不再使用的檔案和服務依賴。
2. 安裝插件
伺服器上安裝插件有三種方法：下載安裝、本地安裝、手動安裝。
2.1 下載安裝
1）管理者登入 FineDataLink 資料平台，點選「管理系統>插件管理」，搜尋框輸入插件名稱進行搜尋，選中需要安裝的插件，點選安裝，如下圖所示：
2）插件安裝成功後，彈出安裝成功彈窗。如下圖所示：
2.2 本地安裝
1）在 帆軟市場 內下載需要安裝的插件，得到的壓縮包如下圖所示：
注：在帆軟市場中需使用帆軟通行證登入後，才能下載插件。
2）管理者登入 FineDataLink 資料平台，點選「管理系統>插件管理>從本地安裝」，選擇.zip壓縮包，如下圖所示：
注：請勿解壓上文得到的壓縮包，直接安裝即可。
2.3 手動安裝
注：當使用者環境不允許上傳檔案時，可手動安裝插件。
2.3.1 確定插件資料夾
1） FineDataLink 所安裝的插件儲存在%HOME%\webapps\webroot\WEB-INF\plugins 路徑中，如下圖所示：
注：路徑下的資料夾必須是在 FineDataLink 中安裝插件生成的，不是官網下載的插件壓縮包解壓後得到的資料夾。
2）開啟某個插件資料夾下的plugin.xml檔案，可確定具體插件。如下圖所示：
2.3.2 複製貼上插件檔案
將%HOME%\webapps\webroot\WEB-INF\plugins下的plugin-com.fr.plugin.decision.superusers.v11-1.5資料夾複製貼上到%Tomcat_HOME%\webapps\webroot\WEB-INF\plugins 路徑下。如下圖所示：
2.3.3 重啟工程
手動安裝插件後，需要重啟 FineDataLink 工程，插件方可生效。
3. 管理插件
管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，「我的插件」頁面中以列表形式展示已安裝插件的資訊，並支援對插件進行管理操作。
插件資訊包括：插件名稱、版本、待更新（僅在插件可更新時出現）、費用類別、狀態。
插件操作包括：搜尋、更新、禁用/啟動、刪除、全部更新、批量禁用/啟動。如下圖所示：
3.1 更新插件
3.1.1 單獨更新
管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，當插件可更新時，插件版本右側會新增「待更新」標識。
點選「更新」按鈕，更新完成後出現彈窗提示：XXX插件更新成功，點選「確定」即可。如下圖所示：
3.1.2 全部更新
管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，點選「全部更新」按鈕，將對已安裝的所有插件進行更新。
更新程式中提供進度條，便於獲知更新進度，全部插件更新完成後，出現彈窗提示：插件更新成功，點選「確定」即可，如下圖所示：
若部分插件更新失敗，將彈窗提示：XXX項插件處理失敗，XXX項插件處理成功，並提供更新失敗原因，如下圖所示：
3.2 禁用/啟動插件
3.2.1 單獨禁用/啟動
管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，點選「禁用/啟動」按鈕，出現彈窗提示：XXX插件已被禁用/啟動，點選「確定」即可，如下圖所示：
3.2.2 批量禁用/啟動
管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，勾選需要禁用/啟動的插件，點選「禁用/啟動」按鈕，如下圖所示：
出現彈窗提示：所選插件禁用/啟動成功，點選「確定」即可，如下圖所示：
3.3 刪除插件
管理者登入數據決策系統，點選「管理系統>插件管理>我的插件」，點選「刪除」按鈕，點選彈窗上的「確定」按鈕即可，如下圖所示：
4. 注意事項
4.1 關閉插件自動更新功能
「當機處理」、「雲端健檢分析」等插件，在工程啟動時、啟動一段時間後、每晚 23 點會自動檢查插件版本並更新。
超級管理者可透過「fine_conf_entity視覺化配置插件」關閉此類插件的自動更新。重啟伺服器後設定生效。
注：修改 FineDB 資料庫表欄位值的方法請參考 FineDB 常用表欄位修改
| 參數名 | 參數描述 | 參數值 |
|---|---|---|
| UpdateConfig.launchSwitchMap.plugins | 插件自動更新的啟動更新是否開啟 | 如需關閉工程啟動後的插件自動更新，請將參數值修改為false，否則無需改動 |
| CronUpdateConfig.typeMap.plugins | 插件自動更新的定時更新是否開啟 | 如需關閉工程啟動後每晚11點的外網更新插件，請將參數值修改為false，否則無需改動 |
| DelayUpdateConfig.delaySwitchMap.plugins | 插件自動更新的延遲更新是否開啟 | 如需關閉工程啟動後延遲一段時間的插件自動更新，請將參數值修改為false，否則無需改動 |
4.2 插件完整性校驗
功能說明：
本地安裝/手動安裝插件時，為了防止惡意篡改插件包中的程式碼，FineDataLink 提供插件完整性校驗功能。該功能預設開啟。
下載安裝/本地安裝插件時，若該插件未透過完整性校驗，則提示「XXX插件安裝包簽章損壞，存在安全風險，無法安裝」。如下圖所示：
解决方案：
如需關閉插件包完整性校驗，管理者可透過修改finedb中的PluginFileValidateConfig.fileValidateOpen欄位值為false。
如需開啟插件包完整性校驗，但仍必須要安裝某個簽章無法透過校驗的插件（例如二開插件），則可透過手動安裝的方式安裝插件。
詳情請參見：第三方插件安裝失敗說明