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)以管理员身份进入数据决策系统后,点击「管理系统>插件管理」,应用商城页面空白,如下图所示:
2)登录帆软通行证时,提示「未知错误」。如下图所示:
3)设计器中点击右上角登录,提示「网络连接失败」。如下图所示:
排查步骤一:查看外网地址是否开放
原因分析:服务器没有连外网。
解决方法:根据需要开放的外网地址,开放网络即可。详情请参见:FineReport外网地址
排查步骤二:查看「连接网址管理中心」是否开启
原因分析:服务器可以通外网,在平台系统管理节点的「常规」 Tab 页中关闭了连接网址管理中心按钮,插件引擎模块无法使用。
解决方法:以管理员身份进入数据决策系统,点击「管理系统>系统管理>常规」,开启「连接网址管理中心按钮」,点击保存。如下图所示:
注1:远程环境中若关闭连接网址管理中心按钮,也将出现本节「问题描述」中的现象。
注2:连接网址管理中心按钮的介绍请参见:常规 中的 2.2 节内容。
排查步骤三:查看服务器系统时间与北京时间是否一致
原因分析:插件商城网址用的是北京时间,从插件管理登录的时候需要验证token。token是按照用户的系统时间生成的,登录时远程服务器会校验传过来的这个token是否正确,如果时间不对,就无法登录。
解决方法:服务器系统时间与北京时间保持一致
3. 插件在线安装失败
3.1 报错:connection time out
问题描述:
插件在线安装失败,报错 connection time out
原因分析:
当前工程无法成功连接在线插件商城。
解决方法:
根据需要开放的外网地址,开放网络即可。详情请参见:FineReport外网地址
3.2 插件在线安装/更新无进度
问题描述:
在数据决策系统安装/更新插件时卡住,不显示进度条,不显示「安装完成」。刷新页面后,发现插件已经安装/更新好了。
原因分析:
WebSocket端口被占用了,无法主动给浏览器推送消息。
解决方法:
开放 WebSocket 端口,详情请参见:Websocket 连接失败 。
4. 插件本地安装失败
4.1 插件本地安装/更新无进度
问题描述:
从本地选择插件安装包,安装插件后,无安装进度,不显示「插件安装成功」。
原因分析&解决方法:
1)插件安装包过大,安装较缓慢。请耐心等待即可。
2)工程环境无法连接安装包所在的位置。例如无法连接外网等。开放网络路径即可。
3)插件安装目录无权限,请确保用户有以下目录的读写执行的权限
%FR_HOME%\plugins
%FR_HOME%\webapps\webroot\WEB-INF\plugins
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天后需要购买授权方可使用。
解决方法:
购买插件授权并添加到报表工程中即可,详情请参见:插件注册