独立部署

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

1.1 版本

1.2 功能简介

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

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

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 修改设计器内存

FineReport 在部署后，建议修改内存参数，避免后续使用时由于内存不够宕机，详情请参见：Tomcat修改内存

2.6 启动 Tomcat 服务器

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

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

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

2.7 访问数据决策系统

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

注1：默认端口为 8080，可根据需要 修改端口配置。

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

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 中修复。