历史版本2 :FineDataLink部署环境准备 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 系统要求编辑

类别

操作系统

已验证版本号

LinuxCentos6  Centos 6.5、Centos 6.6、Centos 6.7、Centos 6.8、Centos 6.9
Centos7Centos 7.0、Centos 7.1、Centos 7.2、Centos 7.3、Centos 7.4
RedHat6RedHat 6.5、RedHat 6.6、RedHat 6.7、RedHat 6.8、RedHat 6.9
RadHat7RedHat 7.0、RedHat 7.1、RedHat 7.2、RedHat 7.3、RedHat 7.4
windowsWindows ServerWindows Server 2008、Windows Server 2012

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

2. 网络要求编辑

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

类型带宽网段备注
公网10M 以上同网段/
内网无要求同网段内网一般都是百兆/千兆带宽,故对带宽不做要求

3. 机器要求编辑

3.1 内存配置

服务器系统内存
分配给 Web 容器 JVM 内存
应用服务器
建议 16G 以上建议 8G 以上,不要超过 32G,过大会导致系统 FullGC 时间过长

3.2 磁盘空间

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

机器作用硬件配置说明
应用服务器1部署工程/(根目录)保证至少有 40G 空余可用空间系统使用中的临时缓存地址
/usr部署工程,至少保证有 15G 空余可用空间默认日志存放路径

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

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

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


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

4. 部署容器准备编辑

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

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

容器版本JDK 版本
Tomcat

推荐使用 Tomcat8.5.57 及以上版本,或者 Tomcat8 最新版本

注:使用推荐版本可减少因 Tomcat 版本过低导致的安全问题。

支持Tomcat7.0~9.0 版本

不支持 Tomcat10.0 版

JDK 1.8 且小版本需在 JDK8u102 以上

注:JDK 版本若不符合这个要求,部署启动时可能会遇到问题

WebLogicWeblogic12.2.1.3 及以上
WebSphereWebSphere8.5
JBossJBoss6 及以上
ResinResin-4.0.58
TongWebTongWeb 6、TongWeb 7 版本

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

5. 工程准备编辑

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

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

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

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

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

6. 端口准备编辑

分类内容端口备注
web容器Tomcat8080外部端口,可不对外开放,可修改(server.xml),SSL、短地址等在负载均衡层面配置
WebLoigc7001
WebSphere9080
消息通知Websocket 端口38888/39888详情请参见:单机配置WebSocket端口


Websocket 转发端口38889

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 随机端口