反馈已提交

网络繁忙

当前为10.0版本文档,只有最新版本的文档支持在线编辑修改,如果想创建/编辑文档,请移步至 最新版帮助文档

9-10 升级工具

  • 文档创建者:jiangsr
  • 历史版本:72
  • 最近更新:Suki陈 于 2023-03-24
  • 1. 概述

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

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

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

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

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

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

    2. 升级技术协助与升级工具获取

    2.1 升级技术协助

    Finereport 大版本升级技术协助,目前由专属的升级团队负责,您可以通过阅读「升级风险评估书填写说明」完成填写「升级风险评估书」并提交,做个简单的前置环境信息了解,在提交「升级风险评估书」后会自动进入系统排队,升级团队会在您填写的预期升级时间内,主动与您取得联系,对接具体升级事宜,商务问题请联系您的销售经理进行确认。

    升级风险评估书填写说明:升级风险评估表填写说明 。

    升级风险评估书链接如下:升级风险评估书 。

    2.2 升级工具获取

    由于 FineReport 功能不断优化,产品不断迭代升级,因此升级工具也在不断更新,本文暂不提供升级工具下载链接。您可以选择直接提交风险评估书,届时升级团队会给您发放;或者联系技术支持获取。技术支持联系方式:

    • 在线支持:前往「服务」,选择「在线支持」

    • 电话:400-811-8890

    3. 升级须知

    注:升级前,请仔细阅读以下升级须知。

    1)工程备份:升级之前请先关闭待升级的工程,并对此工程进行备份。

    2)以管理员方式启动升级工具,保证升级工具能在工程所在的磁盘创建文件夹(一般不要将工程放在 C 盘内)。

    3)当前只支持 JDK1.8,所以升级工程前务必查看 JDK 版本,保证 JDK 版本符合要求,否则升级成功后会出现部署报错。

         如果 JDK 环境不允许改动,也可将工程拷贝到 JDK1.8 环境中升级完成后再拷贝回来。

    4)内网离线环境下,升级后的工程,插件商城无法伴随升级,升级成功后需要手动替换插件商城脚本文件 scripts 。 

         点击可下载 scripts:scripts.rar

         替换路径为:%FR_HOME%/webapps/webroot/scripts,替换后需重启服务器,并且清除浏览器缓存。

    5)如果待升级工程的 finedb 数据库 为外接数据库,升级过程中需要确保能够连接到外接数据库。

    6)9.0 版本,同步数据集时选择了自定义加密类,升级到 10.0 因接口发生变化都需要参照 10.0 方式重新适配。10.0 中取消了默认的 MD5 加密,若 9.0 选择了「内置 MD5 加密」升级后如仍需使用 MD5 加密请参见 密码加密设置 第 6.1 节。

    7)部分插件未支持新版本,在升级前请进行删除。

    8)9.0 做了单点登录的工程升级到 10.0 需要重新进行适配。

    9)深度集成的客户,建议把数据先拿到独立部署的工程里面,升级完成后,另行适配 10.0。

    10)非简体中文系统用户升级前,务必要手动备份数据库信息。升级工具会删除不同语言下的权限配置。

    11)Linux 非简体中文环境下,2018-02-28~2018-09-06 之间的 9.0 JAR 包与 10.0 无法完全兼容,需要先将 9.0 JAR 升级最新,再使用升级工具升级到 10.0。

    12)升级前请先检查是否有普通用户和超级管理员重名的现象,若有,需要手动处理 9.0 用户数据,要么重命名超级管理员,要么重命名或删除这个普通用户。

    4. 升级步骤

    4.1 升级工具使用

    4.1.1 Windows 系统升级工具使用步骤

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

    1565234996677308.png

    2)打开程序后,进行语言选择,可选择「简体中文」、「繁体中文」、「英语」。如下图所示,用户根据实际工程情况选择。

    image.png

    3)点击「确定」,进入 FineReport 10.0 升级工具的安装程序向导,选择待升级的 9.0 工程文件夹。如下图所示:

    注:工程文件夹一般为 %FR9.0_HOME%/WebReport 文件夹,是包含 WEB-INF 的文件夹。

    image.png

    如果所选目录未检测到 WEB-INF 文件夹,会提示:「请选择包含 WEB-INF 目录的WEB容器文件夹」,用户需检查是否工程文件选择错误。

    1565236232691565.png

    如果选择的工程版本非 9.0,会提示:「仅支持 9.0 的工程升级」,用户需检查是否工程文件选择错误。

    1565236304174673.png

    4)点击「下一步」,进入原工程备份界面,选择原文件夹备份保存的地址,如下图所示:

    1565243433286147.png

    注:备份地址不允许为空,为空时提示:您必须输入备份目录

    1565243237462741.png

    5)点击「下一步」,提示:「即将开始升级,在升级过程中请勿关闭本程序,同时不要对原工程做任何编辑修改操作」。如下图所示:

    1565243738484640.png

    6)点击「下一步」,启动备份升级,如下图所示:

    2.png

    备份成功后,在设置好的文件夹下生成 WebReport_bak 的备份文件。如下图所示:

    1565244505756899.png

    7)升级结束后,显示升级完成,界面如下图所示:

    1565244429958484.png

    8)点击完成后,9.0 中的项目文件 WebReport 就是被升级后的文件。如下图所示:

    image.png

    4.1.2 Linux 系统升级工具使用步骤

    1)在 Linux 命令行中切换到安装包所在目录,给安装包文件权限,如下图所示:

    chmod 777 FineUpgrade_v10_20200928.sh

    2)启动升级工具,如下图所示:

    ./FineUpgrade_v10_linux_20200928.sh

    3)选择语言,输入 "1" 简体中文即可,点击回车键,如下图所示:

    4)需要手动输入升级的 FineReport 9.0 工程所在文件夹,如 /usr/Reason/WebReport ,点击回车键后,手动输入备份工程的存放路径,点击回车键。如下图所示:

    5)开始升级,在升级过程中请勿关闭本程序,同时不要对原工程做任何「编辑修改」操作。升级成功后会自动切到命令行界面,可以进入原工程的 lib 包中,检查 jar 包是否变成 fine 开头的 10.0 jar 包,同时查看备份路径中是否有 _bak 结尾的备份工程,都有则升级成功。如下图所示:

    4.2 引入tools工具包

    因 10.0 部署除了需要有 JRE 以外,还需要 JDK 中的 tools.jar,所以升级工具升级完工程后,还需要引入 JDK 中的 tools.jar 工具包。如不执行此步骤,服务器部署过程中会报错 500,相关内容可参考: 服务器部署需引入 tools.jar

    将 %JAVA_HOME%/jdk/lib 下的环境变量tools.jar放到 %TOMCAT_HOME%/lib%TOMCAT_HOME%/webapps/工程名/WEB_INF/lib下,如下图所示:


    注:若环境变量指向的 %JRE_HOME%/bin 下无 attach.dll 文件,还需将 %JAVA_HOME%/jdk/jre/bin 下的 attach.dll 拷贝到此路径下。

    4.3 启动工程

    需注意以下两点:

    • 用户的 9.0 工程部署在 WebLogic 服务器中,且按照 9.0 帮助文档 weblogic类冲突报错 配置了weblogic.xml 文件时,升级 10.0 后需要删除%/WebReport%/WEB-INF文件夹下的weblogic.xml配置文件,再启动 Weblogic 服务器,否则会启动失败。

    • 升级后登录平台的 URL 发生变化,需要修改为 10.0 支持的 URL 格式,才能正常访问,如本地服务器可修改为:http://localhost/WebReport/ReportServer?op=fs  或  http://localhost/WebReport/decision

    若升级后的工程需要部署,参考帮助文档部署集成章节,完成部署即可。

    启动工程,登录决策系统,即可看到 9.0 工程升级到了 10.0 并保留平台数据,如下图所示:image.png

    5. 常见问题

    5.1 升级工具闪退

    问题描述:升级过程中,可能会因为一些原因导致升级工具闪退。

    解决方案:如发生闪退情况,请联系帆软技术支持,并发送error.log文件,如下图所示:

    1)windows:error.log在升级工具同级文件夹生成

    image.png

    2)linux:如升级失败,日志会保存在/tmp目录下,如升级成功,该日志将自动删除,如下图所示:

    image.png

    5.2 Unsupported major.minor version 52.0

    问题描述:工程可以升级成功,但升级后部署报错:com/sun/tools/attach/VirtualMachine:Unsupported major.minor version 52.0

    原因分析:升级工具仅支持 JDK1.8 环境,其他版本的 JDK 环境不支持

    解决方案:

    1. 直接更换为 JDK1.8 的环境再升级

    2. 客户的工程拷贝到另外一个 JDK1.8 的环境进行升级,完成后再拷贝回其他的环境

    5.3 权限丢失

    问题描述:2018-02-28 ~ 2018-09-06 之间的 JAR 包,Linux 英文/繁体中文环境下,所有部门所有职务存在遗留问题,导致权限会存在所有部门所有职务或者 All DepartmentAll Post 上。

    解决方案:由于升级工具会根据 JAR 包时间以及升级的语言环境升级对应的权限,因此直接将9.0 JAR升级至最新,再使用升级工具升级到 10.0 即可。

    5.4 端口被占用

    原因分析:2018-11-06 及之后的 JAR 包。10.0 工程有两个端口,一个是容器的端口:默认为 8075,另一个是 websocket:默认为 38888。当同一个设备上有不止一个 10.0 工程时,两个端口不能同时相同,否则会出现端口被占用报错的问题。

    解决方案工程端口被占用的处理方法

    5.5 9.0 设计器配置了 informix 外接数据库,升级时需要进行转换

    问题描述:9.0 设计器配置了 informix 数据库,在 9.0 升 10.0 时无法成功将数据迁移内置库,且升级后会有表缺失的报错,如下图所示:

    解决方案:

    1)需要先自行利用第三方工具(例如 dbeaver ),将外置库数据拷贝到官方支持的几种数据库中(mysql、sqlserver、oracle)。

    2)启动设计器,创建拷贝后的数据库连接。

    3)打开%/WebReport%/resource文件夹下的 config.xml ,找到 informix 的相关配置信息,对应字段 url、driver、user、password 都替换成%/WebReport%/resource文件夹下的 datasource.xml 中生成的数据库信息。

    4)启动设计器,确认是可以正常连接拷贝后的数据,若可以正常连接则正常升级即可。

    5.6 其他说明

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

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

    3)升级到 10.0 后,迁移过的 FineDB 会从数据库回退到原先的 FineDB ,需要重新迁移。

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

    5)2019 年 4 月 15 号及之后的升级工具支持官方的数据集类插件,支持列表如下:

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

    确认一下是直接通过设计器升级的工程进行部署,还是可以直接在工程上升级。

    附件列表


    主题: 设计器简介
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

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

    总裁办24H投诉

    热线电话:173-1278-1526