修改配置参数

FineReport 报表工程部署到其他应用服务器上时，对应用服务器有一定的配置要求，因此当应用服务器不能满足报表工程使用时，会出现宕机风险。

FineReport 在部署后需要修改使用内存和其他参数，确保服务器稳定运行。

请参见下方表格内容：

建议单线程使用栈空间不超过512KB，即 -Xss 的值不超过 512 。

在设置-Xmx、-Xms参数的位置，添加 -Xss 的值即可，本节展示 Tomcat 环境下设置 -Xss 的步骤。

Windows 系统：

1）进入%Tomcat%/bin目录，找到并编辑配置文件catalina.bat，配置：

set JAVA_OPTS= -Xms512M -Xmx1024M -Xss512K

如下图所示：

2）修改后，重启工程。

Linux 系统：

1）进入%Tomcat%/bin目录，找到并编辑配置文件catalina.sh，配置：

JAVA_OPTS="$JAVA_OPTS -Xms2048M -Xmx8196M -Xss512K"

2）修改后，重启工程。

堆内老年代与新生代大小比例建议为 2（-XX:NewRatio=2，JVM的默认值）；NewRatio 大小正常生效需要用户不限制新生代大小。

在设置-Xmx、-Xms参数的位置，添加 NewRatio 的值即可，，本节展示 Tomcat 环境下设置 NewRatio 的步骤。

Windows 系统：

1）进入%Tomcat%/bin目录，找到并编辑配置文件catalina.bat，配置：

set JAVA_OPTS= -Xms512M -Xmx1024M -XX:NewRatio=2

如下图所示：

2）修改后，重启工程。

Linux 系统：

1）进入%Tomcat%/bin目录，找到并编辑配置文件catalina.sh，配置：

JAVA_OPTS="$JAVA_OPTS -Xms2048M -Xmx8196M -XX:NewRatio=2"

2）修改后，重启工程。

堆外内存由-XX:MaxDirectMemorySize这个参数来设置，建议最多使用内存不超过 4GB 。

注：MaxDirectMemorySize 最少为 2GB 。

5.1 直接部署修改参数

1）如果是安装包直接安装 FineReport ，可以直接在%FR_HOME%/bin目录下的designer.vmoptions文件中修改。Windows 以及 Linux/Unix 系统均修改该文件（这里是以 M 为单位），如下图所示：

增加参数如下图所示：

-XX:MaxDirectMemorySize=2g

2）配置完成后重启工程。

5.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）配置完成后重启工程。

5.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）配置完成后重启工程。

5.4 部署在 Websphere 中修改参数

5.4.1 方法一：控制台编辑（推荐）

访问 Websphere 控制台，进入 JAVA 虚拟机配置界面，同本文 3.3.1 节，在输入框中新增 JVM 参数：

-MaxDirectMemorySize=2096

如下图所示：

5.4.2 方法二：修改配置文件

修改 Websphere 安装目录下的配置文件 server.xml ，在其中新增 JVM 参数：

MaxDirectMemorySize="2096"

如下图所示：

配置完成后重启工程。

建议使用默认的 Parallel Scavenge 收集器（并行收集器）。

6.1 查看当前使用的垃圾收集器

6.1.1 Windows 系统下查看

win+R 进入cmd，命令如下所示：

java -XX:+PrintCommandLineFlags -version

如下图所示：

6.1.2 Linux 系统下查看

输入以下命令：

java -XX:+PrintCommandLineFlags -version

如下图所示：

6.2 设置垃圾收集器

工程部署在 Tomcat 上时， 可参考本节方法设置垃圾收集器为Parallel Scavenge（并行收集器）。

Windows 系统：

1）进入%Tomcat%/bin目录，找到并编辑配置文件catalina.bat，配置：

set JAVA_OPTS= -XX:+UseParallelGC

如下图所示：

2）修改后，重启工程。

Linux 系统：

1）进入%Tomcat%/bin目录，找到并编辑配置文件catalina.sh，配置：

JAVA_OPTS="$JAVA_OPTS -XX:+UseParallelGC"

2）修改后，重启工程。

1）建议工程所在磁盘剩余空间不小于 5G 。

2）建议物理机总内存减去系统所在容器使用内存不小于 10GB 。

3）工程所在磁盘剩余空间建议不小于 5G 。