1. 概述
1.1 版本
| 报表服务器版本 | JAR 包 |
|---|---|
| 10.0 | 2019-12-05 |
1.2 应用场景
下面两个场景下需要用户进行 License 迁移。
1）当用户购买了 FineReport 报表之后，将其部署在服务器 A 上，由于公司发展需要，要将报表工程迁移到服务器 B 上，此时由于 FineReport 的注册方式是绑定 MAC 地址，不同服务器的 MAC 地址是不一样的，那么此时，直接使用原来的 License 文件放置在服务器 B 上，注册会失效，此时就需要使用 License 迁移程序生成新的 License 放置在服务器B上。
2）跨大版本升级时，如 FineReport9.0 升级到 FineReport10.0，必须要重新注册 License 才能使用( 即 9.0 的 License 在 10.0 不能使用 )。这样做的原因在于：用户保留原有旧版本的 License 的话，相当于同时有一套 9.0 和 10.0 的了，所以先要用 License 迁移程序将 9.0 的 License 销毁，才能生成新的 10.0 的 License 使用。
1.3 实现方法
将服务器 B 的信息发送给 FineReport 的商务，详细发送内容和联系方式请查看 FineReport服务器注册步骤，FineReport 商务会给服务器 B 进行注册，并生成新 License 的迁移程序，随后商务将迁移程序发送给客户，客户在电脑上直接打开，输入原报表服务器的 URL，迁移程序自动将原报表服务器的注册销毁，并解锁新的 Fanruan.lic 。
注：License 迁移之前，请确认所迁移的报表工程（即旧的报表工程）可以在原服务器上正常启动。
2. Windows 环境
2.1 获取迁移程序
导出新服务器的注册信息并发送给帆软商务，获取最新的迁移工具，步骤请参考 FineReport 服务器注册步骤 中的 3.1 章和 3.2 章。
注：不要打开生成的 RegistrationInformation.rif 文件，这会导致文件损坏，如果再将其发送给帆软商务，就会导致注册不成功。
客户收到 FineReport 商务发送过来的最新的 License
2.2 生成验证码
用户需要以超级管理员身份登录数据决策平台，在决策平台内访问指定 URL 生成相应验证码。
注：此处的决策平台为原工程，即需要将 License 销毁的工程。
URL 地址：http://localhost:8075/webroot/decision/v10/register/remove/captcha
如下图所示：
注：每次访问 URL 重新生成验证码，若 30 分钟内依次生成了多个验证码，在新验证码生成时旧验证码失效。
2.3 输入卸载服务器目标地址
在「迁移程序」中输入所需要卸载的服务器目标地址。
1）在用户输入「卸载服务器目标地址」后，若迁移工具与此地址通信失败，命令行窗口中提示用户：
连接服务器失败，请检查地址是否正确，重新输入：
如下图所示 ：
2）在用户输入服务器目标地址后，若此地址未注册或为临时注册，则提示用户：
迁移失败，报表服务器未注册或为临时注册
如下图所示：
2.4 输入验证码
在迁移工具中输入验证码。
若原来设计器已正式注册且通信成功，输入「卸载服务器目标地址」后，提示：
请输入验证码：
若验证码校验失败，则lic迁移失败，且提示用户：
验证码错误或已失效，请重新输入：
若验证码校验成功，则 lic 迁移成功，且提示用户：
迁移成功，请把当前命令行窗口工作目录下这个lic文件放入报表服务器中
如下图所示：
2.5 生成 Fanruan.lic 文件
若提示「迁移成功」，则在当前命令行窗口工作目录下会自动生成「Fanruan.lic」文件。如下图所示：
3. Linux 环境
3.1 获取迁移程序
步骤请见本文 2.1 章「获取迁移程序」，用户收到的迁移程序如下图所示：
注：如果迁移程序是白色的就添加可执行权限。代码如下所示：
chmod u+x lic_remove
3.2 生成验证码
该步骤请参考本文 2.2 章节「生成验证码」。
3.3 输入卸载服务器目标地址
1）解密并注册，执行迁移程序，命令为：
./lic_remove
2）该步骤请参考本文 2.3 章节「输入卸载服务器目标地址」。
3.4 输入验证码
请参考本文 2.4 章节「输入验证码」。
3.5 生成 Fanruan.lic
输入 URL 地址后执行，迁移程序自动将原报表服务器的注册销毁,并生成新的 Fanruan.lic，如下图所示：
4. Mac 系统
4.1 获取迁移程序
步骤请见本文 2.1 章「获取迁移程序」，用户收到的迁移程序如下图所示：
4.2 生成验证码
该步骤请参考本文 2.2 章节「生成验证码」。
4.3 输入卸载服务器目标地址
1）添加可执行权限，如下图所示：
2）解密并注册，执行迁移程序，命令为：
./lic_remove
3）请参考本文 2.3 章节「输入卸载服务器目标地址」。
4.4 输入验证码
请参考本文 2.4 章节「输入验证码」。
4.5 生成 Fanruan.lic
输入 URL 地址后执行，迁移程序自动将原报表服务器的注册销毁，并在当前命令行窗口工作目录下自动生成「Fanruan.lic」文件。
用这个新生成的 License 文件重新注册即可，注册方式请查看 FineReport服务器注册步骤 。
5. 注意事项
描述：
1）历史生成的 10.0 迁移工具无法迁移 JAR 包为 2019-12-05 及之后版本报表服务中的 License 。旧迁移工具尝试迁移 JAR 包为 2019-12-05 及以后版本报表服务中的 License 时，报表服务返回报错，如下图所示：
2）新生成的 10.0 迁移工具仍然支持迁移 JAR 包为 2019-12-05 之前版本的报表服务中的 License。