插件管理常见问题

1.1 版本

1.2 问题描述

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

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

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

问题描述：

管理员登录FineBI系统，点击「管理系统>插件管理」，插件管理界面有时会弹窗提示：「插件商店有新版本，是否更新？」，如下图所示：

原因分析&解决方法：

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

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

问题描述：

1）以管理员身份进入FineBI系统后，点击「管理系统>插件管理」，应用商城页面空白，如下图所示：

2）登录帆软通行证时，提示：未知错误。如下图所示：

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

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

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

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

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

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

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

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

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

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

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

3.1 报错：connection time out

问题描述：

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

原因分析：

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

解决方法：

根据需要开放的外网地址，开放网络即可。详情请参见：FineBI外网地址

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

问题描述：

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

原因分析：

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

解决方案：

开放 WebSocket 端口，详情请参见：Websocket 连接失败 。

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 服务器进行加载

问题描述：

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

原因分析：

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

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

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

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

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

解决方法：

购买插件授权并添加到工程中即可，详情请参见：插件注册。