1.1 版本

注：同一个 Tomcat 服务器中不能部署多个 FineBI 工程。

1.2 预期效果

用户希望将 FineBI 报表工程部署到 Linux 系统上的 Tomcat 中，效果如下图所示：

1.3 环境准备

用户需要提前在 Linux 系统下安装 JDK 和 Tomcat，具体的安装方法可以自行查阅资料，文档和技术支持不负责环境搭建部分的内容。

1.4 实现思路

1）将本地工程的 webroot 文件夹以压缩包形式上传到 Tomcat 服务器的%TOMCAT_HOME%\webapps下，并解压。

2）将 tools.jar 文件放到%TOMCAT_HOME%\lib下或者%TOMCAT_HOME%\webapps\工程名\WEB_INF\lib下。

3）重启 Tomcat 服务器，访问报表工程地址即可。

本文以 CentOS7+JDK1.8+Tomcat9.0.44 为例进行演示，其他版本命令可能略有区别，请自行处理。

2.1 上传 webroot 文件至 Tomcat 环境中

1）将本地 FineBI 工程的 webroot 文件夹压缩，将压缩包上传至%TOMCAT_HOME%\webapps下，可以通过 WinSCP／FTP 等软件上传。如下图所示：

注：不推荐直接上传文件夹，防止文件出现问题。

2）上传完成后，解压压缩包，代码如下所示：

cd /usr/BI/apache-tomcat-9.0.44/webapps
unzip webroot.zip

2.2 引入 JDK 中的 tools.jar 文件

将%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到部署的服务器中，拷贝到%TOMCAT_HOME%\lib下或者%TOMCAT_HOME%\webapps\工程名\WEB_INF\lib下。

代码如下所示：

cp /usr/java/jdk1.8.0_241-amd64/lib/tools.jar /usr/BI/apache-tomcat-9.0.44/lib

2.3 确认是否修改端口号

若 Linux 系统中有多个 Tomcat 同时运行，需要确认默认的 8080 端口号是否被占用；若 Linux 系统之前没有部署过工程，可忽略该节内容。

1）查看默认的 8080 端口号是否被占用，下图为被占用情况。

netstat  -anp  |grep 8080

2）若被占用，需要修改 Tomcat 端口号。具体方法请参见 Tomcat 端口配置 

2.4 配置参数

2.4.1 配置 BI 使用内存参数

FineBI 对服务器有一定的配置要求，因此需要配置内存参数保证服务器稳定，详情参见：修改 FineBI 配置参数 

注：修改 FineBI 配置参数 5.1 节的 headless 参数若不配置，超管 导出 Excel 时，将会报错：无导出权限。

2.4.2 配置 dump JVM 参数

此处需要为工程配置上宕机自动生成 dump 日志的 JVM 参数，配置该参数对工程运行没有性能损耗的影响，仅用于在服务器宕机时生成 dump 日志。

进入%TOMCAT_HOME%/bin目录下，编辑配置文件 catalina.sh ，增加如下 JVM 参数：

set JAVA_OPTS=%JAVA_OPTS% -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=D:\heapdump

注：其中D:\heapdump 路径表示的是宕机文件生成路径，可以根据需要修改文件路径。修改保存后，需要重启 Tomcat 才能使配置生效。

如下图所示：

2.5 启动 Tomcat

注：Linux 系统中关闭与重启部署在 Tomcat 中的 BI 工程，可参见 关闭FineBI工程

执行语句如下所示：

cd /usr/BI/apache-tomcat-9.0.44/bin  # 进入bin目录
./startup.sh  # 启动 Tomcat

2.6 效果查看

启动浏览器，在地址栏输入：http://ip:服务器端口号/工程名/decision，如下图所示：