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
不建议用户环境变量配置 CATALINA_HOME 或者 TOMCAT_HOME 。
安装的 JDK 版本一定要与操作系统匹配,64 位操作系统可以安装 32 位的 JDK ,但是 FR10.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 服务器。
注:如果是 exe 安装包安装的 Tomcat,双击 %Tomcat_HOME%\bin 下的 exe 文件启动 Tomcat 服务器,如下图所示:
2.6 访问数据决策系统
访问数据决策系统也就是访问部署好的报表工程,在浏览器中输入访问地址http://localhost:8080/webroot/decision,打开决策系统配置页面,即部署成功。
注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 中修复。