1. 系统要求
类别 | 操作系统 | 已验证版本号 |
---|---|---|
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 | |
RedHat6 | RedHat 6.5、RedHat 6.6、RedHat 6.7、RedHat 6.8、RedHat 6.9 | |
RadHat7 | RedHat 7.0、RedHat 7.1、RedHat 7.2、RedHat 7.3、RedHat 7.4 | |
Ubuntu10 | Ubuntu 10.04.4 | |
Amazon Linux | Amazon Linux AMI release 2018.03 | |
windows | Windows Server | Windows 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 空余可用空间 | 默认日志存放路径 |
工程部署启动后,.FineReport100 文件夹所在目录需要留有空余空间:
1)Windows 系统中,该文件夹一般在C:\Users\用户名下(Windows10系统为例),用户根据实际情况确认。
注:Windows 系统设置「显示隐藏文件夹」后能看到 .FineReport110 文件夹,具体方法可自行百度。
2)Linux 系统中,若 root 启动的工程,一般在/root下;普通用户启动就在/home/$用户名/下。
4. 部署容器准备
若用户对 JDK 和容器没有要求,建议使用 服务器部署包 的方式进行部署。此方法无需下载安装 Tomcat、JDK,简单方便。
注1:所有帆软产品内置的 JDK 都为 Oracle OpenJDK 。
注2:部署时不支持 OpenLogic OpenJDK 。
若用户需要使用已有的容器和 JDK ,可参考本章内容。
注:如需在docker容器上运行FineReport/FineBI,请确保内存大于8G。
容器 | 版本 | JDK 版本 |
---|---|---|
Tomcat | 推荐使用 Tomcat8 最新版本 注:使用推荐版本可减少因 Tomcat 版本过低导致的安全问题。 支持Tomcat7.0~9.0 版本 不支持 Tomcat10.0 版 | JDK 1.8 且小版本需在 JDK8u102 以上 注1:JDK 版本若不符合这个要求,部署启动时可能会遇到问题 注2:JAVA 环境变量注意事项请参见:JAVA环境变量注意事项 |
WebLogic | Weblogic12.2.1.3 及以上 | |
WebSphere | WebSphere8.5 | |
JBoss | JBoss6 及以上 | |
Resin | Resin-4.0.58 |
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容器 | Tomcat | 8080 | 外部端口,可不对外开放,可修改(server.xml),SSL、短地址等在负载均衡层面配置 |
WebLoigc | 7001 | ||
WebSphere | 9080 | ||
消息通知 | 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 随机端口