去评论
海欣资源

帆软FineReport Linux下Tomcat服务器独立部署教程

as231qq
2022/07/17 21:54:41
1. 概述
1.1 版本
支持的 Tomcat 服务器版本和 JDK 版本如下,版本不对应会导致服务器部署失败。

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下。详细内容请参见文档: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