FineReport工程部署环境准备

注：使用中文的用户将工程部署到 Linux 系统时，需确认系统中是否有中文语言包，具体请参见：Linux 系统安装中文语言包

公网环境和内网环境均可部署工程。如下：

3.1 内存配置

3.2 磁盘空间

部署工程要求各机器的根目录空余空间至少 40G 以上，如果模板资源文件超大，根据实际情况选择较大磁盘空间的服务器。

工程部署启动后，.FineReport110 文件夹所在目录需要留有空余空间：

1）Windows 系统中，该文件夹一般在C:\Users\用户名下（Windows10系统为例），用户根据实际情况确认。

注：Windows 系统设置「显示隐藏文件夹」后能看到 .FineReport110 文件夹，具体方法可自行百度。

2）Linux 系统中，若 root 启动的工程，一般在/root下；普通用户启动就在/home/$用户名/下。

若用户对 JDK 和应用服务器没有要求，建议使用 服务器部署包 的方式进行部署。此方法无需下载安装 Tomcat、JDK，简单方便。

注1：所有帆软产品内置的 JDK 都为 Oracle OpenJDK 。

注2：部署时不支持 OpenLogic OpenJDK 。

若用户需要使用已有的应用服务器和 JDK ，可参考本章内容。

注：如需在docker容器上运行FineReport/FineBI，请确保内存大于8G。

1）Tomcat 部署时，需注意：

• 建议使用解压版的 Tomcat 和 JDK。

• 10.0 工程暂不支持与 9.0 共用容器。

• 同一个 Tomcat 服务器中不能部署多个 FineReport 工程。

• 所有版本的 Tomcat 部署步骤基本相同，JDK 版本必须要与操作系统对应，如 32 位的系统只能使用 32 位的 JDK。

• 用户环境若安装多个 Tomcat ，不建议用户环境变量配置 CATALINA_HOME 或者 TOMCAT_HOME 。否则不论用户启动哪个 Tomcat ，启动的都是 CATALINA_HOME 指定的那个。

• 7.0.100 版本的 Tomcat 需要将 web.xml 放到%Tomcat_HOME%\webapps\webroot\WEB-INF下，否则会报错。

文件请参见：web.zip

注：该 Tomcat 的 bug 已经在 7.0.103 中修复。

2）Windows 系统安装配置 JDK 时，需注意：

• 环境变量 JAVA_HOME 一定要有，Path 下一定要有%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin

• 若环境变量指向的%JRE_HOME%/bin下无 attach.dll 文件，还需将%JAVA_HOME%/jdk/jre/bin下的 attach.dll 拷贝到此路径下，否则 Tomcat 启动后会报错：fine assist start failed

注1：需要准备没有做过集成的工程。

注2：为保障工程正常运行，一些文件夹需要有足够的权限。具体说明请参见：Linux文件权限配置

部署工程需要准备%FR_HOME%\webapps下的 webroot 文件夹：

1）若用户对 JDK 和容器没有要求，选择使用 服务器部署包 的方式进行部署时，可直接使用部署包中的全新工程。全新工程部署后，平台登录的用户名和密码需要自己设置。

2）若用户选择 独立部署 的方式进行部署，需提前准备好工程，已有的工程或者重新 下载最新的工程 。若使用已有的工程进行部署，平台登录的用户名和密码是已有工程的。

1）端口是否被占用请参见：端口占用查看

2）如果默认端口与其他工程有冲突，需要先修改端口，再开放对应的端口。

3）若同一个服务器部署多个 Tomcat 工程，需要修改 Tomcat 端口号以防端口冲突，具体可参见：修改Tomcat端口号

4）若防火墙开启，需要开放相关端口号：Windows 系统开放端口步骤请参见：Windows服务器设置出入站规则 ，Linux 系统开放端口步骤请参见：Linux防火墙使用及配置

5）对于 docker 容器，或者服务器之间端口严格限制的环境，需要对节点的服务器之间开放端口，用于节点间通信。

• 选择 TCP 协议是 7800/7810/7820/7830/7840/7850/7860/7870 八个端口

• 选择 UDP 协议是 45588～65536 随机端口