1. 版本编辑
| 系统版本 | 服务器版本 | JDK 版本 | JAR 包版本 | BI 工程版本 |
|---|---|---|---|---|
| Windows10 | Tomcat-8.5.27 | JDK1.8 | 2019-11-29 | 5.1 |
注：以上版本信息只是示例的环境配置，用户可根据自己的实际应用场景选择不同的版本。
2. 操作步骤编辑
2.1 环境配置
用户需提前下载并安装 JDK 和 Tomcat 服务器。Tomcat & JDK 安装及配置步骤请自行百度。
Tomcat 版本与 JDK 版本需要与操作系统对应，不支持 32 位的操作系统。Tomcat 版本、 JDK 版本与 BI 版本对应关系如下：
| Tomcat 版本 | JDK版本 | BI 工程版本 |
|---|---|---|
| 8.0及以上（不支持 Tomcat 8.0.32 版本） | JDK1.8 | 5.0 以上 |
注：FineBI5.0 以上仅支持 JDK1.8 版本，且同一个 Tomcat 服务器中不能部署多个 BI 工程。
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 启动 Tomacat 服务器
进入%Tomcat_HOME%/bin目录下双击 startup.bat，即可启动 Tomcat 服务器( Linux 系统下执行 ./startup.sh )。
2.5 访问 BI 工程
在浏览器中输入访问地址http://localhost:8080/webroot/decision，打开 BI 工程登录页面，即部署成功。
2.6 配置 JVM 参数
此处我们还需要为工程配置上宕机自动生成 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.7 服务器宕机风险参数配置
FineBI 对服务器有一定的配置要求，当服务器不能满足 BI 使用时，会出现宕机风险，相关参数配置详情参见：FineBI宕机风险参数说明。
3. 注意事项编辑
3.1 导出 Excel 设置
Linux 环境下使用 Tomcat 下部署了 FineBI 工程后，若要导出 Excel ( 包含 组件导出Excel 和 仪表板导出Excel )，则需要进入%Tomcat%/bin目录下，编辑配置文件 catalina.sh，搜索 RUNJAVA，在所有类似如下图所示的内容后面，都增加一行代码：
Djava.awt.headless=true \
修改文件后保存，并重启 FineBI 工程，即可导出 Excel。
3.2 Windows 系统下 CMD 窗口
1）Windows 系统下的 CMD 窗口默认可编辑，如果鼠标点进窗口，会造成所有的 Java 线程阻塞，造成 Tomcat 假死宕机不能使用。此时需要在 Tomcat 的 CMD 界面点击属性。如下图所示：
2）取消勾选两个编辑选项，点击确定保存该属性，并重启 Tomcat 即可。如下图所示：
3.3 关于页面显示 HTTP Status 404
将安装的 JDK 目录lib下面的tools.jar拷贝到%Tomcat_home%/lib或%Tomcat_home%/webapps/webroot/WEB-INF/lib任一位置。
3.4 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="[]|{}^\`"<>" useBodyEncodingForURI="true" connectionTimeout="20000" redirectPort="8443"URIEncoding="UTF-8"/>3.5 内存不足
问题报错：配置管理员密码出错或Java heap space。
原因分析：表示 Tomcat 的内存不足，需修改Tomcat 内存配置。
解决方案：修改内存的方法参见文档：Java heap space。
3.6 7.0.100 版本的 Tomcat 部署
7.0.100 版本的 Tomcat 需要将 web.xml 放到%Tomcat_HOME%\webapps\webroot\WEB-INF下，否则会报错。
文件请参见：web.xml
注：该 Tomcat 的 bug 已经在 7.0.103 中修复。