1. 概述
1.1 版本
| FineReport 版本 |
|---|
| 11.0 |
1.2 问题描述
在 独立部署 中介绍了通过将报表工程放置在 Tomcat 服务器指定位置来进行部署。
但有的用户为了服务器上文件的有效管理，需要将报表目录放在特定的位置，而不将报表文件夹拷贝到 Tomcat 服务器安装目录%Tomcat_HOME%\webapps下。
1.3 解决思路
创建 FR.xml 文件并放在指定位置，即可实现报表工程不放在服务器安装目录下，也可以进行部署。
本文以 Windows+JDK1.8+Tomcat9.0.44 为例进行演示，其他版本命令可能略有区别，请自行处理。
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）点击跳转至服务器部署包下载地址：服务器部署包
2）在「其他下载>服务器部署版」下，根据自身系统，选择下载对应版本的服务器部署包。如下图所示：
3）将下载后的部署包解压至某个目录下，%Tomcat_HOME%\tomcat-win64\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 创建xml文件
1）本节示例路径
webroot 文件夹所在路径为：F:\FineReport_11.0\webapps\webroot
Tomcat 工程路径为：E:\tomcat-win64FR
2）进入%Tomcat_Home%\conf\Catalina\localhost目录，如果没有 Catalina 文件夹，直接新建即可。
3）新建文件 FR.xml（FR 为访问链接http://ip:端口/工程名/decision中的工程名），内容如下：
<Context path="/FR" reloadable="false" docBase="F:\FineReport_11.0\webapps\webroot" />
文件可下载解压自行修改获取：FR.zip
| path | 值为「/xml 文件的名称」 |
|---|---|
| docBase | 所安装 FineReport 工程的 webroot 文件夹路径 |
3.3 检查冗余工程
%Tomcat_HOME%\webapps下不能有 FineReport 工程的 webroot 文件夹，否则会导致工程二次加载，工程资源互相占用。包括并不限于的影响：模板文件保存失败，模板文件后缀加上了.tmp，甚至模板文件丢失。
工程注册信息里提示：注册文件被另一台服务器占用。
3.4 启动Tomcat
1）进入%Tomcat_HOME%\bin目录。
2）双击startup.bat或startup.sh文件，启动 Tomcat 服务器。
注：如果在2.3节安装Tomcat时，使用exe安装包而非zip压缩包进行安装。
此时需要双击 %Tomcat_HOME%\bin目录下的 Tomcat.exe文件启动 Tomcat 服务器。
3.5 访问数据决策系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineReport初始化配置页面，即部署成功。如下图所示：
注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
Tomcat 默认端口号为 8080，工程名默认为webroot。本文示例的工程名为FR。
注2：平台登录的用户名和密码是3.1节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。
上一篇：JBoss服务器端口号修改
