1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
| 11.5 | 注册步骤新增导出和发送工程 ID |
| 11.5.9 | 工程ID与工程注册信息合并导出，精简注册步骤 |
1.2 应用场景
「授权迁移插件」支持以下两种授权迁移场景：
场景一：跨大版本升级
仅支持 FineReport 10.0（2020-04-26 及之后版本）升级至 FineReport 11.0。
如需从 FineReport 9.0 升级至 FineReport 10.0，请参见 本地机器信息认证迁移程序
场景二：服务器迁移
帆软应用使用本地机器信息认证，新旧服务器的 Mac 地址不同，需要迁移工程授权。
1.3 功能简介
若报表工程使用本地机器信息认证，当需要授权迁移时，可使用「授权迁移插件」完成操作。整体流程如下：
用户导出新旧工程的注册信息，发送给帆软商务；
商务核实后生成「授权迁移插件」并发送给用户；
用户在旧报表工程上安装并运行插件，销毁旧工程授权，同时生成新工程授权。
1.3 注意事项
1）迁移前，旧报表工程必须能在原服务器上正常启动。
2）「授权迁移插件」仅支持一次迁移。若迁移完成后需再次迁移，请重新联系商务获取新的迁移工具。
3）临时注册无法迁移，请参考 本地机器信息认证 完成正式注册后再操作。
4）仅支持授权期限在一年及以上的 License。若授权过期时间与授权生成时间之差不足一年，则不支持本文方案。
5）FineReport 9.0 升级至 FineReport 10.0，请参见 本地机器信息认证迁移程序 ，本文方案不适用。
2. 操作步骤
2.1 准备材料
在联系商务前，需提前准备以下材料：
1） 旧报表工程的注册信息文件
管理员登录旧工程，依次点击「管理系统 > 注册管理 > 版本信息」。
点击「导出注册信息」，导出旧工程的注册信息文件「RegistrationInformation.rif」
注：请勿打开 .rif 文件，否则文件将损坏，导致注册失败。
2）新报表工程的工程名
打开新工程所在服务器%FR_HOME%\webapps\目录，确认报表 Web 工程名，默认为webroot。
注：工程名可在注册前按需修改，注册后将无法更改。修改工程名可能影响模板超链等设置，请谨慎操作。
修改后，工程访问地址将变为 http://IP:端口/工程名/decision。
3）新报表工程的工程ID信息（11.5~11.5.8版本必做）
11.5~11.5.8版本 FineReport 工程需完成此操作，其他版本请跳过。
以管理员身份登录新 FineReport 系统，依次点击「管理系统 > 注册管理」。
在工程信息 > 应用工程 ID 右侧，点击「导出ID」按钮。
系统生成并下载「appID.rif」文件，该文件包含新工程的唯一 ID 信息。
注：请勿打开 .rif 文件，否则文件将损坏，导致注册失败。
4）新报表工程的注册信息文件
以管理员身份登录新 FineReport 系统，依次点击「管理系统>注册管理」。
在「注册信息>版本注册」右侧，点击「立即注册」按钮。
认证方式选择「本地机器信息认证」，点击「导出注册信息」按钮。
系统生成并下载「RegistrationInformation.rif」文件，该文件包含工程版本和服务器机器信息。11.5.9 及之后版本，该文件还包含工程的唯一 ID 信息。
注：请勿打开 .rif 文件，否则文件将损坏，导致注册失败。
2.2 获取授权迁移插件
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com。商务核实无误后将以邮件方式发送「授权迁移插件」给您。
注：若有任何特殊情况，请在邮件中注明。
| 清单 | 内容 | 注意事项 |
|---|---|---|
| 发件人 | 合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册迁移 |
| 收件人 | business@fanruan.com | - |
| 标题 | XXX 公司注册迁移 FineReport 正式授权 | 如发送注册信息时，未注明公司名称，则不予注册 |
| 正文 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 注册方式：本地机器信息认证 迁移方式：授权迁移插件 新报表工程名：2.1节获取的新报表工程的工程名 新报表工程版本：精确到工程小版本和JAR包信息，可在「管理系统 > 注册管理 > 版本信息」中查看 | 其他并发数、用户数等信息，将按照签订的合同进行注册 |
| 附件 | 旧报表工程导出的 RegistrationInformation.rif文件 | 1）请将文件用文件夹储存，以便区分新旧报表工程的文件 2）请勿用任何程序打开 .rif 文件，打开操作会导致文件损坏，损坏后发送给商务将导致注册失败 |
| 旧报表工程的「管理系统>注册管理」页面截图 | 1）截图中必须包含服务器地址，确保旧工程可正常运行 旧的报表工程必须可以在原服务器上正常启动，否则无法进行注册迁移，只能重新申请授权，请联系销售处理 2）截图中注册管理页面必须显示「注册成功」，确保旧工程已成功注册 若工程当前未注册/临时注册/注册过期，无法进行注册迁移，请联系销售增购/沟通 | |
| 新报表工程导出的RegistrationInformation.rif | 1）请将文件用文件夹储存，以便区分新旧报表工程的文件 2）请勿用任何程序打开 .rif 文件，打开操作会导致文件损坏，损坏后发送给商务将导致注册失败 | |
| 新报表工程导出的appID.rif | 1）仅 11.5~11.5.8 版本的 FineReport 需附上此文件，其他版本无需 2）请勿用任何程序打开 .rif 文件，打开操作会导致文件损坏，损坏后发送给商务将导致注册失败 |
2.3 旧工程安装插件
1）管理员登录旧报表工程，进入「管理系统 > 插件管理」。
2）点击「从本地安装」，选择商务发送的授权迁移插件。
3）安装成功后，页面提示「Lic 迁移插件安装成功」。
注： 安装前请检查旧工程中是否存在历史版本的授权迁移插件，若有请先卸载。
2.4 运行迁移插件
1）管理员登录旧报表工程，进入「管理系统 > 注册管理 > 授权迁移」。点击「执行销毁并激活」按钮。
2）插件将自动销毁旧工程授权，生成销毁凭证文件 FanruanLic.DC，并生成新工程的注册 Lic 文件。
销毁凭证文件存放路径：
单机环境：%FR_HOME%/webroot/WEB-INF/resources/
集群环境：文件服务器的 /WEB-INF/resources/
注意事项：
销毁旧授权需要一定时间，请耐心等待。若在销毁完成前刷新浏览器，将出现 404 错误，需等待销毁完成后页面才能正常显示。
若不慎丢失新授权 Lic，在首次执行销毁后的 10 小时内，管理员可再次进入「授权迁移」页面，点击「执行销毁并激活」重新获取。再次生成的新 Lic 将使之前的 Lic 失效。
2.5 新工程注册
1）管理员登录新报表工程，进入「管理系统 > 注册管理 > 版本信息」。
2）点击「上传 lic 文件」，导入 FanRuan.lic 授权文件。
3）页面显示「注册成功」即完成迁移。
注1：FanRuan.lic 将自动保存至 %FR_HOME%\webroot\WEB-INF\resources\ 目录下。
注2：新工程注册成功后，请及时删除旧工程中的授权迁移插件。
3. 迁移失败
在旧报表工程的「管理系统>注册管理>授权迁移」页面，点击「执行销毁并激活」可能会出现失败提醒。
本章将详细给出各种报错的原因。
1）迁移失败：当前服务器未注册或为临时注册
未注册的报表工程，无法执行销毁授权的操作。请联系商务进行正式注册。
临时注册的报表工程，无法迁移授权。请联系商务进行正式注册。
2）迁移失败：当前服务器机器码不匹配，无法激活新授权
发给商务的旧报表工程 rif 文件中的服务器机器码，和插件当前所在旧报表工程的服务器机器码不相同。
请确认插件是否安装在正确的、需要迁移的旧报表工程中，而不是误安装到了新报表工程/其他工程中。
3）迁移失败：该授权已被激活过，无法重新激活
新旧报表工程的lic唯一标识完全相同，此时无法迁移工程授权。
「授权迁移插件」只能进行一次迁移，如迁移完成后需要再次迁移，请重新联系商务获取新的迁移工具。
上一篇：本地机器信息认证
