概述
本文简单介绍:
部署帆软应用时支持的部署环境
部署帆软应用时必须满足的要求
注1:本文列出的是全量的部署支持环境。建议您参考该文档选择最适合的部署环境:工程部署推荐环境
注2:本文列出的是帆软测试通过的环境。
本文未提及的更低版本,一般默认不支持,或存在一些漏洞,不建议使用
本文未提及的更高版本,用户可自行测试验证。如果使用后出现问题,付费用户可联系技术支持获取帮助。技术支持联系方式:前往「服务」,选择「在线支持」、电话「400-811-8890」。
注3:对于外接数据库组件,文档仅列出支持的版本,具体部署方法建议优先查询具体厂商文档。
通用服务器要求
服务器操作系统
优先推荐使用 Linux 操作系统部署帆软应用和外接数据库组件。推荐版本:
系统版本:Ubuntu 18.04.4 及以上
系统内核:3.10 及以上
系统架构:X86_64
注:Linux和Windows对比分析请参见:Linux和Windows对比分析
类别 | 操作系统 | 已验证版本号 |
---|---|---|
Linux | Centos6 | Centos 6.5、Centos 6.6、Centos 6.7、Centos 6.8、Centos 6.9 |
Centos7 | Centos 7.0、Centos 7.1、Centos 7.2、Centos 7.3、Centos 7.4 Centos 7.6、Centos 7.8、Centos 7.9 | |
RedHat6 | RedHat 6.5、RedHat 6.6、RedHat 6.7、RedHat 6.8、RedHat 6.9 | |
RedHat7 | RedHat 7.0、RedHat 7.1、RedHat 7.2、RedHat 7.3、RedHat 7.4 RedHat 7.7 | |
Ubuntu | Ubuntu 10.04.4、Ubuntu18.04、Ubuntu 20 | |
Amazon Linux | Amazon Linux AMI release 2018.03 | |
Rocky Linux | Rocky Linux 8.8~9.4版本 | |
windows | Windows Server 2008 及以上 Windows 11 |
服务器端口准备
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 随机端口
分类 | 内容 | 端口 | 备注 |
---|---|---|---|
中间件 | Tomcat | 8080 | 外部端口,可不对外开放,可修改(server.xml),SSL、短地址等在负载均衡层面配置 |
WebLoigc | 7001 | ||
WebSphere | 9080 | ||
消息通知 | Websocket 端口 | 38888/39888 | 详情请参见: 容器Websocket方案 单机配置WebSocket端口 |
Websocket 转发端口 | 38889 |
服务器网络要求
1)公网环境和内网环境均可部署帆软应用和外接数据库组件。如下表所示:
类型 | 带宽 | 网段 |
---|---|---|
公网 | 10M 以上 | 工程节点、外接数据库处于同网段 |
内网 | 内网一般都是百兆/千兆带宽,故对带宽不做要求 | 工程节点、外接数据库处于同网段 |
2)工程节点、外接数据库间需要支持通信。可使用 ping 语句检测。
工程部署要求
服务器配置要求
帆软应用支持单机和集群部署,集群则为多个工程节点。
每个节点都是一个可以独立运行的工程,负责处理用户的请求,处理生成报表的任务和管理其他组件的工作。
建议按照工程并发数,准备不同数量和配置的工程节点,具体如下表所示:
注:工程节点服务器 JVM 内存建议 8G 以上,不超过 32G,过大会导致系统 FullGC 时间过长。
注册用户数 | 在线用户数 | 并发用户数 | 推荐配置 | 最低配置 |
---|---|---|---|---|
2000-5000 | 400-1000 | 0-200 | 1节点,每个节点满足: CPU:8 核 16 线程 2.4GHZ JVM 内存:16GB 物理内存:32G | 1节点,每个节点满足: CPU:8 核 16 线程 2.4GHZ JVM 内存:8GB 物理内存:16G |
4000-10000 | 800-1500 | 200-300 | 1节点,每个节点满足: CPU:8 核 16 线程 2.4GHZ JVM 内存:16GB 物理内存:32G | 1节点,每个节点满足: CPU:8 核 16 线程 2.4GHZ JVM 内存:8GB 物理内存:16G |
6000-12000 | 1200-2500 | 300-500 | 2节点以上集群 本文不做介绍 | 1节点,每个节点满足: CPU:8 核 16 线程 2.4GHZ JVM 内存:16GB 物理内存:32G |
8000-30000 | 1600-6000 | 500-1200 | 2节点以上集群 本文不做介绍 | 2节点以上集群 本文不做介绍 |
注1:用户维度说明:
注册用户数:系统注册了的用户。
在线用户数:用户同时在一定时间段的在线数量(一般注册人数的 5% - 20% 之间)。
并发用户数:同时向服务器发送请求的用户数(一般是在线人数的 10% - 25% 左右)。
注2:配置说明:
推荐配置时:70% 场景的平均响应时间低于 3s。
最低配置时:70% 场景的平均响应时间低于 5s。
服务器磁盘空间
目录 | 作用 | 配置要求 |
---|---|---|
工程部署 | 用于部署工程,存放工程模板资源文件等 | 500G以上 |
根目录 | 存放内容: 对于帆软应用,指系统使用时的临时缓存.FineReport110 目录位置: 1)对于linux系统中root用户启动的工程 根目录在/root下 2)对于linux系统中非root用户启动的工程 根目录在/home/$用户名/下 3)对于Windows系统中启动的工程 根目录在C:\Users\用户名下 | 不小于40G |
/usr目录 | 默认日志存放路径 | 不小于15G |
服务器其他要求
分类 | 说明 | 参考文档 |
---|---|---|
语言要求 | 使用中文的用户将工程部署到 Linux 系统时,需确认系统中是否有中文语言包 | Linux 系统安装中文语言包 |
权限要求 | 为保证工程正常运行,最低要给工程文件夹 755 权限 | Linux文件权限配置 |
中间件要求
容器化部署/部署包部署无需准备本节内容,产品均内置了 JDK 和应用服务器,内置的 JDK 都为 OpenJDK 。
独立部署需要准备本节内容。需要自备应用服务器和 JDK 。
FineReport 是纯 Java 的 Servlet 应用程序,必须部署在 Tomcat、WebLogic、WebSphere 等中间件下。
启动中间件时就会加载 FineReport 这个 Servlet应用程序,工程才能正常运作。
中间件 | 中间件版本 | JDK 版本 |
---|---|---|
Tomcat | 推荐使用 Tomcat9 最新版本 注:使用推荐版本可减少因 Tomcat 版本过低导致的安全问题。 支持 Tomcat8.5~9.0 版本 不支持 Tomcat10.0 版本 | JDK 1.8 且小版本需在 JDK8u102 以上 注1:JDK 版本若不符合这个要求,部署启动时可能会遇到问题 注2:JDK 版本必须要与操作系统对应,如 32 位的系统只能使用 32 位的 JDK 注3:不支持 OpenLogic OpenJDK 。 |
WebLogic | Weblogic12.2.1.X Weblogic14.X | |
WebSphere | WebSphere8.5.X WebSphere9.0.X | |
Wildfly(Jboss) | 推荐使用 Wildfly27.0.0 Final 以上版本 注:使用推荐版本可减少因 Wildfly 版本过低导致的安全问题。 JBoss6 及以上 | |
Resin | Resin-4.0.58 |
1)中间件部署注意事项:
如需在docker容器上运行FineReport/FineBI,请确保内存大于8G。
建议使用解压版的 Tomcat 和 JDK。
同一个中间件中不能部署多个 FineReport 工程。
用户环境若安装多个 Tomcat ,不建议用户环境变量配置 CATALINA_HOME 或者 TOMCAT_HOME 。否则不论用户启动哪个 Tomcat ,启动的都是 CATALINA_HOME 指定的那个。
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
应用工程准备
容器化部署/部署包部署无需准备本节内容,产品内置了全新工程。全新工程部署后,平台登录的用户名和密码需要自己设置。
独立部署需要准备本节内容。
部署工程需要准备%FR_HOME%\webapps下的 webroot 文件夹。
需提前准备好工程,已有的工程或者重新 下载最新的工程 。
若使用已有的工程进行部署,平台登录的用户名和密码是已有工程的。
外接数据库要求
数据决策系统中除平台属性配置以外的所有信息,包括目录树设置、模板定时任务信息等,均存储于一个数据库中。
它管理和存储了工程节点的各种配置信息,保证各个节点的配置一致性,并方便管理员集中管理工程的元数据。
正式工程均建议配置外接数据库。
服务器配置要求
占用空间需要结合使用度进行调整,可以根据webapps/webroot/WEB-INF/embed/finedb文件夹大小配置,并根据实际大小预估未来使用大小,增大1~2倍。
外接数据库尽量和工程在同一网段,避免网络波动等问题。
配置类型 | 最低配置 |
---|---|
物理内存 | 16GB |
CPU | 2.4GHz以上 4核8线程 |
网速 | 50Mbps |
可用磁盘空间 | 100G以上 其中根目录可用磁盘不可小于40G |
磁盘读写速度 | 50MB/s |
数据库类型要求
非容器化部署需要准备本章内容。容器化部署无需准备本节内容。
数据库类型 | 支持数据库版本 | 配置方法 |
---|---|---|
RDS MySQL | 不限制版本 | 配置MySQL5外接数据库 |
MySQL | 5.1.73、5.5.31、5.5.46、5.5.56、5.6.22、5.6.31、5.7.16 | |
8.0.11,8.0.16,8.0.20 | 配置MySQL8外接数据库 | |
Oracle | 10g、11g、12c | 配置Oracle外接数据库 |
SQL Server | 2000、2005、2008、2012、2014、2016 | 配置SQL Server外接数据库 |
2017 | ||
DB2 | 9.7、8.2、11.1 | 配置DB2外接数据库 |
PostgreSQL | 9.4.7、9.5.0、9.5.2、9.6.0 | 配置PostgreSQL外接数据库 |