运维监控指导手册

企业在管理帆软应用（FineReport、FineBI）的过程中，常常会遇到一些痛点和挑战：

1）低效的运维流程：应用管理员运维经验不足，专业运维人员又无法深入解决应用问题，传统运维流程耗时耗力，导致企业运维效率低下，影响业务的正常运转。

2）不足的监控手段：运维人员可能无法准确监控项目的性能和可用性，缺乏运维过程中必要的工具和技术。

3）多项目管理混乱：企业可能有多个项目运行，而这些项目由不同的部门或团队负责管理，导致版本不统一、部署环境各异，难以进行统一的运维管理。

因此帆软推出「FineOps运维平台（为企业提供帆软应用稳定运行和全方位运维管理的解决方案）」，帮助企业更好地解决以上问题。

1.1 版本

1.2 应用场景

针对常见的运维监控诉求场景，给出现有的运维监控功能方案介绍，帮助客户快速实现对于 FineReport 和 FineBI 应用的运维监控。

方案适用于已经完成部署的帆软系统，将会展开介绍帆软应用的日常维护、管理和监控方式。

1.3 功能简介

帆软应用对系统有一定的配置要求，如果配置不符合要求可能出现使用异常、宕机等风险，因此需要定期对环境及应用的配置情况进行检测，以确保应用的健康运行。

同时管理员需要关注应用的运行状况，及时通过运维手段规避风险或在问题发生后定位并进行排除，实现应用的持续高可用。

本文方案将从以下几个方面展开介绍帆软应用的具体运维方式：

注：鉴于服务器情况不同，没有完全通用的解决方案。部分检查项仅提供推荐配置值，请自行百度修改方案。

本章主要介绍帆软应用内的主要配置文件信息及其详细说明。

2.1 外接数据库信息配置文件

1）文件位置

%FRBI_HOME%\webapps\webroot\WEB-INF\config\db.properties

2）文件内容

数据决策系统中除平台属性配置以外的所有信息，包括目录树设置、模板定时任务信息等，均存储于 FineDB 数据库。

FineReport/FineBI 支持使用内置 FineDB 数据库或启用外接 FineDB 数据库。

工程配置了外接数据库后，方在WEB-INF/config中生成一个db.properties文件。FineDB 数据库是否外接由 db.properties 文件控制。

3）文件关键信息

db.properties文件中，常见配置关键字与其内容对应关系如下。

注：为了防止修改错误导致系统出错，不建议手动修改db.properties文件。

2.2 平台配置信息

平台中有些配置信息记录在 FineDB 的 fine_conf_entity 表中，只能通过修改表字段来进行更改。

用户可通过「fine_conf_entity可视化配置插件」安全地修改相关配置。

注：请勿使用该插件以外的方法修改 FineDB 文件，有可能造成不可修复的 BUG，需自行承担后果。

可修改的配置内容及修改方式请参见：FINE_CONF_ENTITY可视化配置

建议管理员使用「健康巡检」功能，对系统进行定期巡检，确保应用所在的环境及应用内配置合理，以保证应用的正常运行。

巡检内容包括系统检查、系统运行状态、端口检查、网络检查、服务联通性检查、业务检查、环境检查、磁盘检查、非容器化部署检查、虚拟机检查。

3.1 系统检查

系统检查的检测项包括：

0110 关闭SWAP分区

1）查看当前系统中是否启用了swap分区

使用以下命令查看系统中已经启动的swap分区信息：

sudo swapon -s

如果输出结果为空，则表示当前没有启动swap分区。
2）关闭swap分区

使用以下命令关闭swap分区：

sudo swapoff -a

该命令将关闭所有已经启动的swap分区。

3）永久禁用swap分区

为了避免系统在下一次启动时自动启动swap分区，需要在系统配置文件中进行相应的修改。

以Ubuntu为例，可以按照以下步骤操作：

• 修改/etc/fstab文件，找到含有swap的行并注释掉或删除该行。

• 执行以下命令更新grub引导程序：

sudo update-grub

4）验证swap分区是否已经关闭

重启系统后，可以再次执行sudo swapon -s命令查看系统中是否存在已经启动的swap分区。

如果输出结果为空，则表示swap分区已经成功关闭。

3.2 系统运行状态

系统运行状态的检测项包括：

0204 清理文件夹

1）WEB-INF文件夹存放着什么

• FineReport：FineReport安装目录结构

2）哪些文件可清理

3）清理方式

管理员登录数据决策系统，点击「管理系统>智能运维>磁盘运维>磁盘清理」。

选择需要扫描的文件类型，点击「开始扫描」，立即开始扫描可以手动清理的冗余文件。

0212 tomcat后台运行

原因分析：

Windows系统中，tomcat容器下部署的工程，如果不使用后台模式启动，而是使用窗口模式启动，可能会因为误点窗口，导致窗口进入编辑插入状态，阻塞日志输出，从而导致工程卡死。

因此建议Windows系统中，tomcat容器下部署的工程，tomcat使用后台模式启动。

操作步骤：

先修改默认启动模式为javaw。为了防止重复启动，再添加脚本检测启动命令，按任意键即可结束脚本。

1）修改setclasspath.bat

打开%Tomcat_HOME%\bin\setclasspath.bat，找到并修改set _RUNJAVA的值：

set _RUNJAVA="%JRE_HOME%\bin\javaw.exe"

2）修改catalina.bat

打开%Tomcat_HOME%\bin\catalina.bat，在最后加上判断提示：

set ENV_VAR_VALUE=%_EXECJAVA%
echo %ENV_VAR_VALUE% | findstr /C:"javaw" >nul
if %errorlevel% equ 0 (
    echo tomcat is running in the background
    pause
)

3.3 端口检查

端口检查的检测项包括：

0301 websocket端口

WebSocket 主要用于刷新 token、用户被踢出、平台消息、内存和 CPU 显示、平台日志处当前系统在线人数、数据连接编辑状态的确定。

WebSocket 不开放影响 socket 通信，访问可能异常断开。

用户可根据自己的工程情况选择合适的 WebSocket 端口配置方法，详情请参见下表：

0302 集群端口

管理员登录数据决策平台，点击「管理系统>智能运维>集群配置」。

• 可查看集群各个节点的端口，无法使用的节点飘红。

• 可编辑节点端口，鼠标悬浮即可出现编辑按钮。

0303 宕机检测端口

管理员数据决策平台，点击「管理系统>智能运维>宕机处理」。

• 可查看宕机自动处理工具使用的端口。默认端口为12100。

• 可修改端口，点击「保存」即可。

• 可点击「测试」，测试端口可用性。

3.4 网络检查

检查文件服务器、外接数据库、状态服务器和应用之间通信是否正常，是否能够ping通，是否存在丢包情况。

3.5 磁盘检查

磁盘检查的检测项包括：

3.6 非容器化部署信息

非容器化部署的检测项包括：

3.7 环境检查

环境检查的检测项包括：

0701 vm.max_map_count

1）参数简介：

vm.max_map_count是一个Linux系统内核参数，用于控制在一个进程中允许mmap映射内存区域的最大数量。

如果该参数的值太小，那么在使用一些应用程序时，可能会出现内存映射错误。 

2）建议配置：

建议配置 vm.max_map_count 参数为 262144

3）修改方式：

• 在/etc/sysctl.conf文件中添加/修改参数值

vm.max_map_count=262144

• 运行以下命令使更改生效
  

sysctl -p

0702 最大文件打开数

1）参数简介：

open_files是指一个进程可以同时打开的文件描述符的最大数量。

文件描述符是Unix系统中用于访问文件（包括管道、套接字和其他文件操作）的唯一标识符。

2）建议配置：

建议FineReport工程的open_files参数配置不低于65536

建议FineBI工程的open_files参数配置不低于131070

3）修改方式：

• 修改参数配置

打开Linux的软硬件限制文件/etc/security/limits.conf，在文件尾部添加如下代码： 

* soft nofile 65536

* hard nofile 65536

上述命令中，hard表示系统的硬限制，soft表示用户的软限制。

• 重启工程并重新登录

配置完成后，终端用户重新登录，并重启Tomcat工程，配置方可生效。

可使用ulimit -n命令，根据返回值确认是否修改成功。

0703 overcommit_memory

1）参数简介：

vm.overcommit_memory 是一个Linux内核参数，它控制了系统是否允许进程分配超过可用内存的内存量。

当参数值为0时，内核将检查是否有足够的可用内存来满足提交的内存需求。如果有足够的空闲内存，则允许进程继续分配内存；否则分配请求将失败并返回错误。

2）建议配置：

建议vm.overcommit_memory参数配置为0

3）修改方式：

• 在/etc/sysctl.conf文件中添加/修改参数值

vm.overcommit_memory=0

• 运行以下命令使更改生效
  

sysctl -p

0704 overcommit_ratio

1）参数简介：

vm.overcommit_ratio 是一个 Linux 内核参数，它指定了系统 VMware 超大页管理器(Memory Ballooning)和 Swap 空间使用的比例。

当参数值为50时，内核使用适当的 Swap 两倍大小作为另一个备用空间，用于模拟物理内存。

2）建议配置：

建议vm.overcommit_ratio参数配置为50

3）修改方式：

• 在/etc/sysctl.conf文件中添加/修改参数值
  

vm.overcommit_ratio=50

• 运行以下命令使更改生效
  

sysctl -p

0705 gblic内存泄露相关配置

1）参数简介：

为了防止glibc中的内存泄漏，可以通过在环境变量中设置MALLOC_ARENA_MAX来限制glibc在分配和释放动态内存时使用的堆空间数量。

2）建议配置：

建议配置export MALLOC_ARENA_MAX=1

3）修改方式：

• 关闭Tomcat服务器。

• 进入%Tomcat_HOME%/bin目录，打开 startup.sh 文件。
  

• 在文件开头添加/修改行：export MALLOC_ARENA_MAX=1

• 保存对 startup.sh 文件的修改并关闭。

• 在终端中运行 startup.sh 文件，重启Tomcat并应用新的环境变量设置。

3.8 Java 虚拟机检查

Java虚拟机的检测项包括：

0801 堆外NIO内存

1）建议值

• FR：建议配置JVM NIO占用堆外内存2GB

• BI：建议配置JVM NIO占用堆外内存4GB

2）修改方式

NIO由-XX:MaxDirectMemorySize这个参数控制。请根据自身工程部署情况选择修改方法。本节展示 Tomcat 环境下设置 NIO内存 的步骤。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:MaxDirectMemorySize=2g

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:MaxDirectMemorySize=2g"

0802 堆外fineIO读内存

1）建议值

建议JVM fineIO读内存使用堆外内存设置为2G。

2）修改方式

fineIO 读内存由-Dfineio.read_mem_limit这个参数来设置。请根据自身工程部署情况选择修改方法。本节展示 Tomcat 环境下设置 fineIO读内存 的步骤。

读内存的默认单位为 GB，支持小数，但不支持使用 g、m 等。建议读内存为写内存的2-3倍，缓存大小建议与写内存大小一致。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Dfineio.read_mem_limit=2

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Dfineio.read_mem_limit=2"

0803 堆外fineIO写内存

1）建议值

建议JVM fineIO写内存使用堆外内存设置为1G。

2）修改方式

fineIO 写内存由-Dfineio.write_mem_limit这个参数来设置。请根据自身工程部署情况选择修改方法。本节展示 Tomcat 环境下设置 fineIO写内存 的步骤。

写内存的默认单位为 GB，支持小数，但不支持使用 g、m 等。建议读内存为写内存的2-3倍，缓存大小建议与写内存大小一致。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Dfineio.write_mem_limit=1

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Dfineio.write_mem_limit=1"

0804 垃圾回收器类型

1）建议值

建议 JVM 使用垃圾回收器类型为 ParallelScavenge

2）修改方式

本节以工程部署在 Tomcat 上为例， 介绍设置垃圾收集器为Parallel Scavenge（并行收集器）的方法。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:+UseParallelGC

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:+UseParallelGC"

0805 DisableExplicitGC 参数

1）建议值

建议不对 DisableExplicitGC 参数进行配置，此项配置会导致 System.gc()被禁用，影响系统稳定性。

2）修改方式

-XX:+DisableExplicitGC参数的作用是禁用 System.gc()。System.gc() 是一种保护机制，例如堆外内存满时清理它的堆内引用对象。用户需要根据实际情况选择是否使用该参数，建议删除该参数。

本节展示 Tomcat 环境下删除 DisableExplicitGC 参数的步骤。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为catalina.bat和setenv.bat的文件。

在文件中查找是否存在XX:+DisableExplicitGC，若存在，删除相关配置，修改完成后重启工程。

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为catalina.sh和setenv.sh的文件。

在文件中查找是否存在XX:+DisableExplicitGC，若存在，删除相关配置，修改完成后重启工程。

0806 JDK版本

1）建议值

建议使用「JDK8」中 1.8.0_181 及以上版本

2）检查方式

cmd 命令行进入%Tomcat_home%\bin路径下，输入version，即可查看 JDK 版本。如下图所示：

0807 headless 模式

1）建议值

建议配置 -Djava.awt.headless=true 以启用 headless 模式

2）修改方式

headless 模式是系统的一种工作模式，如果系统属性 java.awt.headless被设置true，那么headless工具包就会被使用。

本节展示 Tomcat 环境下启用 headless 模式的步骤。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Djava.awt.headless=true

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true"

0808 dump导出

1）建议值

建议配置HeapDumpOnOutOfMemoryError 及 HeapDumpPath以保证正常导出dump

2）修改方式

1）-XX:+HeapDumpOnOutOfMemoryError参数表示当JVM发生OOM时，自动生成DUMP文件。

2）-XX:HeapDumpPath=${目录}参数表示生成dump文件的路径，也可以指定文件名称，例如：-XX:HeapDumpPath=${目录}/java_heapdump.hprof。

如果不指定文件名，默认为：java_<pid>_<date>_<time>_heapDump.hprof。

本节展示 Tomcat 环境下设置dump导出的步骤。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:+HeapDumpOnOutOfMemoryError  -XX:HeapDumpPath=${目录}

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:+HeapDumpOnOutOfMemoryError  -XX:HeapDumpPath=${目录}"

0809 BytecodeRecompilationCutoff配置

0810 PerMethodRecompilationCutoff配置

1）建议值

建议recompilationCutoff相关参数配置值为-1

2）修改方式

没有配置 RecompilationCutoff 参数/配置的 RecompilationCutoff 参数太小，可能会导致 spider 引擎数据更新缓慢。

本节展示 Tomcat 环境下设置 recompilationCutoff 参数的步骤。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:PerMethodRecompilationCutoff=-1 -XX:PerBytecodeRecompilationCutoff=-1

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:PerMethodRecompilationCutoff=-1 -XX:PerBytecodeRecompilationCutoff=-1"

0811 安装包部署

注：仅FineBI系统检测该项

建议使用web容器方式部署。详情请参见：Tomcat 服务器部署

0813 codecache配置

1）建议值

FR：建议配置-XX:ReservedCodeCacheSize=512m

BI：建议配置-XX:ReservedCodeCacheSize=1024m

2）修改方式

ReservedCodeCacheSize参数是调整内存大小的一个设置参数，值的大小设置直接影响到Code Cache的大小。

如果Code Cache的空间不足，可能会导致JVM无法正常运行，导致性能持续降低。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:ReservedCodeCacheSize=250m

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:ReservedCodeCacheSize=250m"

0814 语言配置-Duser.country

0815 语言配置-Duser.language

1）建议值

建议配置-Duser.country=CN、-Duser.language=zh

2）修改方式

为了防止中文出现乱码现象，要配置好Tomcat 的语言编码。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Duser.country=CN -Duser.language=zh

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Duser.country=CN -Duser.language=zh"

0816 zip相关配置-Dsun.zip.disableMemoryMapping

1）建议值

建议配置-Dsun.zip.disableMemoryMapping=true

2）修改方式

配置该参数，可预防 jvm crash

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Dsun.zip.disableMemoryMapping=true

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Dsun.zip.disableMemoryMapping=true"

0817 堆内老年代与新生代大小比例

1）建议值

建议 JVM 老年代与新生代大小比例设置为 2

2）修改方式

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

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

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

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

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

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

0818 栈空间

1）建议值

建议单线程使用栈空间不超过1024KB

2）修改方式

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

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

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -Xms512M -Xmx1024M -Xss1024K

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -Xms2048M -Xmx8196M -Xss1024K"

0819 debug模式

1）建议值

建议取消debug模式

2）修改方式

debug模式由两个参数控制：-agentlib:jdwp 和 -Xrunjdwp，删除这两个参数即可取消debug模式

• Windows：在%Tomcat%/bin目录下的catalina.bat和setenv.bat文件中删除-agentlib:jdwp 和 -Xrunjdwp参数，配置完成后重启工程。

• Linux：在%Tomcat%/bin目录下的catalina.sh和setenv.sh文件中删除-agentlib:jdwp 和 -Xrunjdwp参数，配置完成后重启工程。

0820 堆内内存

0821 xms配置

0823 元数据空间配置

1）参数简介：

元数据空间（Metaspace）是 Java 虚拟机（JVM）用于存储类元数据的区域。在 JVM 中，元数据包括类的结构信息、方法信息、字段信息等。

元数据空间配置 MaxMetaspaceSize 用于设置元数据空间的最大大小。当元数据空间超过这个限制时，JVM 会发生垃圾回收以释放不再使用的元数据。

2）建议配置：

建议配置 MaxMetaspaceSize 参数为 2G

3）修改方式：

本节展示 Tomcat 环境下设置 MaxMetaspaceSize 的步骤。

• Windows：进入%Tomcat_HOME%\bin目录。寻找名为setenv.bat的文件。如果文件不存在，可以创建一个新的setenv.bat文件。在文件中添加以下行来设置，配置完成后重启工程。

set JAVA_OPTS=%JAVA_OPTS% -XX:MaxMetaspaceSize=2G

• Linux：进入%Tomcat_HOME%\bin目录。寻找名为setenv.sh的文件。如果文件不存在，可以创建一个新的setenv.sh文件。在文件中添加以下行来设置，配置完成后重启工程。

JAVA_OPTS="$JAVA_OPTS -XX:MaxMetaspaceSize=2G"

3.9 服务联通性检查

服务联通性检查的检测项包括：

3.10 业务检查

业务检查的检测项包括：

1001 finedb

管理员登录帆软应用，点击「管理系统>系统管理>常规>外接数据库」，将finedb迁移至更稳定的外接数据库中。

外接数据库迁移的具体操作步骤请参见：配置外接数据库 

1002 日志级别

管理员登录帆软应用，点击「管理系统>智能运维>平台日志>全局设置」。

在「系统日志级别」中设置日志级别为 info，点击「保存」即可。

日志级别设置请参见：日志简介

1003 日志清理

管理员登录帆软应用，点击「管理系统>智能运维>平台日志>全局设置」。

在「操作日志清理」中开启「自动清理」并配置清理周期小于六个月。

操作日志自动清理设置请参见：日志简介

1004 自动备份磁盘占用限制

管理员登录帆软应用，点击「管理系统>智能运维>备份还原>全局设置」。

在「自动备份」中，建议各模块自动备份可占磁盘不超过1024M。备份还原设置请参见：备份还原

1005 自动备份保留数量限制

管理员登录帆软应用，点击「管理系统>智能运维>备份还原>全局设置」。

在「自动备份」中，建议自动备份默认保存不超过5份。备份还原设置请参见：备份还原

1006 定时调度任务清理配置

管理员登录帆软应用，在「定时调度」中，对「定时调度任务>调度对象」的文件处理方式设置为「仅保留最近一次」。

定时调度任务设置请参见：定时调度任务设置

1007 内存数据行数限制

注：仅FineBI系统检测该项

管理员登录帆软应用，点击「管理系统>系统管理>常规>BI参数」 。

建议「数据访问量」参数值不超过100w。BI参数配置请参见：BI/Spider参数

1008 快速分析单元格数限制

注：仅FineBI系统检测该项

「快速分析单元格数限制」的配置信息记录在 FineDB 的 fine_conf_entity 表中。

请通过「fine_conf_entity可视化配置插件」，配置DistributedOptimizationConfig.spiderConfig.spider_fast_compute_limit_unit参数值不超过10000000

点击「保存」，并重启FineBI工程，配置生效。

1009 快速分析内存大小限制

注：仅FineBI系统检测该项

「快速分析内存大小限制」的配置信息记录在 FineDB 的 fine_conf_entity 表中。

请通过「fine_conf_entity可视化配置插件」，配置DistributedOptimizationConfig.spiderConfig.spider_fast_compute_limit_memory参数值不超过500000000

点击「保存」，并重启FineBI工程，配置生效。

1010 快速分析更新单元格数限制

注：仅FineBI系统检测该项

「快速分析更新单元格数限制」的配置信息记录在 FineDB 的 fine_conf_entity 表中。

请通过「fine_conf_entity可视化配置插件」，配置DistributedOptimizationConfig.spiderConfig.spider_update_fast_compute_limit_cell参数值不超过100000000

点击「保存」，并重启FineBI工程，配置生效。

1011 快速分析行数限制

注：仅FineBI系统检测该项

「快速分析内存大小限制」的配置信息记录在 FineDB 的 fine_conf_entity 表中。

请通过「fine_conf_entity可视化配置插件」，配置DistributedOptimizationConfig.spiderConfig.spider_fast_compute_limit_row参数值不超过10000000

点击「保存」，并重启FineBI工程，配置生效。

1012 spark计算结果内存大小限制

注：仅FineBI系统检测该项

「spark计算结果内存大小限制」的配置信息记录在 FineDB 的 fine_conf_entity 表中。

请通过「fine_conf_entity可视化配置插件」，配置DistributedOptimizationConfig.spiderConfig.spark_driver_maxResultSize参数值不超过10000000

点击「保存」，并重启FineBI工程，配置生效。

1018 sql执行时长限制

管理员登录帆软应用，点击「管理系统>智能运维>负载管理>模板限制>通用限制」。

建议开启sql执行时长限制功能。模板限制请参见：模板限制

1019 单模板单元格数限制

管理员登录帆软应用，点击「管理系统>智能运维>负载管理>模板限制>通用限制」。

建议开启单模板单元格限制功能。模板限制请参见：模板限制

1020 导入excel单元格数限制

管理员登录帆软应用，点击「管理系统>智能运维>负载管理>模板限制>通用限制」。

建议开启导入excel单元格限制功能。模板限制请参见：模板限制

1022 单数据集行数限制

管理员登录帆软应用，点击「管理系统>智能运维>负载管理>模板限制>通用限制」。

建议开启单数据集行数限制功能。模板限制请参见：模板限制

1024 脏数据检测

注：仅FineBI系统检测该项

管理员登录帆软应用，点击「BI工具>检测>脏数据」。

检测系统中的脏数据，并进行排查清理。

1026 密码强度限制检测

管理员登录帆软应用，点击「管理系统>系统管理>登录」 。

在「密码策略设置」中，建议开启「密码强度限制」，并自定义设置密码强度。

详情请参见：密码策略设置

在应用日常的正常运行过程中，维护事务相对简单，在有需要的时候能够查看应用的运行日志，或查看应用的各项监控指标是否存在异常即可

4.1 应用启停

应用日常的维护工作中，经常会需要对应用进行启停重启等操作。

• 单机环境依赖较少，无严格顺序需求。

• 集群环境相关组件较多，为尽量降低应用使用的风险，请尽量按以下顺序进行启停

4.1.1 启动顺序

由于应用的正常运行对组件有依赖，因此需要先启动相关组件，再启动应用。顺序为：

1）负载均衡组件（Nginx）

2）状态服务器组件（Redis）

3）文件服务器组件（FTP）

4）外接数据库组件（Mysql）

5）帆软应用（集群依次启动各节点即可）

各组件和应用可以配置开机自启动，便于在重启服务器后自动启动恢复服务：

• Redis集群开机自启动
  

• Redis单机开机自启动
  

• Nginx 开机自启动脚本
  

• Linux下Tomcat开机自启动

• Windows下Tomcat开机自启动

4.1.2 停止顺序

对于应用的停止顺序没有严格要求，但由于组件的关闭会直接导致应用不可用，因此建议先关闭帆软应用(kill命令避免进程残留)，再关闭各个组件

4.2 日志查看

1）内容说明

帆软应用通常涉及以下几类日志：

2）如何通过帆软功能快捷运维

帆软提供下载日志功能，管理员登录数据决策系统，点击「管理系统>智能运维>平台日志」，其中「下载日志」Tab提供相应功能。

通过此功能可实现下载指定时间的指定日志，并支持查看日志存储位置。

4.3 监控指标

1）指标说明

日常运行中，运维人员主要需要关注以下各指标是否存在异常：

2）如何通过帆软功能快捷运维

帆软提供内存管理页面，点击「管理系统>智能运维>负载管理」，其中「负载监控」Tab提供相应功能（11.0.3及之前版本叫「内存管理」及「内存监控」）

通过此功能可实现可视化查看帆软应用而非整个服务器的近期「负载曲线」、「内存曲线」和「CPU曲线」，快速了解帆软应用运行及压力状况。

帆软提供磁盘运维功能，点击「管理系统>智能运维>磁盘运维」，其中「磁盘使用情况分析」Tab提供相应功能（11.0.3及之前版本暂不支持）

通过此功能可实现可视化查看帆软应用重点相关磁盘目录的使用情况，及时避免出现磁盘不足。

5.1 异常警告

如需对帆软应用的异常及时感知，需实现对帆软应用各项指标的监控告警，实现的方案有以下几点建议：

1）如使用的是云服务器（如阿里云、华为云等），可使用云服务厂商提供的监控类云服务，对服务器的资源异常进行监控

2）自行开发实现对于帆软应用的监控，如基于promthues组件等

3）针对系统负载过高的场景，帆软提供智能预警功能，检测到负载状态过高时将提醒运维人员。

管理员登录数据决策系统，点击「管理系统>智能运维>负载管理」，其中「负载监控」内可进行智能预警配置。

4）针对系统出现宕机的场景，帆软提供宕机通知功能，检测到系统宕机时将提醒运维人员。

管理员登录数据决策系统，点击「管理系统>智能运维>宕机处理」，其中「宕机处理」内可进行宕机通知配置。

5）针对系统磁盘空间不足的场景，帆软提供磁盘预警功能，检测到应用相关磁盘空间不足时，将提醒运维人员。

管理员登录数据决策系统，点击「管理系统>智能运维>磁盘运维」，其中「磁盘预警设置」tab页内可进行磁盘预警配置。

5.2 宕机处理

当应用出现异常时，宕机可能会随之发生，此时为了业务的可用，需要快速恢复应用，同时应尽量保存宕机时刻的日志信息，方便进行宕机原因定位及风险排除，避免再次出现类似异常。对于宕机，应进行以下运维动作：

1）保证系统环境有jdk工具，当应用发生宕机时，及时导出dump文件

1. 进入到对应的jdk的bin目录

2. 以linux+tomcat为例，查看pid的方式为使用ps -ef|grep tomcat管道过滤命令，查看对应的服务器进行pid。

3. 使用命令jmap -dump:format=b,file=文件名 [pid]来生成dump。

2）自行开发对帆软应用是否存活的监控，并在发现其不可用时告知到运维人员，并通过自动化脚本重启应用，或人工进行监控及应用重启

重启或停止应用时需确保完全关闭工程相关进程，详情请参见：关闭或重启FineReport工程

3）在宕机发生后自行通过dump分析宕机原因或联系技术支持协助定位，并尽快排除宕机风险。

4）针对宕机场景，帆软提供应用存活监控功能，管理员登录数据决策系统，点击「管理系统>智能运维>宕机处理」。

通过「宕机处理」可以实现宕机消息通知，宕机日志自动导出，及宕机后自动重启恢复。

5）针对宕机定位，帆软提供宕机自助处理功能，管理员登录数据决策系统，点击「管理系统>智能运维>宕机处理」。

通过「宕机自助向导」可以对大多数的宕机原因给出分析结果并提供改进建议。

6.1 备份还原

帆软系统需要定期进行备份，以确保在用户误操作、版本回退等场景下能够及时恢复，备份及还原方式如下：

1）自行备份：

定期将完整工程拷贝并压缩后，放在磁盘空间充足的目录或其他服务器上，并定期备份工程的外接配置数据库

2）通过帆软功能进行备份还原：

• 帆软平台提供备份还原的功能，支持对「平台配置」、「报表模板」、「BI模板」、「JAR 包」、「插件」进行备份还原。

• 默认备份路径为../backup，备份文件存储在工程的%FR_HOME%/webapps/webroot/backup文件夹下，支持修改为其他备份路径，在「全局设置」中进行配置

• 备份方式分为自动及手动，手动备份即手动创建一份备份，自动备份则按照设置的自动备份「备份频率」、「份数上限」、「备份容量」、「备份失败提醒」进行定期自动备份

• 备份内容如下：

• 选择手动备份／自动备份下备份的文件，点击「还原按钮」，「确认」后即可进行还原，还原后重启服务器即可生效
  

• 不同内容还原生效的方式略有区别，详情如下表所示：

6.2 更新升级

帆软产品会持续不断的迭代更新，可能增加新的功能或针对历史版本存在的问题进行修复，为了能获得更好的功能体验，客户往往也要跟随更新版本，本章仅介绍小版本升级方式，大版本升级请联系帆软技术人员进行协助，具体更新升级方式如下：

1）决策平台管理升级（不适用于BI）：

打开数据决策系统，在「管理系统>智能运维>备份还原>更新升级」点击「立刻更新」按钮，等待更新 JAR，成功后重启 Web 服务器即可。

2）升级前需确保已进行备份操作，保证升级过程或升级后出现异常可以及时恢复可用状态不至于造成损失，备份方法可参考上一节

3）人工更新 JAR 包：用户可以获取 JAR 包后手动替换更新， linux 系统和 windows 系统下操作方式一致。

4）用户可以向帆软技术人员索要升级jar包，获取后，替换服务器工程 %TOMCAT_HOME%/webapps/webroot/WEB-INF/lib下的老jar包，重启服务器即可完成升级。

5）BI更新升级前请先运行升级工具，在决策平台中点击「BI升级」进行检测，按指导处理完成升级风险项后进行人工更新。