本地机器信息认证迁移

1.1 版本

1.2 应用场景

1）若 BI 工程需要迁移服务器，服务器的 Mac 地址不同，此时需要进行本地机器信息认证迁移。

2）若 BI 工程跨大版本升级（如 FineBI 4.1 升级到 FineBI5.1），此时需要使用迁移工具销毁旧 lic，生成新 lic。

1.3 实现方法

用户导出新服务器/工程的信息并发送给帆软商务，商务会生成新 License 的迁移程序并发送给用户。

用户在电脑上直接打开，输入原 FineBI 服务器的 URL，迁移程序自动将原 BI 工程服务器的注册销毁，并解锁新的 FanRuan.lic 。

1.4 注意事项

1）License 迁移之前，必须确保旧的 FineBI 工程可以在原服务器上正常启动。

2）一个迁移工具只能进行一次迁移，如迁移完成后需要再次迁移，请重新联系商务获取新的迁移工具。

3）无论服务器环境为 Windows/Linux/Mac，用户只需将迁移工具上传到一个可以和原服务器通信的机器上即可运行，所以商务默认发送Windows版本的迁移工具。

4）临时注册无法迁移，请参考 本地机器信息认证 进行正式注册。若进行迁移，提示：Unregistered or registered temporary lic

5）单点登录环境不支持 lic 迁移。

2.1 获取迁移程序

1）请复制好旧 BI 工程的%BI_HOME%/webroot/WEB-INF/resources 目录下的「FanRuan.lic」文件。

2）请参考：本地机器信息认证，确认新 BI 工程的工程名，导出新 BI 工程的注册信息 rif 文件。

3）请使用合同中指定的邮箱发送注册信息给 FineBI 商务business@fanruan.com，邮件格式如下： 

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

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

2.2 生成验证码

注：JAR 包版本在 2020-01-15 之前的旧 FineBI 工程，无需执行此操作。

超级管理员登录旧 FineBI 工程的数据决策系统，在决策平台内访问指定 URL 生成验证码。如下图所示：

URL 示例：http://ip:端口/webroot/decision/v10/register/remove/captcha

注1：此处的数据决策系统为原工程，即需要将 License 销毁的工程。

注2：每次访问 URL 重新生成验证码，在新验证码生成时旧验证码失效。

注3：若旧 FineBI 工程配置了短域名，则 URL 为 http://域名/decision/v10/register/remove/captcha

2.3 运行迁移程序

2.3.1 输入旧 FineBI 工程地址

将「迁移程序」上传至一个可以和旧 FineBI 工程通信的机器上，并运行。运行后弹出命令行窗口。提示：卸载服务器目标地址：

输入旧 FineBI 工程的服务器地址：http://ip:端口/webroot/decision 或 http://域名/webroot/decision

注1：请确保运行「迁移程序」的服务器与旧 FineBI 工程的服务器可以正常通信。否则将提示：连接服务器失败，请检查地址是否正确，重新输入：

注2：若输入的服务器目标地址未注册或为临时注册，则提示用户：迁移失败， FineBI 服务器未注册或为临时注册。

2.3.2 输入验证码

注：JAR 包版本在 2020-01-15 之前的旧 FineBI 工程，无需执行此操作。

正确输入写在服务器目标地址后，弹出提示：请输入验证码。将 2.2 节获取的验证码输入，如下图所示：

注：验证码有效期30分钟，若验证码校验失败，则提示：验证码错误或已失效，请重新输入

2.3.3 生成 FanRuan.lic 文件

验证码输入成功后，跳出提示：迁移成功，请把当前命令行窗口工作目录下这个lic文件放入 FineBI 服务器中。

此时旧 FineBI 工程的注册失效，在迁移工具同目录下自动生成新 FineBI 工程的注册文件「FanRuan.lic」。如下图所示：

2.4 新工程注册

管理员登录新 FineBI 工程的数据决策系统，点击「管理系统>注册管理>版本信息」，点击「上传lic文件」，导入 FanRuan.lic 授权文件。

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

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

3.1 获取迁移程序

1）请复制好旧 BI 工程的%BI_HOME%/webroot/WEB-INF/resources 目录下的「FanRuan.lic」文件。

2）请参考：本地机器信息认证，确认新 BI 工程的工程名，导出新 BI 工程的注册信息 rif 文件。

3）请使用合同中指定的邮箱发送注册信息给 FineBI 商务business@fanruan.com，邮件格式如下： 

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

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

3.2 生成验证码

注：JAR 包版本在 2020-01-15 之前的旧 FineBI 工程，无需执行此操作。

超级管理员登录旧 FineBI 工程的数据决策系统，在决策平台内访问指定 URL 生成验证码。如下图所示：

URL 示例：http://ip:端口/webroot/decision/v10/register/remove/captcha

注1：此处的数据决策系统为原工程，即需要将 License 销毁的工程。

注2：每次访问 URL 重新生成验证码，在新验证码生成时旧验证码失效。

注3：若旧 FineBI 工程配置了短域名，则 URL 为 http://域名/decision/v10/register/remove/captcha

3.3 运行迁移程序

将「迁移程序」一个可以和旧 FineBI 工程通信的机器上。

3.3.1 添加可执行权限

为执行程序添加下可执行权限。代码如下所示：

chmod u+x lic_remove

3.3.2 输入旧 FineBI 工程地址

运行后弹出命令行窗口。提示：卸载服务器目标地址。如下图所示：

输入旧 FineBI 工程的服务器地址：http://ip:端口/webroot/decision 或 http://域名/webroot/decision

注1：请确保运行「迁移程序」的服务器与旧 FineBI 工程的服务器可以正常通信。否则将提示：连接服务器失败，请检查地址是否正确，重新输入：

注2：若输入的服务器目标地址未注册或为临时注册，则提示用户：迁移失败， FineBI 服务器未注册或为临时注册。

3.3.3 输入验证码

注：JAR 包版本在 2020-01-15 之前的旧 FineBI 工程，无需执行此操作。

正确输入写在服务器目标地址后，弹出提示：请输入验证码。将 3.2 节获取的验证码输入，如下图所示：

注：验证码有效期30分钟，若验证码校验失败，则提示：验证码错误或已失效，请重新输入。

3.3.4 生成 FanRuan.lic 文件

验证码输入成功后，跳出提示：迁移成功，请把当前命令行窗口工作目录下这个lic文件放入 FineBI 服务器中。

此时旧 FineBI 工程的注册失效，在迁移工具同目录下自动生成新报表工程的注册文件「FanRuan.lic」。如下图所示：

3.4 新工程注册

管理员登录新 FineBI 工程的数据决策系统，点击「管理系统>注册管理>版本信息」，点击「上传lic文件」，导入 FanRuan.lic 授权文件。

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

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

4.1 获取迁移程序

1）请复制好旧 BI 工程的%BI_HOME%/webroot/WEB-INF/resources 目录下的「FanRuan.lic」文件。

2）请参考：本地机器信息认证，确认新 BI 工程的工程名，导出新 BI 工程的注册信息 rif 文件。

3）请使用合同中指定的邮箱发送注册信息给 FineBI 商务business@fanruan.com，邮件格式如下： 

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

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

4.2 生成验证码

注：JAR 包版本在 2020-01-15 之前的旧 FineBI 工程，无需执行此操作。

超级管理员登录旧报表工程的数据决策系统，在决策平台内访问指定 URL 生成验证码。如下图所示：

URL 示例：http://ip:端口/webroot/decision/v10/register/remove/captcha

注1：此处的数据决策系统为原工程，即需要将 License 销毁的工程。

注2：每次访问 URL 重新生成验证码，在新验证码生成时旧验证码失效。

注3：若旧 FineBI 工程配置了短域名，则 URL 为 http://域名/decision/v10/register/remove/captcha

4.3 运行迁移程序

将「迁移程序」一个可以和旧 FineBI 工程通信的机器上。

4.3.1 添加可执行权限

为执行程序添加下可执行权限。代码如下所示：

chmod u+x lic_remove

4.3.2 输入旧 FineBI 工程地址

执行迁移程序，代码如下所示：

./lic_remove

运行后弹出命令行窗口。提示：卸载服务器目标地址。如下图所示：

输入旧 FineBI 工程的服务器地址：http://ip:端口/webroot/decision 或 http://域名/webroot/decision

注1：请确保运行「迁移程序」的服务器与旧 FineBI 工程的服务器可以正常通信。否则将提示：连接服务器失败，请检查地址是否正确，重新输入：

注2：若输入的服务器目标地址未注册或为临时注册，则提示用户：迁移失败， FineBI 服务器未注册或为临时注册。

4.3.3 输入验证码

注：JAR 包版本在 2020-01-15 之前的旧 FineBI 工程，无需执行此操作。

正确输入写在服务器目标地址后，弹出提示：请输入验证码。将 4.2 节获取的验证码输入，如下图所示：

注：验证码有效期30分钟，若验证码校验失败，则提示：验证码错误或已失效，请重新输入。

4.3.4 生成 FanRuan.lic 文件

验证码输入成功后，跳出提示：迁移成功，请把当前命令行窗口工作目录下这个lic文件放入 FineBI 服务器中。

此时旧 FineBI 工程的注册失效，在迁移工具同目录下自动生成新 FineBI 工程的注册文件「FanRuan.lic」。如下图所示：

4.4 新工程注册

管理员登录新 FineBI 工程的数据决策系统，点击「管理系统>注册管理>版本信息」，点击「上传lic文件」，导入 FanRuan.lic 授权文件。

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

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