Linux 下 Tomcat 服务器部署包

1.1 版本

1.2 部署包简介

FineReport 提供了Linux 服务器部署包，该部署包内置有 JDK 和 Finereport 工程，用户部署完即可使用。

注：不支持在 32 位操作系统上安装。

2.1 下载 Tomcat

2.1.1 方法一：下载安装包并上传至 Linux 系统

进入 FineReport 官网，点击 帆软下载中心 ，下载 Linux 版服务器部署包，如下图所示：

2）下载完成后上传到 Linux 系统里，如下图所示：

注：示例使用XFTP工具，也可使用其他文件传输工具。

2.1.2 方法二：直接下载至 Linux 系统

直接复制下载链接，下载至 Linux 系统，如下图所示：

注：示例为下载至 usr 目录下，可根据需要下载在 Linux 对应位置。

执行语句如下所示：

wget https://fine-build.oss-cn-shanghai.aliyuncs.com/finereport/10.0/tomcat/tomcat-linux.tar.gz

2.2 安装 Tomcat

执行语句如下所示：

tar -zxvf tomcat-linux.tar.gz  # 解压 tomcat 安装包
mv tomcat-linux tomcat  # 重命名文件夹

2.3 启动 Tomcat

执行语句如下所示：

注：示例安装在 usr 目录下，可根据需要在 Linux 对应下载位置启动。

cd /usr/tomcat/bin  # 进入bin目录
./startup.sh  # 启动 Tomcat

2.4 开放防火墙端口

注：Linux中有两种防火墙软件，ConterOS7.0 以上使用的是 firewall，ConterOS7.0 以下使用的是 iptables 。详情请参见：Linux防火墙Firewall和Iptables的使用 

1）启动完成后，需要对外界开放 8080 端口，CentOS7 版本对防火墙进行加强，不再使用原来的iptables，启用 firewall 运行下面命令即可。

sudo firewall-cmd --state  # 查看防火墙状态
sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent  # 开启8080端口
sudo firewall-cmd --reload  # 重启防火墙
sudo firewall-cmd --list-ports  # 查看已开放的端口

2）再查看已开放的端口，这时看到 8080 端口就已经开启好，如下图所示：

3）此时即可访问 http://IP:8080/webroot/decision，至此就部署完成。

注：出于安全性设置，Linux 服务器部署包部署以后不能直接访问http://IP:8080。

3.1 模板预览报错

3.1.1 问题现象

问题现象：从 FineReport 官网下载的 Linux 版本的部署包，解压运行后，模板预览时出现报错，报错信息如下图所示：

3.1.2 原因分析

FineReport 使用的是 OpenJDK 的 JRE ，里面不带字体包。如果 Linux 缺少字体包，预览模板就会报错。

3.1.3 解决方案

1）方案一：在 Linux 中直接执行命令  yum install fontconfig，然后重启 Linux 系统 。详细内容参见 OpenJDK验证码无法显示 。

2）方案二：如果 Linux 有安装 JDK，直接将 JDK 安装目录下的%JAVA_HOME%\jre文件夹拷贝并覆盖掉 Tomcat 安装目录下的%TOMCAT%\jre这个文件夹，将%JAVA_HOME%/lib下的 tools.jar 拷贝到 Tomcat 安装目录下的%TOMCAT%/lib文件夹中，覆盖掉原有的 tools.jar。