1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
1.2 应用场景
Tomcat 是免费且性能相对稳定的 Web 应用服务器，在许多中小型企业中深受欢迎。
1.3 功能简介
本文介绍在 Windows 系统中，如何将 FineReport 工程部署到 Tomcat 容器中。
注：
相比于Windows系统，Linux在稳定性、安全性、可定制性和可靠性等方面的优势，使得它成为推荐的最佳选择。
因此推荐在Linux系统部署FineReport正式工程：Linux下Tomcat独立部署FineReport工程
1.4 注意事项
本文以 Windows+JDK1.8+Tomcat9.0.44 为例进行演示，其他版本命令可能略有区别，请自行处理。
用户需要提前在 Windows 系统下安装 JDK 和 Tomcat，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。
同一个 Tomcat 服务器中不能部署多个 FineReport 工程。
JDK 版本需为 1.8 且小版本需在 JDK8u102 以上。
不支持 Tomcat 10.0 版本。
2. 环境搭建
用户需要提前在 Windows 系统下安装 JDK 和 Tomcat，具体的安装方法可以自行查阅资料，技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「用户数」维度，准备合适的服务器环境：单机工程部署支持环境及配置
2.2 安装JDK
独立部署时，用户需要单独准备 JDK 。
| 操作步骤 | 说明 |
|---|---|
| 版本要求 | 支持JDK 1.8 且小版本需在 JDK8u102 以上 安装的 JDK 版本一定要与操作系统匹配，64 位操作系统可以安装 32 位的 JDK ，但是 FineReport 不支持这样的操作，必须保持统一 |
| 下载JDK | 下载链接：JDK 将下载的 JDK 安装包上传到 Windows 服务器 |
| 安装JDK | 安装教程请参考 JDK 官方文档 示例：将安装包解压到/data目录即可 |
2.3 安装Tomcat
独立部署时，用户需要单独准备 Tomcat 。
| 操作步骤 | 说明 |
|---|---|
| 版本要求 |
|
| 下载Tomcat | 下载链接：Tomcat ，请选择「Windows zip」，将下载的Tomcat 安装包上传到 Windows 服务器
|
| 安装Tomcat | 安装教程请参考 Tomcat 官方文档 示例语句：Tomcat安装包解压到/data目录 同一个 Tomcat 服务器中不能部署多个 FineReport 工程。 |
3. 部署步骤
3.1 获取工程文件
1）付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式：服务平台>在线支持。
2）免费用户请参考 设计器安装，安装设计器后，%FR_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 拷贝工程文件
1）压缩上一节的webroot 文件夹。
2）将压缩包上传至服务器%Tomcat_HOME%\webapps目录下。
3）解压压缩包。
3.3 参数配置（选做）
FineReport工程部署到应用服务器上时，对应用服务器有一定的配置要求。
如果应用服务器不能满足工程使用时，会出现宕机风险。
建议在启动 Tomcat 服务器前，对参数进行配置，详情请参见：运维监控指导手册 。
注：重点是「Java 虚拟机检查」相关的配置项，其他内容建议在启动工程后逐一确认。
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 访问FineReport系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineReport初始化配置页面，即部署成功。如下图所示：
注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
Tomcat 默认端口号为 8080，工程名默认为webroot。
注2：平台登录的用户名和密码是3.1节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。
4. 注意事项
部署常见问题请参见：Tomcat部署问题汇总
问题描述
工程在 Windows 系统中部署成功后，出现卡顿问题，性能较差。
原因分析
Windwos Server 2016 及之后版本中，Windows 对控制台的功能做了一次更新，支持了更多类似于 cmd 窗口的功能。
这些新增的功能，导致在 Server2016 中部署的 Tomcat 以窗口模式启动的时候，对输出到控制台的日志造成了严重的性能问题，最终导致性能卡顿。
解决方案一：保留启动窗口
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 进程。
