1. 版本
报表服务器版本 | 系统版本 | 服务器版本 | JDK 版本 |
---|---|---|---|
11.0 | Windows10 | Resin-4.0.58 | JDK 1.8 且小版本需在 JDK8u102 以上 |
注1:以上版本信息只是示例的环境配置,用户可根据自己的实际应用场景选择不同的版本。
注2:该方法只适用于 Resin4 版本部署,低版本需要升级到 Resin4。
2. 环境搭建
用户需要提前在 Windows 系统下安装 JDK 和 Resin,具体的安装方法可以自行查阅资料,技术支持不负责解答环境搭建部分的内容。
2.1 准备服务器
请根据工程「用户数」维度,准备合适的服务器环境:单机工程部署支持环境及配置
2.2 安装JDK
独立部署时,用户需要单独准备 JDK 。
1)下载安装JDK
操作步骤 | 说明 |
---|---|
版本要求 | 支持JDK 1.8 且小版本需在 JDK8u102 以上 安装的 JDK 版本一定要与操作系统匹配,64 位操作系统可以安装 32 位的 JDK ,但是 FineReport 不支持这样的操作,必须保持统一 |
下载JDK | 下载链接:JDK 将下载的 JDK 安装包上传到 Windows 服务器 |
安装JDK | 安装教程请参考 JDK 官方文档 示例:将安装包解压到/data目录即可 |
2)检查JDK是否安装成功
按住「Win+R」键,输入「cmd」,调用命令终端。
输入 java -version 和javac ,出现如下则表示 JDK 安装成功:
2.3 安装Resin
操作步骤 | 说明 |
---|---|
版本要求 | Resin-4.0.58及以上 |
下载Resin | 下载链接:Resin |
安装Resin | 安装教程请参考 Resin 官方文档 以 Resin-4.0.58 为例,将其解压到某个文件夹下。 |
3. 部署步骤
3.1 获取工程文件
1)付费用户请联系帆软技术支持获取对应版本 webroot 工程文件。技术支持联系方式:服务平台>在线支持。
2)免费用户请参考 设计器安装,安装设计器后,%FR_HOME%\webapps目录下的 webroot 文件夹即为所需的工程文件。
3.2 拷贝工程
1)压缩上一节webroot 文件夹。
2)将压缩包上传至Resin服务器%Resin_HOME%\webapps目录下。
3)解压压缩包。
3.3 修改配置文件 resin.xml
用文本编辑器打开%Resin_HOME%\conf\resin.xml,在 system-property 标签下添加两个配置项:
<javac compiler="javac" args="-encoding utf-8"/>
<character-encoding>utf-8</character-encoding>
如下图所示:
3.4 覆盖 JAR 包文件
1)下载 ZoneInfoProvider.class 和 ZoneInfoProvider$1.class 文件。
2)使用 WINRAR 打开Resin_HOME%\webapps\webroot\WEB-INF\lib下的 fine-cbb-11.0.jar
3)将下载的文件上传覆盖fine-cbb-11.0.jar/com/fr/third/joda/time/tz路径下的同名文件。如下图所示:
注:11.0.3之前的工程,这两个文件存放在Resin_HOME%\webapps\webroot\WEB-INF\lib下的fine-third-11.0.jar里。
3.5 启动Resin
1)双击Resin_HOME%\resin.exe,启动 Resin 服务器。
3.6 访问FineReport系统
在浏览器中输入访问地址http://IP:端口号/工程名/decision,打开FineReport初始化配置页面,即部署成功。如下图所示:
注1:访问地址由「服务器 IP+ 端口 + 工程文件名 +decision」组成。
默认端口号为 8080,工程名默认为webroot。
注2:平台登录的用户名和密码是3.1节拷贝的工程的。若该工程从未登录过,则直接进入初始化配置界面。
4. 注意事项
Resin 在部署工程时,会编译 classes 文件夹下的所有 Java 文件,可能会遇到如下图编码格式或 Java 文件引入的包不存在的问题,删除掉报错的 Java 文件即可。