最新历史版本 :Tomcat设置报表工程访问路径 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

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 。

操作步骤
说明
版本要求

  • 支持tomcat8.0（不支持 Tomcat 8.0.32 版本）

  • 支持tomcat9.0

  • 不支持tomcat10.0

下载Tomcat

下载链接：Tomcat ，请选择「Windows zip」，将下载的Tomcat 安装包上传到 Windows 服务器

  • tar.gz 是 Linux 系统安装文件

  • 32-bit Windows zip 是 Window32 位安装包

  • 64-bit Windows zip 是 Window64 位安装包

安装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 文件夹路径

1638166255824292.png

3.3 检查冗余工程

%Tomcat_HOME%\webapps下不能有 FineReport 工程的 webroot 文件夹，否则会导致工程二次加载，工程资源互相占用。包括并不限于的影响：

  • 模板文件保存失败，模板文件后缀加上了.tmp，甚至模板文件丢失。

  • 工程注册信息里提示：注册文件被另一台服务器占用。

19.png

3.4 启动Tomcat

1）进入%Tomcat_HOME%\bin目录。

2）双击startup.bat或startup.sh文件，启动 Tomcat 服务器。

注：如果在2.3节安装Tomcat时，使用exe安装包而非zip压缩包进行安装。

      此时需要双击 %Tomcat_HOME%\bin目录下的 Tomcat.exe文件启动 Tomcat 服务器。

21.png

3.5 访问数据决策系统

在浏览器中输入访问地址http://IP:端口号/工程名/decision，打开FineReport初始化配置页面，即部署成功。如下图所示：

注1：访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。

      Tomcat 默认端口号为 8080，工程名默认为webroot。本文示例的工程名为FR。

注2：平台登录的用户名和密码是3.1节拷贝的工程的。若该工程从未登录过，则直接进入初始化配置界面。

31.png