反馈已提交

网络繁忙

插件管理常见问题

  • 文档创建者:Carly
  • 历史版本:12
  • 最近更新:Carly 于 2022-12-26
  • 1. 概述

    1.1 版本

    报表服务器版本
    11.0

    1.2 问题描述

    插件安装和管理过程中,可能会出现一些问题。

    本文将提供常见插件安装/维护问题的解决方案。

    2. 插件管理界面异常

    2.1 插件商店有新版本,是否更新

    问题描述:

    管理员登录数据决策系统,点击「管理系统>插件管理」,插件管理界面有时会弹窗提示:「插件商店有新版本,是否更新?」,如下图所示:

    原因分析&解决方法

    此时更新的是帆软商城中插件,不会更新工程中已安装的插件,点击「确定」按钮即可。

    2.2 插件管理界面空白

    问题描述:

    管理员登录数据决策系统,点击「管理系统>插件管理」,提示:「您还没有插件商店的资源,是否下载?」

    点击「确定」按钮后,「插件管理」界面依然空白。如下图所示:

    原因分析&解决方法:

    1)设计器和服务器 JAR 包不一致,保持一致之后即可恢复正常。

    2)用户在本地或远程工作目录中,勾选了「使用新插件管理器」按钮。

    注:「使用新插件管理器」按钮具体介绍可参考 选项 中的 3.4 节内容。

    • 外网用户:外网用户在插件管理页面的弹窗上,点击确定按钮后,清理浏览器缓存,重新进入数据决策系统即可。

    • 内网用户:请联系技术支持获取 upm 文件夹,将 upm 文件夹放到%HOME%\webapps\webroot\WEB-INF\assets文件夹下。

          注:付费用户请联系技术支持。技术支持联系方式:

    • 在线支持:前往「服务」,选择「在线支持」

    • 电话:400-811-8890

    2.3 应用商城界面空白/帆软通行证无法登录

    问题描述:

    1)以管理员身份进入数据决策系统后,点击「管理系统>插件管理」,应用商城页面空白,如下图所示:

    24.png

    2)登录帆软通行证时,提示「未知错误」。如下图所示:

    2.png

    3)设计器中点击右上角登录,提示「网络连接失败」。如下图所示:

    5.png

    排查步骤一:查看外网地址是否开放

    原因分析:服务器没有连外网。

    解决方法:根据需要开放的外网地址,开放网络即可。详情请参见:FineReport外网地址

    排查步骤二:查看「连接网址管理中心」是否开启

    原因分析:服务器可以通外网,在平台系统管理节点的「常规」 Tab 页中关闭了连接网址管理中心按钮,插件引擎模块无法使用。

    解决方法:以管理员身份进入数据决策系统,点击「管理系统>系统管理>常规」,开启「连接网址管理中心按钮」,点击保存。如下图所示:

    注1:远程环境中若关闭连接网址管理中心按钮,也将出现本节「问题描述」中的现象。

    注2:连接网址管理中心按钮的介绍请参见:常规 中的 2.2 节内容。

    6.png

    排查步骤三:查看服务器系统时间与北京时间是否一致

    原因分析:插件商城网址用的是北京时间,从插件管理登录的时候需要验证token。token是按照用户的系统时间生成的,登录时远程服务器会校验传过来的这个token是否正确,如果时间不对,就无法登录。

    解决方法:服务器系统时间与北京时间保持一致

    3. 插件在线安装失败

    3.1 报错:connection time out

    问题描述:

    插件在线安装失败,报错 connection time out

    原因分析:

    当前工程无法成功连接在线插件商城。

    解决方法:

    根据需要开放的外网地址,开放网络即可。详情请参见:FineReport外网地址

    3.2 插件在线安装/更新无进度

    问题描述:

    在数据决策系统安装/更新插件时卡住,不显示进度条,不显示「安装完成」。刷新页面后,发现插件已经安装/更新好了。

    image.png

    原因分析:

    WebSocket端口被占用了,无法主动给浏览器推送消息。

    解决方法:

    开放 WebSocket 端口,详情请参见:Websocket 连接失败

    4. 插件本地安装失败

    4.1 插件本地安装/更新无进度

    问题描述:

    从本地选择插件安装包,安装插件后,无安装进度,不显示「插件安装成功」。

    原因分析&解决方法:

    1)插件安装包过大,安装较缓慢。请耐心等待即可。

    2)工程环境无法连接安装包所在的位置。例如无法连接外网等。开放网络路径即可。

    3)插件安装目录无权限,请给插件安装的 cache 目录开下 777 权限。

    4.2 文件上传失败/未找到安装包 Request Entity Too Large

    问题描述:

    从本地安装插件,提示「文件上传失败」/「未找到安装包」,F12查看日志发现报错「413 Request Entity Too Large」。

    原因分析:

    上传的插件安装包过大,一般Linux默认上传文件的上限大小为1M。

    解决方法:

    1)不使用本地安装方法,改用「手动安装」方法,详情请参见:服务器插件管理

    2)修改Linux的配置文件

    • 找到 nginx.conf 文件,更改body size

    • 更改后 nginx -s reload 重新加载一下,如果命令加载不成功,则需要重启 Linux 服务器进行加载

    5. 插件安装后使用失败

    问题描述:

    数据决策系统(服务器端)安装插件后,设计器端远程连接该工程,无法使用插件功能。

    排查步骤一:检查本地设计器和远程服务器是否都安装了插件

    对于设计器和服务器都会用到的插件,要求服务器端和设计器端都要安装:

    • 若服务器端安装了插件,设计器端没有安装插件,则插件不会生效,需要切换到本地进行插件安装。

    • 若服务器端和设计器端均安装了插件,服务器端的插件下载、删除、禁用不会立即生效,需要等几分钟才会生效。

    • 若服务器端和设计器端均安装了插件,设计器切换到本地,禁用该插件,不影响远程连接时服务器端的插件使用。

    注:设计器插件有两个路径,两个路径都需要有插件包,否则安装无效:

    • %FR_HOME%\plugins

    • %FR_HOME%\webapps\webroot\WEB-INF\plugins

    若%FR_HOME%\plugins目录下没有插件/插件不生效,一般会报错「Plugin not installed at designer」,请卸载重装。

    排查步骤二:检查本地设计器和远程服务器插件版本是否一致

    原因分析:若设计器端和服务器端均安装了插件,但是插件版本不一致,可能导致插件功能失效。

    解决方法:将本地设计器和远程服务器插件版本升级到一致。

    排查步骤三:检查插件版本是否最新

    如果插件版本不是最新版,可将本地设计器和远程服务器插件版本升级到最新,再进行测试。

    注:大部分移动端插件和HTML5移动端展现插件的版本之间有依赖关系。

           请参照具体的插件帮助文档,确保所使用的移动端功能插件和HTML5移动端展现插件之间的版本互相支持。

    排查步骤四:检查本地设计器和远程服务器JAR包版本是否一致

    原因分析:如果本地设计器和远程服务器JAR包版本不一致,会带来很多问题,也有可能会导致插件失效。

    解决方法:将本地设计器和远程服务器JAR包版本升级到一致,升级方式请参见:小版本升级指南

    排查步骤五:检查远程服务器工程中是否存在冗余JAR包

    原因分析:一般来说,远程服务器工程%FR_Home%/webapps/webroot/WEB-INF/lib目录下不应该存在fine-report-designer-11.0.jar文件。若远程工程没有删除这个JAR包,会导致工程报错以及插件不生效。

    解决方法:请备份JAR包后,将远程服务器工程%FR_Home%/webapps/webroot/WEB-INF/lib目录下的fine-report-designer-11.0.jar文件删除,重启报表工程后再次尝试。

    排查步骤六:检查是否存在历史版本插件包

    原因分析:若工程下同时存在多个版本的插件包,可能会导致插件不生效。

    解决方法:

    1)检查设计器下两个路径内的插件包,删除冗余插件包。

    • %FR_HOME%\plugins

    • %FR_HOME%\webapps\webroot\WEB-INF\plugins

    2)检查服务器工程下的插件包,删除冗余插件包。

    • %Tomcat_HOME%\webapps\webroot\WEB-INF\plugins

    排查步骤七:检查文件夹权限

    服务器工程的启动用户,需要对WEB-INF文件及其子文件有读写执行的权限。

    6. 插件过期

    问题描述:

    提示XXX插件过期,请前往帆软应用中心进行购买。

    原因分析:

    用户所使用的报表工程是已注册的,对未购买授权的付费插件,用户可免费试用90天,90天后需要购买授权方可使用。

    • FineReport工程未注册时,插件可免费使用,无需进行授权。

    • FineReport工程注册后,免费插件可正常使用,无需进行授权。

    • FineReport工程注册后,购买了授权的付费插件,用户可正常使用。

    • FineReport工程注册后,未购买授权的付费插件,用户可免费试用90天,90天后需要购买授权方可使用。

    解决方法:

    购买插件授权并添加到报表工程中即可,详情请参见:插件注册

    附件列表


    主题: 数据决策系统
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持