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