历史版本39 :Windows下Tomcat独立部署FineReport工程 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

在线视频学习请查看:Tomcat 服务器部署

1.1 版本

Tomcat 版本JDK 版本 

推荐使用 Tomcat8.5.57 及以上版本,或者 Tomcat8 最新版本

注:使用推荐版本可减少因 Tomcat 版本过低导致的安全问题。

支持Tomcat7.0~9.0 版本

不支持 Tomcat10.0 版本

JDK 1.8 且小版本需在 JDK8u102 以上

1.2 功能简介

独立部署需要用户自行下载并安装 JDK 和 Web 应用服务器来配置部署的环境,再将 FineReport 的报表工程拷贝到 Web 应用服务器下。

这篇文档以在 Windows 系统中 Tomcat 服务器的独立部署为例,详细介绍独立部署的操作步骤。

2. 操作步骤编辑

2.1 环境配置

用户需提前下载并安装 JDK 和 Tomcat 服务器,下载和安装方法可以自行查阅相关资料。需注意以下几点:

  • JDK 需要配置好环境变量,否则下面进行部署时会报错。

  • Windows 系统中,用户安装 JDK 配置环境变量时,配置 path 时,变量值建议加上%JAVA_HOME%\jre\bin 

  • 用户环境若安装多个 Tomcat ,不建议用户环境变量配置 CATALINA_HOME 或者 TOMCAT_HOME 。否则不论用户启动哪个 Tomcat ,启动的都是 CATALINA_HOME 指定的那个。

  • 安装的 JDK 版本一定要与操作系统匹配,64 位操作系统可以安装 32 位的 JDK ,但是 FR11.0 不支持这样的操作,必须保持统一。

2.2 拷贝报表工程

%FR_HOME%\webapps下的 webroot 文件夹拷贝到%Tomcat_HOME%\webapps下。

注:报表工程名 webroot 可以自定义修改,但是需要注意的是后面访问决策系统时地址http://ip:端口/工程名/decision中的工程名也要随之更改。

2.3 拷贝 tools.jar

%JAVA_HOME%\jdk\lib下的 tools.jar 拷贝到%Tomcat_HOME%\lib%Tomcat_HOME%\webapps\webroot\WEB-INF\lib下,详细内容参见文档:服务器部署引入 tools.jar

2.4 检查端口是否被占用

若 Windows 系统中有多个 Tomcat 同时运行,需要确认默认的 8080 端口号是否被占用;若 Windows 系统之前没有部署过工程,可忽略该节内容。

1)检查端口是否被占用:端口占用查看

2)若被占用,需要修改 Tomcat 端口号,具体方法请参见 Tomcat 端口配置

2.5 启动 Tomcat 服务器

压缩包安装的 Tomcat,执行%Tomcat_HOME%\bin下的 startup.bat 或 startup.sh 文件,启动 Tomcat 服务器。

以 Windows 系统为例,双击 startup.bat,启动 Tomcat 服务器。

Snag_3d557a2.png

注:如果是 exe 安装包安装的 Tomcat,双击 %Tomcat_HOME%\bin 下的 exe 文件启动 Tomcat 服务器,如下图所示:

Snag_3fe4fbb.png

2.6 访问数据决策系统

访问数据决策系统也就是访问部署好的报表工程,在浏览器中输入访问地址http://localhost:8080/webroot/decision,打开决策系统配置页面,即部署成功。

1558595032796925.png

注1:默认端口为 8080,可根据需要 修改端口配置

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

3. 注意事项编辑

3.1 内存不足

问题报错:配置管理员密码出错Java heap space

原因分析:表示 Tomcat 的内存不足,需修改Tomcat 内存配置。

解决方案:修改内存的方法参见文档:Java heap space

3.2 7.0.100 版本的 Tomcat 特性

7.0.100 版本的 Tomcat 需要将 web.xml 放到%Tomcat_HOME%\webapps\webroot\WEB-INF下,否则会报错。

文件请参见:web.xml

注:该 Tomcat 的 bug 已经在 7.0.103 中修复。