服务器插件管理

1.1 版本

1.2 应用场景

用户工程部署在服务器上，若需要插件实现某一功能时，可在服务器中下载插件进行使用。

1.3 功能简介

插件管理提供可视化界面安装、删除、更新、禁用、启用插件。如下图所示：

注：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.mobile.widget.date-10.4.55 文件夹复制粘贴到%Tomcat_HOME%\webapps\webroot\WEB-INF\plugins 路径下。如下图所示：

2.3.3 重启报表工程

手动安装插件后，需要重启报表工程，插件方可生效。

2.3.4 效果展示

重启后，管理员登录数据决策系统，点击「管理系统>插件管理」，可看到插件已成功安装。如下图所示：

在「我的插件」处，选中某一插件，点击禁用/启用按钮，提示：插件已被禁用/插件已被启用。如下图所示：

在服务器「我的插件」处，选中要删除的插件，点击删除按钮，点击弹窗上的确定按钮。如下图所示：

在平台「我的插件」处，选中需更新的插件，点击「更新」按钮，点击弹窗上的「确定」按钮。如下图所示：

6.1 关闭插件自动更新功能

「宕机处理」、「云端运维」等插件，在工程启动时、启动一段时间后、每晚 23 点会自动检测插件版本并更新。

超级管理员可通过「fine_conf_entity可视化配置插件」关闭此类插件的自动更新。重启服务器后设置生效。

注：修改 FineDB 数据库表字段值的方法请参考 FineDB 常用表字段修改 。

6.2 插件完整性校验

功能说明：

本地安装/手动安装插件时，为了防止恶意篡改插件包中的代码，提供插件完整性校验功能。该功能默认开启。

下载安装/本地安装插件时，若该插件未通过完整性校验，则提示「XXX插件安装包签名损坏，存在安全风险，无法安装」。如下图所示：

解决方案：

如需关闭插件包完整性校验，管理员可通过修改finedb中的PluginFileValidateConfig.fileValidateOpen字段值为false。

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

详情请参见：第三方插件安装失败说明