反馈已提交

网络繁忙

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

授权迁移插件

  • 文档创建者:Carly
  • 历史版本:11
  • 最近更新:Carly 于 2023-11-23
  • 1. 概述

    1.1 版本

    报表服务器版本
    JAR包版本
    10.02020-04-26

    1.2 应用场景

    「授权迁移插件」支持以下情况的授权迁移:

    1)跨大版本升级:仅支持 FineReport10.0(2020-04-26及以后版本)升级到 FineReport11.0。如 FineReport9.0 升级到 FineReport10.0,请参见:本地机器信息认证迁移程序

    2)服务器迁移:报表工程使用本地机器信息认证,新旧报表工程服务器的 Mac 地址不同,需要迁移工程授权。

    1.3 功能简介

    若报表工程使用本地机器信息认证,当需要授权迁移时,可使用两种方法:

    1)本地机器信息认证迁移程序:授权迁移程序较为繁琐。

    2)本地机器信息认证授权迁移插件:简单易用,本文将详细描述如何使用插件进行授权迁移。

    用户导出新旧工程的信息并发送给帆软商务,商务会生成「授权迁移插件」并发送给用户。

    用户在旧报表工程上安装并运行该插件,将旧报表工程的授权销毁,并生成新报表工程的授权。

    1.4 注意事项

    1)License 迁移之前,必须确保旧的报表工程可以在原服务器上正常启动。

    2)「授权迁移插件」只能进行一次迁移,如迁移完成后需要再次迁移,请重新联系商务获取新的迁移工具。

    3)临时注册无法迁移,请参考 本地机器信息认证 进行正式注册。

    2. 示例

    2.1 准备材料

    1)旧报表工程的注册信息 rif 文件

    管理员登录旧报表工程,点击「管理系统>注册管理>版本信息」,点击「导出注册信息」,导出旧报表工程的注册信息 rif 文件。如下图所示:

    2)新报表工程的注册信息 rif 文件

    管理员登录新报表工程,点击「管理系统>注册管理>版本信息」,点击「立即注册」。

    认证方式选择「本地机器信息认证」,点击「导出注册信息」,导出新报表工程的注册信息 rif 文件。如下图所示:

    3)新报表工程的工程名

    打开新报表工程所在服务器%FR_HOME%\webapps\目录,确认报表 Web 工程名,默认为webroot

    用户可在注册前根据自身需要修改工程名,注册后将无法修改。

    注:此工程名的修改可能会影响模板的超链等设置,请谨慎修改。

          修改工程名就是改这个文件夹的名称,修改后,访问工程的地址就变成了http://IP:端口/工程名/decision

    2.2 获取授权迁移插件

    请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com,邮件格式如下: 

    商务收到邮件,核实无误后会为您生成一个授权迁移插件,以邮件方式发送给您。如下图所示:

    注:若有任何特殊情况,请在邮件中注明。

    清单内容注意事项
    发件人请使用合同中指定的邮箱如发送注册信息的邮箱,非合同中指定的邮箱,则不予注册迁移
    收件人business@fanruan.com-
    标题XXX 公司注册迁移 FineReport 正式授权如发送注册信息时,未注明公司名称,则不予注册
    正文

    公司名称:XXX 公司

    项目名称:XXX 项目

    合同签定日期:XXXX年XX月XX日

    注册方式:本地机器信息认证

    迁移方式:授权迁移插件

    新报表工程名:2.1节获取的新报表工程的工程名

    其他并发数、用户数等信息,将按照签订的合同进行注册
    附件1

    旧报表工程导出的 rif 文件

    新报表工程导出的 rif 文件

    请将文件用文件夹储存,以便区分新旧报表工程的rif 文件

    不要打开生成的 RegistrationInformation.rif 文件,这会导致文件损坏,如果再将其发送给帆软商务,就会导致注册不成功

    附件2旧报表工程的「管理系统>注册管理」页面截图

    1)截图中必须包含服务器地址,确保工程可正常运行

    旧的报表工程必须可以在原服务器上正常启动,否则无法进行注册迁移,只能重新申请授权,请联系销售处理

    2)截图中注册管理页面必须显示「注册成功」,确保工程已成功注册

    若工程当前未注册/临时注册/注册过期,无法进行注册迁移,请联系销售增购/沟通

    2.3 旧工程安装插件

    管理员登录旧报表工程,点击「管理系统>插件管理」,点击「从本地安装」,选择商务发送的授权迁移插件,安装成功后提示「Lic迁移插件安装成功」。如下图所示:

    2.4 运行迁移插件

    管理员登录旧报表工程,点击「管理系统>注册管理>授权迁移」,点击「执行销毁并激活」。

    插件会自动销毁旧报表工程的授权,生成销毁凭证文件FanruanLic.DC,以及生成新报表工程的注册Lic,如下图所示:

    注1:用户在需要时可前往以下路径获取销毁凭证,并提供给帆软技术支持。
            单机环境的销毁凭证存放在%FR_HOME%/webroot/WEB-INF/resources文件夹下,集群环境的销毁凭证存放在文件服务器的/WEB-INF/resources文件夹下。

    注2:销毁旧授权需要一段时间,请耐心等待。若未成功销毁便刷新浏览器窗口,会导致404错误,需要等待至销毁成功后,才可以正确显示迁移页面,并获取到新Lic。

    注3:若不小心遗失了新授权lic,在首次销毁旧授权后10小时内,管理员仍可再次进入「授权迁移」页面,点击「执行销毁并激活」按钮。

             当再次点击执行销毁并激活」按钮后,会为管理员再次生成一份新报表工程的注册Lic,之前生成的Lic失效。

    2.5 新工程注册

    管理员登录新报表工程,点击「管理系统>注册管理>版本信息」,点击「上传lic文件」,导入 FanRuan.lic 授权文件,如下图所示:

    若正确无误,此时会显示注册成功,如下图所示:

    注1:FanRuan.lic会自动保存到您当前工程%FR-HOME%\webroot\WEB-INF\resources 目录下。

    注2:新报表工程注册成功后,请及时删除旧报表工程中的授权迁移插件。

    3. 迁移失败

    在旧报表工程的「管理系统>注册管理>授权迁移」页面,点击「执行销毁并激活」可能会出现失败提醒。

    本章将详细给出各种报错的原因。

    1)迁移失败:当前服务器未注册或为临时注册

    • 未注册的报表工程,无法执行销毁授权的操作。请联系商务进行正式注册。

    • 临时注册的报表工程,无法迁移授权。请联系商务进行正式注册。

    2)迁移失败:当前服务器机器码不匹配,无法激活新授权

    发给商务的旧报表工程 rif 文件中的服务器机器码,和插件当前所在旧报表工程的服务器机器码不相同。

    请确认插件是否安装在正确的、需要迁移的旧报表工程中,而不是误安装到了新报表工程/其他工程中。

    3)迁移失败:该授权已被激活过,无法重新激活

    新旧报表工程的lic唯一标识完全相同,此时无法迁移工程授权。

    「授权迁移插件」只能进行一次迁移,如迁移完成后需要再次迁移,请重新联系商务获取新的迁移工具。

    附件列表


    主题: 数据决策系统
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

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

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

    总裁办24H投诉

    热线电话:173-1278-1526