1. 概述编辑
1.1 版本
| FineBI服务器版本 | 功能变更 |
|---|---|
| 6.0 | - |
1.2 应用场景
Tomcat 是免费且性能相对稳定的 Web 应用服务器，在许多中小型企业中深受欢迎。
1.3 功能简介
本文介绍在Windows系统中，如何将 FineBI 工程部署到 Tomcat 容器中。
1.4 注意事项
同一个 Tomcat 服务器中不能部署多个 BI 工程
JDK 版本需为 1.8 且小版本需在 JDK8u102 以上。
不支持 32 位的操作系统。
不支持 Tomcat 10.0 版本。
2. 部署步骤编辑
2.1 准备服务器
请根据工程「数据量」和「用户数」维度，准备合适的服务器环境：FineBI服务器配置推荐
不支持部署在 Windows32 位操作系统上。
2.2 安装JDK
独立部署时，用户需要单独准备 JDK 。
1）下载安装JDK
| 操作步骤 | 说明 |
|---|---|
| 版本要求 | 支持JDK 1.8 且小版本需在 JDK8u102 以上 由于 FineBI 不支持 32 位操作系统，请务必下载 64 位的JDK |
| 下载JDK | 下载链接：JDK |
| 安装JDK | 安装教程请参考 JDK 官方文档 用户安装 JDK 配置环境变量时，配置 path 时，变量值建议加上%JAVA_HOME%\jre\bin |
2）检查JDK是否安装成功
按住「Win+R」键，输入「cmd」，调用命令终端。
输入 java -version 和javac ，出现如下则表示 JDK 安装成功：
2.3 安装Tomcat
独立部署时，用户需要单独准备 Tomcat 。
1）下载安装Tomcat
| 操作步骤 | 说明 |
|---|---|
| 版本要求 |
|
| 下载Tomcat | 下载链接：Tomcat ，请选择「64-bit Windows zip」
|
| 安装Tomcat | 安装教程请参考 Tomcat 官方文档
|
2）检查Tomcat是否安装成功
%Tomcat_HOME%\bin 目录下双击 startup.bat，启动 Tomcat 服务器，在浏览器输入命令http://localhost:8080，出现如下图所示的网页则表示安装成功：
注：平台自带的日志管理不能清理%TOMCAT_HOME%/logs文件夹下的日志文件，catalina.out 文件长久运行会占用很大磁盘空间，建议定时清理 catalina.out 文件。
2.4 拷贝FineBI工程
将 webroot 文件夹拷贝到%Tomcat_HOME%\webapps下，如下图所示：
注1：webroot 文件夹，可通过 FineBI 试用安装 后，在安装目录%FineBI%\webapps下获取。
注2：webroot 文件夹名称，即为 FineBI 工程名。
用户可以自定义修改。后面访问 BI 工程时，地址「http://ip:端口/工程名/decision」中的工程名也要随之更改。
2.5 拷贝tools.jar
将2.2节JDK安装目录%JAVA_HOME%\jdk\lib下的 tools.jar，拷贝到%Tomcat_HOME%\lib和%Tomcat_HOME%\webapps\工程名\WEB_INF\lib下。
注：如果不执行该操作，访问 BI 工程时，页面显示报错信息：HTTP Status 404。
2.6 配置内存参数
FineBI 对服务器有一定的配置要求，因此需要配置内存参数保证服务器稳定。详情请参见：修改 FineBI 配置参数
注：修改 FineBI 配置参数中的 headless 参数若不配置，超管 导出 Excel 时，将会报错：无导出权限。
2.7 配置JVM参数
1）应用场景：
为了对Tomcat服务器进行运维管理，建议配置自动生成 dump 日志的 JVM 参数。
配置该参数对工程运行没有性能损耗的影响，仅用于在服务器宕机时生成 dump 日志。
2）操作方法：
进入%Tomcat%\bin目录下，编辑配置文件catalina.bat，增加JVM 参数。修改后，重启 Tomcat 生效。
set JAVA_OPTS=%JAVA_OPTS% -server -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=D:\heapdump
注：D:\heapdump 路径表示的是宕机文件生成路径，可自行修改调整。
如下图所示：
2.8 启动 Tomcat 服务器
双击%Tomcat_HOME%\bin目录下的startup.bat文件，即可启动 Tomcat 服务器，如下图所示：
2.9 访问FineBI工程
在浏览器中输入访问地址http://IP:端口/webroot/decision，示例为http://localhost:8080/webroot/decision，打开FineBI工程登录页面，即部署成功，如下图所示：
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 进程。