1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
1.2 应用场景
Tomcat 是免费且性能相对稳定的 Web 应用服务器，在许多中小型企业中深受欢迎。
1.3 功能简介
本文介绍在 Linux 系统中，如何将 FineReport 工程部署到 Tomcat 容器中。
注：相比于传统部署架构，容器化部署具有隔离性、可移植性、灵活性、可伸缩性和可控性等优点，可大幅降低企业的维护成本和资源成本。
推荐使用更具优势的容器化部署方案：部署新项目-FineReport
1.4 注意事项
本文以 CentOS7+JDK1.8+Tomcat9.0.44 为例进行演示，其他版本命令可能略有区别，请自行处理。
用户需要提前在 Linux 系统下安装 JDK 和 Tomcat，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。
同一个 Tomcat 服务器中不能部署多个 FineReport 工程
JDK 版本需为 1.8 且小版本需在 JDK8u102 以上。
不支持 Tomcat 10.0 版本。
2. 环境搭建
用户需要提前在 Linux 系统下安装 JDK 和 Tomcat，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「用户数」维度，准备合适的服务器环境：工程部署推荐环境及配置
2.2 安装JDK
独立部署时，用户需要单独准备 JDK 。
| 操作步骤 | 说明 |
|---|---|
| 版本要求 | 支持JDK 1.8 且小版本需在 JDK8u102 以上 |
| 下载JDK | 1）确认服务器系统架构：uname -m
2）下载正确版本安装包：JDK 安装的 JDK 版本一定要与操作系统匹配，64 位操作系统可以安装 32 位的 JDK ，但是 FineReport 不支持这样的操作，必须保持统一 3）将下载的 JDK 安装包上传到 Linux 服务器 |
| 安装JDK | 安装教程请参考 JDK 官方文档 示例语句：将安装包解压到/data目录 # tar -zxvf jdk8.0.202-linux_x64.tar.gz -C /data |
| 验证安装成功 | 查询语句：java -version 返回结果：返回版本，即代表安装成功
|
2.3 安装Tomcat
独立部署时，用户需要单独准备 Tomcat 。
1）下载安装Tomcat
| 操作步骤 | 说明 |
|---|---|
| 版本要求 |
|
| 下载Tomcat | 下载链接：Tomcat ，请选择「tar.gz」，将下载的Tomcat 安装包上传到 Linux 服务器
|
| 安装Tomcat | 安装教程请参考 Tomcat 官方文档 示例语句：Tomcat安装包解压到/data目录 # tar -zxvf apache-tomcat-8.5.51.tar.gz -C /data 同一个 Tomcat 服务器中不能部署多个 FineReport 工程。 |
3. 部署步骤
3.1 获取工程文件
1）付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式：服务平台>在线支持。
2）免费用户请参考 设计器安装，安装设计器后，%FR_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 拷贝工程文件
1）压缩上一节 webroot 文件夹。
2）将压缩包上传至服务器%Tomcat_HOME%\webapps目录下。
3）解压压缩包。
cd /data/tomcat/webapps
unzip webroot.zip
3.3 参数配置（选做）
FineReport工程部署到应用服务器上时，对应用服务器有一定的配置要求。
如果应用服务器不能满足工程使用时，会出现宕机风险。
建议在启动 Tomcat 服务器前，对参数进行配置，详情请参见：运维监控指导手册 。
注：重点是「Java 虚拟机检查」相关的配置项，其他内容建议在启动工程后逐一确认。
3.4 修改端口号（选做）
若 Linux 系统中有多个 Tomcat 同时运行，需要确认默认的 8080 端口号是否被占用；若 Linux 系统之前没有部署过工程，可忽略该节内容。
1）使用语句查看默认的 8080 端口号是否被占用，下图为被占用情况。
netstat -anp |grep 8080
2）若被占用，需要修改 Tomcat 端口号。详情请参见 修改Tomcat端口号
3.5 启动Tomcat
1）进入bin目录（根据目录自行修改）
cd /data/tomcat/bin
2）启动 Tomcat
./startup.sh
3）查看实时日志，实时日志中出现重启耗时则意味着启动成功。
cd /data/tomcat/logs
tail -f catalina.out
注：启动 Tomcat 后，如果报错「Database is not initialized」，请检查下用户读写权限，可使用命令chmod -R 777 tomcat配置权限。
3.6 访问FineReport系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineReport初始化配置页面，即部署成功。如下图所示：
注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
Tomcat 默认端口号为 8080，工程名默认为webroot。
注2：平台登录的用户名和密码是3.1节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。
4. 注意事项
部署常见问题请参见：Tomcat部署问题汇总
