1. 概述
1.1 版本
| FineBI服务器版本 | 功能变更 |
|---|---|
| 6.0 | - |
1.2 应用场景
Tomcat 是免费且性能相对稳定的 Web 应用服务器，在许多中小型企业中深受欢迎。
1.3 功能简介
本文介绍在Windows系统中，如何将 FineBI 工程部署到 Tomcat 容器中。
注：
相比于传统部署架构，容器化部署具有隔离性、可移植性、灵活性、可伸缩性和可控性等优点，可大幅降低企业的维护成本和资源成本。
相比于Windows系统，Linux在稳定性、安全性、可定制性和可靠性等方面的优势，使得它成为推荐的最佳选择。
因此推荐在Linux系统使用更具优势的容器化部署方案部署FineReport正式工程：部署新项目-FineBI
1.4 注意事项
同一个 Tomcat 服务器中不能部署多个 BI 工程
JDK 版本需为 1.8 且小版本需在 JDK8u102 以上。
不支持 32 位的操作系统。
不支持 Tomcat 10.0 版本。
2. 环境搭建
用户需要提前在 Windows 系统下安装 JDK 和 Tomcat，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「数据量」和「用户数」维度，准备合适的服务器环境：单机工程部署支持环境及配置
不支持部署在 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 文件。
3. 部署步骤
3.1 获取工程文件
1）付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式：服务平台>在线支持。
2）免费用户请参考 FineBI安装与启动，安装本地FineBI后，%BI_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 拷贝工程文件
1）压缩上一节的 webroot 文件夹。
2）将压缩包上传至服务器%Tomcat_HOME%\webapps目录下。
3）解压压缩包。
3.3 参数配置（选做）
FineBI工程部署到应用服务器上时，对应用服务器有一定的配置要求。
如果应用服务器不能满足工程使用时，会出现宕机风险。
建议在启动 Tomcat 服务器前，对参数进行配置，详情请参见：运维监控指导手册 。
注：重点是「Java 虚拟机检查」相关的配置项以及「设置 dump JVM 参数」，其他内容建议在启动工程后逐一确认。
3.4 修改端口号（选做）
若 Tomcat 系统中有多个 Tomcat 同时运行，需要确认默认的 8080 端口号是否被占用；若服务器之前没有部署过工程，可忽略该节内容。
1）使用语句查看默认的 8080 端口号是否被占用。
netstat -aon|findstr "8080"
2）若被占用，需要修改 Tomcat 端口号。详情请参见 修改Tomcat端口号
3.5 启动Tomcat
1）进入%Tomcat_HOME%\bin目录。
2）双击startup.bat或startup.sh文件，启动 Tomcat 服务器。
注：如果在2.3节安装Tomcat时，使用exe安装包而非zip压缩包进行安装。
此时需要双击 %Tomcat_HOME%\bin目录下的 Tomcat.exe文件启动 Tomcat 服务器。
3.6 访问FineBI系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineBI初始化配置页面，即部署成功。如下图所示：
注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
Tomcat 默认端口号为 8080，工程名默认为webroot。
注2：平台登录的用户名和密码是3.2节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。
4. 注意事项
问题描述
工程在 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 进程。
