帆软FineBI-Windows下Tomcat服务器独立部署安装教程
2022/06/10 09:57:45
1. 概述
Tomcat 是免费且性能相对稳定的 Web 应用服务器，在许多中小型企业中深受欢迎，本文将介绍如何将 FineBI 5.0 &5.1 部署到 Tomcat 服务器端。
1.1 版本
用户需提前下载并安装 JDK 和 Tomcat 服务器。Tomcat & JDK 安装及配置步骤请自行查阅资料。
Tomcat 版本与 JDK 版本需要与操作系统对应，Tomcat 版本、 JDK 版本与 BI 版本对应关系如下：
1.2 注意事项
同一个 Tomcat 服务器中不能部署多个 BI 工程，JDK 版本为：JDK 1.8 且小版本需在 JDK8u102 以上。
不支持 32 位的操作系统。
不支持 Tomcat 10.0 版本。
用户安装 JDK 配置环境变量时，配置 path 时，变量值建议加上%JAVA_HOME%\jre\bin
安装的 JDK 版本一定要与操作系统匹配，64 位操作系统可以安装 32 位的 JDK ，但是 FineBI 不支持这样的操作，必须保持统一。
2. 操作步骤
示例在 Windows 系统下部署步骤。
2.1 准备工作
2.1.1 确认 JDK 安装成功
调用终端命令，输入 java -version 和javac ，出现如下则表示 JDK 安装成功：
2.1.2 Tomcat 服务器已经安装成功
%Tomcat_HOME%\bin 目录下双击 startup.bat，启动 Tomcat 服务器，在浏览器输入命令http://localhost:8080，出现如下图所示的网页则表示安装成功：
2.2 拷贝 BI 工程
将%FineBI%\webapps下的 webroot 文件拷贝到%Tomcat_HOME%\webapps下，如下图所示：
注：BI 工程名 webroot 可以自定义修改，但是需要注意的是后面访问 BI 工程时地址http://ip:端口/工程名/decision中的工程名也要随之更改。
2.3 拷贝 tools.jar
将%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_home%\lib或%Tomcat_home%\webapps\webroot\WEB-INF
\lib任一位置下
注：如果不执行该操作，访问 BI 工程时，页面显示报错信息：HTTP Status 404。
2.4 配置参数
2.4.1 配置 BI 使用内存参数
FineBI 对服务器有一定的配置要求，因此需要配置内存参数保证服务器稳定，详情参见：修改 FineBI 配置参数
注：修改 FineBI 配置参数 5.1 节的 headless 参数若不配置，超管 导出 Excel 时，将会报错：无导出权限。
2.4.2 配置 dump JVM 参数
此处需要为工程配置上宕机自动生成 dump 日志的 JVM 参数，配置该参数对工程运行没有性能损耗的影响，仅用于在服务器宕机时生成 dump 日志。
进入%Tomcat%\bin目录下，编辑配置文件 catalina.bat ，增加如下 JVM 参数：
set JAVA_OPTS=%JAVA_OPTS% -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=D:\heapdump
注：其中D:\heapdump 路径表示的是宕机文件生成路径，可以根据需要修改文件路径。修改保存后，需要重启 Tomcat 才能使配置生效。
如下图所示：
2.5 启动 Tomcat 服务器
进入%Tomcat_HOME%\bin目录下双击 startup.bat，即可启动 Tomcat 服务器，如下图所示：
2.6 访问 BI 工程
在浏览器中输入访问地址http://IP:端口/webroot/decision，示例为http://localhost:8080/webroot/decision，打开 BI 工程登录页面，即部署成功，如下图所示：
3. 注意事项
3.1 0day漏洞预警
若客户遇到0day漏洞预警通知，请参见：0day漏洞说明
3.2 性能较差
问题描述
工程在 Windows 系统中部署成功后，出现卡顿问题，性能较差。
原因分析
Windwos Server 2016 及之后版本中，Windows 对控制台的功能做了一次更新，支持了更多类似于 cmd 窗口的功能。这些新增的功能，导致在 Server2016 中部署的 Tomcat 以窗口模式启动的时候，对输出到控制台的日志造成了严重的性能问题，最终导致 BI 性能卡顿。
解决方案
方案一：保留启动窗口
1）双击startup.bat后，在弹出的 Tomcat 窗口上，右键点击最上面白色栏，选择「属性」，勾选「使用旧版控制台」，点击「确定」。如下图所示
2）重启 Tomcat 工程。
方案二：禁用启动窗口
1）进入%Tomcat_HOME%\bin目录下，找到setclasspath.bat文件，将set _RUNJAVA="%JRE_HOME%\bin\java.exe"修改为set _RUNJAVA="%JRE_HOME%\bin\javaw.exe"。如下图所示：
2）保存后重启 Tomcat 工程。
注1：使用 startup.bat 启动 Tomcat， 命令窗口会一闪而过，但服务已经启动了。想要访问工程，还需等待 Tomcat 启动的时间。
注2：这种方式下，想要停止 Tomcat ，只能到任务管理器中杀 java 进程。
Tomcat 是免费且性能相对稳定的 Web 应用服务器，在许多中小型企业中深受欢迎，本文将介绍如何将 FineBI 5.0 &5.1 部署到 Tomcat 服务器端。
1.1 版本
用户需提前下载并安装 JDK 和 Tomcat 服务器。Tomcat & JDK 安装及配置步骤请自行查阅资料。
Tomcat 版本与 JDK 版本需要与操作系统对应，Tomcat 版本、 JDK 版本与 BI 版本对应关系如下：
1.2 注意事项
同一个 Tomcat 服务器中不能部署多个 BI 工程，JDK 版本为：JDK 1.8 且小版本需在 JDK8u102 以上。
不支持 32 位的操作系统。
不支持 Tomcat 10.0 版本。
用户安装 JDK 配置环境变量时，配置 path 时，变量值建议加上%JAVA_HOME%\jre\bin
安装的 JDK 版本一定要与操作系统匹配，64 位操作系统可以安装 32 位的 JDK ，但是 FineBI 不支持这样的操作，必须保持统一。
2. 操作步骤
示例在 Windows 系统下部署步骤。
2.1 准备工作
2.1.1 确认 JDK 安装成功
调用终端命令，输入 java -version 和javac ，出现如下则表示 JDK 安装成功：
2.1.2 Tomcat 服务器已经安装成功
%Tomcat_HOME%\bin 目录下双击 startup.bat，启动 Tomcat 服务器，在浏览器输入命令http://localhost:8080，出现如下图所示的网页则表示安装成功：
2.2 拷贝 BI 工程
将%FineBI%\webapps下的 webroot 文件拷贝到%Tomcat_HOME%\webapps下，如下图所示：
注：BI 工程名 webroot 可以自定义修改，但是需要注意的是后面访问 BI 工程时地址http://ip:端口/工程名/decision中的工程名也要随之更改。
2.3 拷贝 tools.jar
将%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_home%\lib或%Tomcat_home%\webapps\webroot\WEB-INF
\lib任一位置下
注：如果不执行该操作，访问 BI 工程时，页面显示报错信息：HTTP Status 404。
2.4 配置参数
2.4.1 配置 BI 使用内存参数
FineBI 对服务器有一定的配置要求，因此需要配置内存参数保证服务器稳定，详情参见：修改 FineBI 配置参数
注：修改 FineBI 配置参数 5.1 节的 headless 参数若不配置，超管 导出 Excel 时，将会报错：无导出权限。
2.4.2 配置 dump JVM 参数
此处需要为工程配置上宕机自动生成 dump 日志的 JVM 参数，配置该参数对工程运行没有性能损耗的影响，仅用于在服务器宕机时生成 dump 日志。
进入%Tomcat%\bin目录下，编辑配置文件 catalina.bat ，增加如下 JVM 参数：
set JAVA_OPTS=%JAVA_OPTS% -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=D:\heapdump
注：其中D:\heapdump 路径表示的是宕机文件生成路径，可以根据需要修改文件路径。修改保存后，需要重启 Tomcat 才能使配置生效。
如下图所示：
2.5 启动 Tomcat 服务器
进入%Tomcat_HOME%\bin目录下双击 startup.bat，即可启动 Tomcat 服务器，如下图所示：
2.6 访问 BI 工程
在浏览器中输入访问地址http://IP:端口/webroot/decision，示例为http://localhost:8080/webroot/decision，打开 BI 工程登录页面，即部署成功，如下图所示：
3. 注意事项
3.1 0day漏洞预警
若客户遇到0day漏洞预警通知，请参见：0day漏洞说明
3.2 性能较差
问题描述
工程在 Windows 系统中部署成功后，出现卡顿问题，性能较差。
原因分析
Windwos Server 2016 及之后版本中，Windows 对控制台的功能做了一次更新，支持了更多类似于 cmd 窗口的功能。这些新增的功能，导致在 Server2016 中部署的 Tomcat 以窗口模式启动的时候，对输出到控制台的日志造成了严重的性能问题，最终导致 BI 性能卡顿。
解决方案
方案一：保留启动窗口
1）双击startup.bat后，在弹出的 Tomcat 窗口上，右键点击最上面白色栏，选择「属性」，勾选「使用旧版控制台」，点击「确定」。如下图所示
2）重启 Tomcat 工程。
方案二：禁用启动窗口
1）进入%Tomcat_HOME%\bin目录下，找到setclasspath.bat文件，将set _RUNJAVA="%JRE_HOME%\bin\java.exe"修改为set _RUNJAVA="%JRE_HOME%\bin\javaw.exe"。如下图所示：
2）保存后重启 Tomcat 工程。
注1：使用 startup.bat 启动 Tomcat， 命令窗口会一闪而过，但服务已经启动了。想要访问工程，还需等待 Tomcat 启动的时间。
注2：这种方式下，想要停止 Tomcat ，只能到任务管理器中杀 java 进程。