Tomcat 是免费且性能相对稳定的 Web 应用服务器，在许多中小型企业中深受欢迎，本文将介绍如何将 FineBI 5.0 &5.1 部署到 Tomcat 服务器端。

1.1 支持版本

用户需提前下载并安装 JDK 和 Tomcat 服务器。Tomcat & JDK 安装及配置步骤请自行查阅资料。

Tomcat 版本与 JDK 版本需要与操作系统对应，Tomcat 版本、 JDK 版本与 BI 版本对应关系如下：

注1：FineBI5.0 以上仅支持 JDK1.8 版本，且同一个 Tomcat 服务器中不能部署多个 BI 工程。

注2：不支持 32 位的操作系统。

注3：不支持 Tomcat 10.0 版本。

示例在 Windows 系统下部署步骤。

2.1 准备工作

2.1.1 确认 JDK 安装成功

调用终端命令，输入 java -version 和 javac ，出现如下则表示 JDK 安装成功：

2.1.2 Tomcat 服务器已经安装成功

%Tomcat_HOME%\bin 目录下双击 startup.bat，启动 Tomcat 服务器( Linux 系统下执行./startup.sh )，在浏览器输入命令http://localhost:8080，出现如下图所示的网页则表示安装成功：

2.2 拷贝 BI 工程

将%FineBI%\webapps下的 webroot 文件拷贝到%Tomcat_HOME%\webapps下，如下图所示：

注：BI 工程名 webroot 可以自定义修改，但是需要注意的是后面访问 BI 工程时地址http://ip:端口/工程名/decision中的工程名也要随之更改。

2.3 拷贝 tools.jar

将%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_home%/lib或%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置下

注：如果不执行该操作，访问 BI 工程时，页面显示报错信息：HTTP Status 404。

2.4 配置参数

2.4.1 配置 BI 使用内存参数

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

2.4.2 配置 dump JVM 参数

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

进入%Tomcat%/bin目录下，编辑配置文件 catalina.bat ( Linux 系统下为 catalina.sh )，增加如下 JVM 参数：

JAVA_OPTS="$JAVA_OPTS -XX:+HeapDumpOnOutOfMemoryError"
JAVA_OPTS="$JAVA_OPTS -XX:HeapDumpPath=/opt/"

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

2.4 启动 Tomacat 服务器

进入%Tomcat_HOME%/bin目录下双击 startup.bat，即可启动 Tomcat 服务器( Linux 系统下执行 ./startup.sh )，如下图所示：

2.5 访问 BI 工程

在浏览器中输入访问地址http://IP:端口/webroot/decision，示例为http://localhost:8080/webroot/decision，打开 BI 工程登录页面，即部署成功，如下图所示：

3.1 Windows 系统下 CMD 窗口

1）Windows 系统下的 CMD 窗口默认可编辑，如果鼠标点进窗口，会造成所有的 Java 线程阻塞，造成 Tomcat 假死宕机不能使用。此时需要在 Tomcat 的 CMD 界面点击属性。如下图所示：

2）取消勾选两个编辑选项，点击确定保存该属性，并重启 Tomcat 即可。如下图所示：

3.2 关于页面显示 HTTP Status 404

将安装的 JDK 目录lib下面的tools.jar拷贝到%Tomcat_home%/lib或%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置。

3.3 Tomcat 高版本对 URL 特殊字符限制

1）Tomcat 9.0 做了更严格的限制，严格按照 RFC 3986 规范进行访问解析，而 RFC 3986 规范定义了 URL 中只允许包含英文字母（a-zA-Z）、数字（0-9）、-_.~4个特殊字符以及所有保留字符(RFC3986中指定了以下字符为保留字符：! * ’ ( ) ; : @ & = + $ , / ? # [ ])。

2）解决方法：

需要在 server.xml 文件中增加如下代码：

<Connector port="8084" protocol="HTTP/1.1" relaxedPathChars="[]|" relaxedQueryChars="[]|
{}^&#x5c;&#x60;&quot;&lt;&gt;" useBodyEncodingForURI="true" connectionTimeout="20000" redirectPort="8443"
URIEncoding="UTF-8"/>

3.4 内存不足

问题报错：配置管理员密码出错或Java heap space。

原因分析：表示 Tomcat 的内存不足，需修改Tomcat 内存配置。

解决方案：修改内存的方法参见文档：Java heap space。

3.5 7.0.100 版本的 Tomcat 部署

7.0.100 版本的 Tomcat 需要将 web.xml 放到%Tomcat_HOME%\webapps\webroot\WEB-INF下，否则会报错。

文件请参见：web.xml

注：该 Tomcat 的 bug 已经在 7.0.103 中修复。