授权迁移插件

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.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，邮件格式如下： 

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

2.3 旧工程安装插件

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

2.4 运行迁移插件

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

插件会自动销毁旧 BI 工程的授权，并生成新 BI 工程的注册Lic，如下图所示：

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

注2：销毁旧授权后10小时内，进入「授权迁移」页面，点击「执行销毁并激活」，均可获取到新 BI 工程的注册Lic

2.5 新工程注册

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

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

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

注2：新 BI 工程注册成功后，请及时删除旧 BI 工程中的授权迁移插件。

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

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

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

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

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

2）迁移失败：当前服务器机器码不匹配，无法激活新授权

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

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

3）迁移失败：该授权已被激活过，无法重新激活

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

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