一、FineBI端口开放列表1.概述

在安装完成FineBI后,服务器需要开放一些端口供系统监听使用。对于服务器安全要求高的客户来说,在启动之前需要保证这些端口的开放,否则FineBI无法正常启动。

2.Spider单机部署开放端口

注:若使用了Nginx服务器,则可能需要单独修改Requestport,详情参见:Nginx常见报错及解决方案。

二、FineBI安装目录结构1.概述

在FineBI安装完成以后,进入安装目录可以看到安装文件。FineBI安装文件本质上就是一个Tomcat。本文详细介绍安装目录结构。

2.安装根目录

每个文件存放的内容如下表所示:

文件

内容

.install4j

FineBI的图片

bin

BI工程启动文件所在的目录,其中可以在中修改BI分配的内存大小和编码方式

这个目录下的ROOT文件夹下是所有的数据表以及临时数据表,也是默认进行数据更新存放位置,可自行调整位置,详情参见:数据更新构成与存放

这个目录下的存放的是访问前端时输出的信息概况

bin下面的log相关文件可以清理

jre

是在Java运行环境下支持Java应用程序

lib

存放BI启动的时候的加载动画的JAR包

logs

包含工程运行日志、GC日志注:清空一般不会对运行带来影响。

server

Tomcat的根目录,包含Tomcat的配置文件夹以及Tomcat自带的依赖文件夹

temp

存放Tomcat运行过程中产生的临时文件

同时为导出Excel文件的缓存路径,可在%FineBI%/bin目录下的文件中通过修改参数=.\temp来自行修改缓存存放位置

可以在工程停机后删除文件夹,释放内存

注:temp临时目录在工程运行时不建议做清理,需要在工程停机时清理,如果清理后提示报错需要工程重启

webapps

存放应用程序,当服务启动时会去加载webapps目录下的应用程序

帮助文档.chm

版本的离线帮助文档

LICENSE

许可证,里面记录了Tomcat的一些条款等等

NOTICE

记录Tomcat的新的通知,公告

RELEASE-NOTES

记录的是发行版本的说明,一些捆绑的API,新特性等等

记录Tomcat的运行环境以及怎样配置参数,变量,启动等等

自带卸载exe,双击即可调用卸载功能

3.webroot目录

每个文件存放的内容如下表所示:

文件

内容

backup

存放工程备份文件,包含平台配置备份、jar备份、插件备份等

Demo_files

存放工程自带的DEMO展示需要的文件

logs

存放日志文件,记录系统登录信息、模板访问信息、报错信息等

scripts

存放插件相关文件

WEB-INF

BI工程主目录

内置Sqlite数据库文件

内置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开关,处理sigard导致JVM虚拟机崩溃问题时使用

工程证书文件

Rserver连接配置

6.schedule目录

测试定时任务邮件通知:存放定时调度生成的文件。

7.dashboard目录

目录下存放的是不同用户ID命名的文件夹。

点开某用户ID的文件夹,如下图所示:

FBI文件:存放的是对应用户创建的具体仪表板,用仪表板ID命名文件。

8.注意事项8.1文件介绍

部分用户工程的%FineBI_HOME%\bin目录中存在文件,该文件不会根据日期进行拆分,记录所有日期error级别的日志和一些相关的info信息。

若用户觉得该文件占用磁盘空间过大,可手动删除、写脚本定时删除或者写脚本监控大小删除。

注1:建议确认日志已够用,再考虑是否删除文件。

注2:若工程部署在Tomcat的容器中,bin目录下不会有文件。

三、生成安全密钥文件按钮说明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下生成一个文件,记录了配置数据库的地址、用户名、密码等信息。

主要作用于两方面:

迁移后文件里面数据库的密码加解密

数据连接密码、邮箱密码、帆软通行证密码等加解密(不包括平台用户密码)

为了增强密钥的安全性,现对根密钥的逻辑进行优化。

2.按钮介绍

FineBI安装时勾选「生成安全密钥文件」按钮,选择后会随机生成3个种子文件,工程启动时读取种子文件,内存中根据种子生成恒定公私钥,此时加解密使用生成的种子文件。

若用户对安全性要求较高,可勾选该按钮。如下图所示:

注2:配置外接数据库方法请参见:配置外接数据库

3.注意事项

加密如果有新种子文件,则使用新密钥加密。

解密如果有新种子文件,则使用新密钥解密,解密失败则再去用旧密钥解密。

对升级JAR包的客户无影响,只要不手动放种子文件,那么还是走旧密钥加解密。

新安装2020-08-04及之后的exe,采用的种子文件生成的密钥加密密码,因此不能退回JAR包,退回后只有老的根密钥,无法对密码进行解密。