1. 概述编辑
FineReport 报表工程部署到其他应用服务器上时,对应用服务器有一定的配置要求,因此当应用服务器不能满足报表工程使用时,会出现宕机风险。
FineReport 在部署后需要修改使用内存和其他参数,确保服务器稳定运行。
2. 修改堆内内存编辑
请参见下方表格内容:
参数介绍 | 服务器类型 | 参考文档 |
---|---|---|
-Xmx 参数:最大堆内内存 -Xms 参数:初始化内存大小 注1:Xmx/Xms 与数字之间不要有空格 注2:建议配置Xms=Xmx,以防止内存扩容失败情况 | Tomcat 服务器 | Tomcat 服务器内存修改 |
WebLogic 服务器 | WebLogic 服务器内存修改 | |
WebSphere 服务器 | WebSphere 服务器 | |
JBoss 服务器 | JBoss 服务器 | |
Resin 服务器 | Resin 服务器内存修改 |
3. 修改 MaxDirectMemorySize 参数编辑
堆外内存由-XX:MaxDirectMemorySize这个参数来设置,若这个参数未设置,则默认为物理内存的1/4;若用户自定义设置,建议最多使用内存不超过 4GB 。
注:MaxDirectMemorySize 最少为 2GB 。
3.1 直接部署修改参数
1)如果是安装包直接安装 FineReport ,可以直接在%FR_HOME%/bin目录下的designer.vmoptions文件中修改。Windows 以及 Linux/Unix 系统均修改该文件(这里是以 M 为单位),如下图所示:
增加参数如下图所示:
-XX:MaxDirectMemorySize=2g
2)配置完成后重启工程。
3.2 部署在 Tomcat 中修改参数
1)配置方式:进入%Tomcat%/bin目录,找到并编辑配置文件catalina.bat,
Windows 修改 catalina.bat 文件,增加配置:
set JAVA_OPTS=%JAVA_OPTS% -XX:MaxDirectMemorySize=2g
表示 MaxDirectMemorySize = 2GB,如下图所示:
Linux/Unix 修改 catalina.sh 文件,增加配置:
JAVA_OPTS="$JAVA_OPTS -XX:MaxDirectMemorySize=2g"
2)配置完成后重启工程。
3.3 部署在 Weblogic 中修改参数
1)修改 Weblogic 安装目录%Weblogic%/domains/用户工程名/下的 startWebLogic 文件,增加一条配置。
Windows 系统:
Windows 在startWebLogic.bat文件中新增配置:
set MEM_ARGS=-XX:MaxDirectMemorySize=2g #表示 MaxDirectMemorySize = 2GB
Linux 系统:
Linux 在startWebLogic.sh文件中新增配置:
MEM_ARGS="-XX:MaxDirectMemorySize=2g" #表示 MaxDirectMemorySize = 2GB
如下图所示:
2)配置完成后重启工程。
3.4 部署在 Websphere 中修改参数
3.4.1 方法一:控制台编辑(推荐)
访问 Websphere 控制台,进入 JAVA 虚拟机配置界面,同本文 3.3.1 节,在输入框中新增 JVM 参数:
-MaxDirectMemorySize=2096
如下图所示:
3.4.2 方法二:修改配置文件
修改 Websphere 安装目录下的配置文件 server.xml ,在其中新增 JVM 参数:
MaxDirectMemorySize="2096"
如下图所示:
配置完成后重启工程。
4. 垃圾收集器编辑
建议使用默认的 Parallel Scavenge 收集器(并行收集器)。
4.1 查看当前使用的垃圾收集器
4.1.1 Windows 系统下查看
win+R 进入cmd,命令如下所示:
java -XX:+PrintCommandLineFlags -version
如下图所示:
4.1.2 Linux 系统下查看
输入以下命令:
java -XX:+PrintCommandLineFlags -version
如下图所示:
4.2 设置垃圾收集器
工程部署在 Tomcat 上时, 可参考本节方法设置垃圾收集器为Parallel Scavenge(并行收集器)。
Windows 系统:
进入%Tomcat%/bin目录,找到并编辑配置文件catalina.bat,配置:
set JAVA_OPTS= -XX:+UseParallelGC
如下图所示:
Linux 系统:
进入%Tomcat%/bin目录,找到并编辑配置文件catalina.sh,配置:
JAVA_OPTS="$JAVA_OPTS -XX:+UseParallelGC"
5. 注意事项编辑
1)堆内老年代与新生代大小比例建议为 2(-XX:NewRatio=2,JVM的默认值)。
2)建议工程所在磁盘剩余空间不小于 5G 。
3)建议单线程使用栈空间不超过512KB,即 -Xss 的值不超过 512 。