1. 概述
1.1 版本
| FineBI服务器版本 |
|---|
| 6.0 |
1.2 问题描述
插件安装和管理过程中，可能会出现一些问题。
本文将提供常见插件安装/维护问题的解决方案。
2. 插件管理界面异常
2.1 插件商店有新版本，是否更新
问题描述：
管理员登录FineBI系统，点击「管理系统>插件管理」，插件管理界面有时会弹窗提示：「插件商店有新版本，是否更新？」，如下图所示：
原因分析&解决方法：
此时更新的是帆软商城中插件，不会更新工程中已安装的插件，点击「确定」按钮即可。
2.2 应用商城界面空白/帆软通行证无法登录
问题描述：
1）以管理员身份进入FineBI系统后，点击「管理系统>插件管理」，应用商城页面空白，如下图所示：
2）登录帆软通行证时，提示：未知错误。如下图所示：
排查步骤一：查看外网地址是否开放
原因分析：服务器没有连外网。
解决方法：根据需要开放的外网地址，开放网络即可。详情请参见：FineBI外网地址
排查步骤二：查看「连接网址管理中心」是否开启
原因分析：服务器可以通外网，在平台系统管理节点的「常规」 Tab 页中关闭了连接网址管理中心按钮，插件引擎模块无法使用。
解决方法：以管理员身份进入数据决策系统，点击「管理系统>系统管理>常规」，开启「连接网址管理中心按钮」，点击保存。如下图所示：
注1：远程环境中若关闭连接网址管理中心按钮，也将出现本节「问题描述」中的现象。
注2：连接网址管理中心按钮的介绍请参见：常规 中的 2.2 节内容。
排查步骤三：查看服务器系统时间与北京时间是否一致
原因分析：插件商城网址用的是北京时间，从插件管理登录的时候需要验证token。token是按照用户的系统时间生成的，登录时远程服务器会校验传过来的这个token是否正确，如果时间不对，就无法登录。
解决方法：服务器系统时间与北京时间保持一致
3. 插件在线安装失败
3.1 报错：connection time out
问题描述：
插件在线安装失败，报错 connection time out
原因分析：
当前工程无法成功连接在线插件商城。
解决方法：
根据需要开放的外网地址，开放网络即可。详情请参见：FineBI外网地址
3.2 插件在线安装/更新无进度
问题描述：
在数据决策系统安装/更新插件时卡住，不显示进度条，不显示「安装完成」。刷新页面后，发现插件已经安装/更新好了。
原因分析：
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. 插件过期
问题描述：
提示XXX插件过期，请前往帆软应用中心进行购买。
原因分析：
用户所使用的工程是已注册的，对未购买授权的付费插件，用户可免费试用90天，90天后需要购买授权方可使用。
FineBI工程未注册时，插件可免费使用，无需进行授权。
FineBI工程注册后，免费插件可正常使用，无需进行授权。
FineBI工程注册后，购买了授权的付费插件，用户可正常使用。
FineBI工程注册后，未购买授权的付费插件，用户可免费试用90天，90天后需要购买授权方可使用。
解决方法：
购买插件授权并添加到工程中即可，详情请参见：插件注册。
