1. 概述
1.1 版本
支持的 Tomcat 服务器版本和 JDK 版本如下，版本不对应会导致服务器部署失败。
| Tomcat 版本 | JDK 版本 |
|---|---|
推荐使用 Tomcat8.5.57 及以上版本，或者 Tomcat8 最新版本 注：使用推荐版本可减少因 Tomcat 版本过低导致的安全问题。 支持Tomcat7.0~9.0 版本 不支持 Tomcat10.0 版本 | JDK 1.8 且小版本需在 JDK8u102 以上 |
1.2 预期效果
用户希望将 FineReport 报表工程部署到 Linux 系统上的 Tomcat 中，效果如下图所示：
1.3 实现思路
1）将本地工程的 webroot 文件夹以压缩包形式上传到 Tomcat 服务器的%TOMCAT_HOME%\webapps下，并解压。
2）将 tools.jar 文件放到%TOMCAT_HOME%\lib下或者%TOMCAT_HOME%\webapps\工程名\WEB_INF\lib下。
3）重启 Tomcat 服务器，访问报表工程地址即可。
2. 操作步骤
2.1 环境准备
需参考 部署环境准备 文档，准备相关环境。
2.2 上传 webroot 文件至 Tomcat 环境中
1）将本地报表工程的 webroot 文件夹压缩，将压缩包上传至%TOMCAT_HOME%\webapps下，可以通过 WinSCP／FTP 等软件上传。如下图所示：
注：不推荐直接上传文件夹，防止文件出现问题。
上传完成后，解压压缩包，代码如下所示：
unzip webroot.zip
2.3 引入 JDK 中的 tools.jar 文件
将%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到部署的服务器中，拷贝到%TOMCAT_HOME%\lib下或者%TOMCAT_HOME%\webapps\工程名\WEB_INF\lib下。
详细内容参见文档：击报错500:服务器部署需引入tools.jar
代码如下所示：
cp /usr/java/jdk1.8.0_131/lib/tools.jar /usr/tomcat/apache-tomcat-8.5.61/lib
2.4 重启 Tomcat 服务器
1）进入%TOMCAT_HOME%/bin目录，运行./startup.sh，重启工程。
2）使用tail -f ../logs/catalina.out查看日志。
2.5 效果查看
启动浏览器，在地址栏输入：http://ip:服务器端口号/工程名/decision，能成功看到部署成功页面，则表明 FineReport 应用部署 Tomcat 服务器成功，如下图所示：
2.6 服务器宕机风险参数配置
FineReport 报表工程部署到其他应用服务器上时，对应用服务器有一定的配置要求，因此当应用服务器不能满足报表工程使用时，会出现宕机风险。
相关参数配置详情参见：修改FineReport配置参数
3. 注意事项
部署问题排查请参见：问题排查索引
3.1 权限问题
Linux 的文件权限，检查整个工程读写运行权限，一般我们可以直接给整个工程全部的权限，命令如下：
chmod -R 777 webroot/
3.2 路径问题
Linux 的路径里需要使用反斜杠，举例：
Windows 中 URL 路径为 emb:jdbc:hsqldb:file://${ENV_HOME}\finedb\db
而 Linux 中 URL 路径为emb:jdbc:hsqldb:file://${ENV_HOME}/finedb/db