一、FineBI端口开放列表
1. 概述
在安装完成 FineBI 后，服务器需要开放一些端口供系统监听使用。对于服务器安全要求高的客户来说，在启动之前需要保证这些端口的开放，否则 FineBI 无法正常启动。
2. Spider 单机部署开放端口
注：若使用了 Nginx 服务器，则可能需要单独修改 Requestport，详情参见： Nginx 常见报错及解决方案。
二、FineBI安装目录结构
1. 概述
在 FineBI 安装完成以后，进入安装目录可以看到安装文件。FineBI 安装文件本质上就是一个 Tomcat 。本文详细介绍安装目录结构。
2. 安装根目录
每个文件存放的内容如下表所示：
|
文件 |
内容 |
|
.install4j |
FineBI 的图片 |
|
bin |
|
|
jre |
是在 Java 运行环境下支持 Java 应用程序 |
|
lib |
存放 BI 启动的时候的加载动画的 JAR 包 |
|
logs |
包含工程运行日志、GC日志 注：清空一般不会对运行带来影响。 |
|
server |
Tomcat 的根目录，包含 Tomcat 的配置文件夹以及 Tomcat 自带的依赖文件夹 |
|
temp |
注：temp 临时目录在工程运行时不建议做清理，需要在工程停机时清理，如果清理后提示报错需要工程重启 |
|
webapps |
存放应用程序，当服务启动时会去加载 webapps 目录下的应用程序 |
|
FineBI5.1 帮助文档 .chm |
FineBI5.1 版本的离线帮助文档 |
|
LICENSE |
许可证，里面记录了 Tomcat 的一些条款等等 |
|
NOTICE |
记录 Tomcat 的新的通知，公告 |
|
RELEASE-NOTES |
记录的是发行版本的说明，一些*绑捆**的 API ，新特性等等 |
|
RUNNING.txt |
记录 Tomcat 的运行环境以及怎样配置参数，变量，启动等等 |
|
uninstall*ex.e** |
自带卸载 exe ，双击即可调用卸载功能 |
3. webroot 目录
每个文件存放的内容如下表所示：
|
文件 |
内容 |
|
backup |
存放工程备份文件，包含平台配置备份、jar备份、插件备份等 |
|
Demo_files |
存放工程自带的 DEMO 展示需要的文件 |
|
logs |
存放日志文件，记录系统登录信息、模板访问信息、报错信息等 |
|
scripts |
存放插件相关文件 |
|
WEB-INF |
BI 工程主目录 |
|
FRDemo.db |
内置 Sqlite 数据库文件 |
|
test.mv.db、test.trace.db |
内置 H2 数据库文件 |
|
Web组件.html |
这是一个 Web 组件，写入的超链接地址即可。比如这是一个自定义的 HTML 文件，内置在工程内部 %/webroot/ 这个目录之下 |
4. WEB-INF 目录
每个文件存放的内容如下表所示：
|
文件 |
内容 |
|
assets |
资源文件夹，存放工程用到的资源文件等 其中 temp_attach 中存放着上传的图片和 Excel 数据。 |
|
assist |
辅助文件夹，存放一些辅助文件 |
|
classes |
class 文件存放目录 |
|
dashboards |
BI 模板保存文件夹 |
|
embed |
内置数据库配置目录 |
|
lib |
BI 工程依赖的 JAR 包文件夹 |
|
reportlets |
存放 FineReport 报表 cpt 、frm文件 |
|
resources |
存放工程相关的资源配置文件 |
|
treasures |
包含报表的功能点及 BI 的埋点信息，正常情况下一个月会自动生成一次 |
5. resources 目录
每个文件存放的内容如下表所示：
|
文件 |
内容 |
|
direct |
存放实时数据相关配置信息 |
|
cpu.xml |
CPU 开关，处理 sigard 导致 JVM 虚拟机崩溃问题时使用 |
|
FanRuan.lic |
工程证书文件 |
|
rlink.rlink |
Rserver 连接配置 |
6. schedule 目录
- 测试定时任务邮件通知：存放 定时调度 生成的文件。
7. dashboard 目录
- 目录下存放的是不同用户 ID 命名的文件夹。
点开某用户 ID 的文件夹，如下图所示：
- FBI 文件：存放的是对应用户创建的具体仪表板，用仪表板 ID 命名文件。
8. 注意事项
8.1 error.log 文件介绍
部分用户工程的 %FineBI_HOME%\bin 目录中存在 error.log 文件，该文件不会根据日期进行拆分，记录所有日期 error 级别的日志和一些相关的 info 信息。
若用户觉得该文件占用磁盘空间过大，可手动删除、写脚本定时删除或者写脚本监控大小删除。
注1：建议确认 fanruan.log 日志已够用，再考虑是否删除 error.log 文件。
注2：若工程部署在 Tomcat 的容器中，bin 目录下不会有 error.log 文件。
三、生成安全密钥文件按钮说明
1. 概述
1.1 版本
|
FineBI 版本 |
JAR 包 |
新增功能 |
|
5.1 |
2020-08-04 |
FineBI 安装时，可勾选「生成安全密钥文件」按钮 |
1.2 功能简介
报表所有的可变配置信息，都存储在配置数据库中，试用产品使用的是内置的 HSQL 数据库，位置为： %BI_HOME%\webapps\webroot\WEB-INF\embed\finedb ，正式环境可迁移到外置的数据库中，在 /WEB-INF/config 下生成一个 db.properties 文件，记录了配置数据库的地址、用户名、密码等信息。
主要作用于两方面：
- 迁移后 db.properties 文件里面数据库的密码加解密
- 数据连接密码、邮箱密码、帆软通行证密码等加解密（不包括平台用户密码）
为了增强密钥的安全性，现对根密钥的逻辑进行优化。
2. 按钮介绍
FineBI 安装 时勾选「生成安全密钥文件」按钮，选择后会随机生成 3 个种子文件，工程启动时读取种子文件，内存中根据种子生成恒定公私钥，此时加解密使用生成的种子文件。
若用户对安全性要求较高，可勾选该按钮。如下图所示：
注1：Windows 环境下，FineReport 设计器安装到 C:\Program Files 无写入权限时，若要生成安全密钥，鼠标右键点击安装包，选择以管理员身份运行。
注2：配置外接数据库方法请参见：配置外接数据库
3. 注意事项
- 加密如果有新种子文件，则使用新密钥加密。
- 解密如果有新种子文件，则使用新密钥解密，解密失败则再去用旧密钥解密。
- 对升级 JAR 包的客户无影响，只要不手动放种子文件，那么还是走旧密钥加解密。
- 新安装 2020-08-04 及之后的 exe ，采用的种子文件生成的密钥加密密码，因此不能退回 JAR 包，退回后只有老的根密钥，无法对密码进行解密。