反馈已提交

网络繁忙

10-11 升级工具

  • 文档创建者:Catqiu
  • 编辑次数:13次
  • 最近更新:Carly 于 2021-11-26
  • 1. 概述

    本文通过一个独立的辅助升级程序,可以将 10.0 的 Web 工程升级到 11.0 工程,包括 JAR 包、插件、各类配置文件、FineDB 数据表等的兼容升级。

    1)提供免安装版程序,点击即可运行,无需安装卸载。

    2)程序支持简体中文、英文、繁体中文。

    3)支持 Windows、Linux 主流操作系统

    注1:升级前请先仔细阅读:10-11 兼容说明

    注2:已获取授权的 10.0 且可用的工程,升级前请先与销售联系,申请迁移授权,升级后,工程需要重新授权。

    注3:升级工具仅支持 JAR 包日期为 2021-11-15 及之后的FineReport 10.0版本进行升级。

    2. 获取升级工具

    由于 FineReport 功能不断优化,产品不断迭代升级,因此升级工具也在不断更新,本文暂不提供升级工具下载链接。

    请需要的客户先联系帆软销售确认升级可行性和相关事宜。

    确认后可联系帆软技术支持获取升级工具。技术支持联系方式 QQ:800049425,电话:400-811-8890

    3. 升级须知

    1)磁盘容量:由于升级工具体积较大,升级过程会对必要的文件进行解压,同时会对 10.0 进行整体 webroot 备份,所以升级工具所在磁盘保证剩余容量大于 3G ,备份路径所在磁盘保证剩余容量大于 webroot 工程大小。

    2)工程及升级工具路径:升级工具和工程所在路径不要包含较多特殊字符,可包含中文、英文、数字、英文括号、下划线、英文连接符、空格(一般不要将工程放在 C 盘内)

    3)关闭工程:升级之前请先关闭待升级的 10.0 工程。

    4)工程配置:10.0 工程如果配置了外置库、状态服务器、文件服务器,升级过程需要保证均可以正常连接以便更新文件。

    5)端口占用:升级过程会占用 20216 和 20217 端口

    6)升级环境:支持断网升级,支持无 JDK 环境升级

    7)工程配置:支持对单机工程和集群工程进行升级。集群升级时,只对单节点进行升级,升级成功后将升级成功的 webroot 拷贝替换至其他节点下。

    8)定制情况:10.0 工程存在定制情况,比如 JAR 定制、外置库定制、二开、集成定制等,请提前与技术支持确认升级后是否兼容以及如何兼容适配。

    9)插件适配:当前 FR11.0 只适配了官方插件,所以第三方插件、定制插件可能会出现升级后无法使用的情况。

    10)外接数据库:如果配置了外接数据库,建议先将外接数据库进行备份,备份后切换到备份数据库升级。也可以通过备份切换到内置数据库再升级。

    11)JAR 包版本:在进行升级前需要将 JAR 包升级至 2021-11-15 及之后的日期。

    注:若未将 JAR包未升级至 2021-11-15 就使用升级工具进行升级,在升级失败后会出现 finedb 无法匹配的问题。

    4. 升级步骤

    4.1 Windows 系统升级步骤

    1)右键点击升级工具,选择「以管理员身份运行。如下图所示:

    1.png

    2)打开程序后,将会出现黑色控制台面板,如下图所示:

    注:不要手动关闭。

    2.png

    3)加载一段时间后,将会出现前台操作面板,如下图所示:

    注:不要手动关闭。

    3.png

    4)点击「..」,选择需要备份的 10.0 的 webroot 工程,如下图所示:

    4.png

    5)点击「..」,选择备份工程的路径,如下图所示:

    注:备份路径任选一个干净的、容量充足的位置。不要选择已有备份文件的路径,否则会出现文件复制多份的情况。

    5.png

    6)点击「开始升级」,将会弹出对话框:开始后台升级,请等待,如下图所示:

    6.png

    7)点击「Yes」后,将自动关闭前台面板并对 10.0 工程进行升级,黑色控制台面板会显示更新日志信息,工程及路径正确将会显示 Fine assist start successfully,如下图所示:

    注:在升级过程中请勿关闭本程序,同时不要对原工程做任何编辑修改操作。

    8.png

    8)升级成功后,黑色控制台面板将会显示 v11 upgrade success!!!! ,如下图所示:

    9.png

    10)手动关闭黑色控制台面板即可,此时 10.0 中的项目文件 webroot 就是被升级后的文件。

    • 升级成功后 webroot/WEB-INF/lib 下 fine 开头的 10.0 jar 包会统一替换为 11.0 jar 包。

    • 升级成功后,webroot/plugin 文件夹下部分插件可能会同时存在 10.0 和 11.0 插件包。10.0 插件包中会包含 .delete 文件,工程启动后就会自动删除 10.0 插件包。

    4.2 Linux 系统升级步骤

    1)将升级工具上传至 Linux 系统中,手动赋予执行权限:chmod +x FineUpgrade_v11_linux_xxx.sh,如下图所示:

    注:FineUpgrade_v11_linux_xxx.sh 代表升级工具名称。

    2)根据命令行提示,手动输入 webroot path 和 backup path ,回车后即可正常升级,如下图所示:

    3)其余与 Windows 系统相同,请参考 4.1 节。

    4.3 日志关键字对照说明

    部分升级进程关键字如下表,若有模块升级失败可对应查找关键字确认。

    关键字
    启动成功Fine assist start successfully
    工程备份开始备份Start backup
    备份成功backup successfully
    备份失败Backup fail
    数据模块更新成功Authority module upgrade successfully
    更换 JAR 包开始替换V11 start: replace-
    替换成功replace jar successfully
    替换结束V11 end: replace-
    更新资源文件成功Resource module upgrade successfully
    插件更新日志删除插件remove plugin file

    安装插件install plugin

    更新插件upgrade plugin

    插件模块更新成功Plugin module replace successfully
    V11 模块升级成功V11 upgrade ok
    整体升级成功v11 upgrade success!!!!

    5. 补充说明

    1)升级工具只对 Web 工程的升级,不提供对完整设计器的升级。设计器如果需要升级,可以先全新安装 11.0,然后将老设计器下的工程升级到 11.0 后,将升级后的工程拷贝到新安装的 11.0 设计器目录下(也就是将 11.0 webapps 目录中的 webroot 文件替换为升级后的工程文件)。

    2)如果一个 Web 工程已经升级过,不管是否升级成功,都不要再次运行升级工具来升级。只能通过已备份的 10.0 工程重新执行升级。

    3)升级工具不能跨版本升级,如 9.0 工程想升级到 10.0,需要把工程先升级到 10.0,再从 10.0 升级到 11.0。

    4)若 10.0 工程已经配置 tools.jar ,则不需要重新引入 tools 工具包,相反则要将 %JAVA_HOME%/jdk/lib 下的环境变量 tools.jar 放到 %TOMCAT_HOME%/lib 和或 %TOMCAT_HOME%/webapps/工程名/WEB_INF/lib下,若不执行此步骤服务器部署过程中会报错 500。相关内容可参考: 服务器部署需引入 tools.jar

    5)升级工具支持官方的数据集类插件,支持列表如下:

    插件
    多维数据集
    SAP 数据集
    JSON 数据集
    MongoDB 数据集
    新 SAP BW 数据集
    螺旋数据集

    附件列表


    主题: 更新日志
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭