FineReport升级指南

编辑
  • 文档创建者:文档助手1
  • 浏览次数:72889次
  • 编辑次数:63次
  • 最近更新:Leo.Tsai 于 2019-12-06
  • 1. 概述

    1.1 功能简介

    为满足客户的新需求以及完善之前版本某些功能的不足之处,我们的产品在不断地更新迭代。

    若需要修复之前版本中存在的一些问题及增加新的产品功能,就需要用户升级到当前最新版本。

    FineReport 10.0 内置一键升级的功能,升级更为方便。

    1.2 升级逻辑

    1)FineReport 9.0 与 10.0 版本之间没有内置升级功能,用户可通过升级工具完成。

    2)JAR 包在 2019-12-05 前的 10.0 设计器,与JAR 包在 2019-12-05 后的设计器,两者的更新升级逻辑不同。

    • 老版本的更新升级逻辑不够灵活,当需要增删 JAR 包时,只能手动去进行升级操作,提高了维护的成本。

    • 新版本的更新升级逻辑,支持更加灵活的更新配置,如 JAR 包的添加、删除

    2. 9.0 升级 10.0

    为了帮助用户更顺利的从 9.0 升级到 10.0 版本,我们特提供一个独立的辅助升级程序,可以将 9.0 的 Web 工程升级到 10.0 工程,包括 JAR 包、各类配置文件、FineDB 数据表等文件的兼容升级。 

    该辅助升级工具无需安装,即点即用,简单方便。具体可参考:9-10 升级工具

    注:升级工具目前只支持 jdk1.8,用户在升级时要确保自己的 jdk 为 1.8 版本。

    3. JAR 包在 2019-12-05 前的升级

    3.1 设计器升级

    3.1.1 方法一:在线更新 JAR 包

    打开设计器,点击菜单帮助>更新升级,在最新 JAR 一栏会出现新版本号,下方会有更新按钮,如下图所示:

    注:远程设计状态下不支持「更新升级」功能。

    1573804614780236.png

    按照提示更新,下方显示下载 JAR 包进度:

    1573804686396995.png

    等待准备工作完成,点击立即重启

    重启之后最新 JAR 一栏显示为「已经是最新版本」,即完成 10.0 版本更新。

    3.1.2 方法二:人工更新 JAR 包

    向 FineReport 技术人员索要 13 个的升级 JAR 包:

    fine-accumulator-10.0.jarfine-activator-10.0.jarfine-core-10.0.jarfine-datasource-10.0.jarfine-decision-10.0.jarfine-decision-report-10.0fine-report-designer-10.0.jarfine-report-engine-10.0.jarfine-schedule-10.0.jarfine-schedule-report-10.0.jarfine-swift-log-adaptor-10.0.jarfine-third-10.0.jarfine-webui-10.0.jar

    1)fine-report-designer-10.0:这一个 JAR 包含 FineReport 设计器的所有功能,必须更新,存放在 %FR_Home%/lib 下:

    1573808479941718.png

    2)其余 JAR 包:升级到版本的时候,需要将剩下的 12 个 JAR 包放到 %FR_Home%/webapps/webroot/WEB-INF/lib下:

    1573808533756825.png

    注:更新 JAR 包后需要重启设计器才会生效,而且 JAR 包所放位置不能放错,否则会导致不能打开设计器。

    3.1.3 方法三:决策平台管理升级

    管理系统>智能运维>备份还原>更新升级点击立刻更新按钮,等待更新 JAR,成功后重启服务器即可

    1574047261715690.png

    3.2 服务器升级

    3.2.1 方法一:人工更新 JAR 包

    向 FineReport 技术人员索要单独的12个升级包:

    fine-accumulator-10.0.jar、fine-activator-10.0.jar、fine-core-10.0.jar、fine-datasource-10.0.jar、fine-decision-10.0.jar、fine-decision-report-10.0.jar、fine-report-engine-10.0.jar、fine-schedule-10.0.jar、fine-schedule-report-10.0.jar、fine-swift-log-adaptor-10.0.jar、fine-third-10.0.jar、fine-webui-10.0.jar

    将这12个 JAR 包放到%TOMCAT_HOME%/webapps/webroot/WEB-INF/lib下,重启服务器即可。

    注1:以 Tomcat 服务器 为例,在 Linux 中,要先./shutdown.sh,然后用ps -ef|grep tomcat命令来查看系统中是否还有 Tomcat的进程,如果有的话,要先kill -9进程号 干净,然后./startup.sh

    注2:注:2019-12-05及之后版本的 JAR 包可正常使用 shutdown 完全清理所有进程。

    3.2.2 方法二:安装设计器后拷贝 JAR 包

    安装最新版本设计器,然后拷贝安装目录下其位置处的包替换要升级服务器下的包,即可进行升级。

    注1:更新 JAR 包后需要重启服务器如 Tomcat 才会生效。并且需要保证服务器上和设计器上的 JAR 的版本一致,否则可能会导致某些模板在本地看的效果是正确的,但是放在服务器下面的时候就出问题了。

    注2:在进行版本升级时请先查看 升级兼容性,有的版本升级时的方式可能会有所差异,大体不变。

    3.2.3 方法三:决策平台管理升级

    管理系统>智能运维>备份还原>更新升级点击立刻更新按钮,等待更新 JAR,成功后重启 Web 服务器即可。

    1574047261715690.png

    4. JAR 包在 2019-12-05 后的升级

    4.1 设计器升级

    4.1.1 直接更新升级

    打开设计器,点击菜单帮助>更新升级,在最新 JAR 一栏会出现新版本号,下方会有更新按钮,如下图所示:

    注:远程设计状态下不支持「更新升级」功能。

    1573804614780236.png

    触发更新后,系统提示保存重要信息,如下图所示:

    1574047917352123.png

    设计器更新时由于要获取比对 JS 并解析,会出现几秒的延迟,获取更新信息中,如下图所示:

    1574047822886239.png

    按照提示更新,下方显示下载 JAR 包进度,如下图所示:

    1573804686396995.png

    等待准备工作完成,系统将立即自动重启。

    重启之后最新 JAR 一栏显示为「已经是最新版本」,即完成 10.0 版本更新。

    4.1.2 插件管理触发升级

    当打开新插件管理器时,如下图所示:

    1574048018660955.png

    点击服务器,插件管理,若检测到 jxbrowser 的 JAR 包不存在,则弹出强制升级提示框,如下图所示:

    1574048166531223.png

    点击确定或关闭提示框,将跳转至更新升级界面,后续升级步骤如4.1.1章节所示。

    4.2 服务器升级

    打开数据决策系统,在管理系统>智能运维>备份还原>更新升级点击立刻更新按钮,等待更新 JAR,成功后重启 Web 服务器即可。

    1574047261715690.png

    附件列表


    主题: 快速入门
    标签: 暂无标签
    如果您认为本文档还有待完善,请编辑

    文档内容仅供参考,如果你需要获取更多帮助,付费/准付费客户请咨询帆软技术支持
    关于技术问题,您还可以前往帆软社区,点击顶部搜索框旁边的提问按钮
    若您还有其他非技术类问题,可以联系帆软传说哥(qq:1745114201

    此页面有帮助吗?只是浏览 [ 去社区提问 ]