1. 概述编辑
1.1 版本
| 报表服务器版本 | JAR 包 |
|---|---|
| 10.0 | 2019-12-05 |
1.2 应用场景
1）若报表工程需要迁移服务器，服务器的 Mac 地址不同，此时需要进行本地机器信息认证迁移。
2）若报表工程跨大版本升级（如 FineReport9.0 升级到 FineReport10.0），此时需要使用迁移工具销毁旧 lic，生成新 lic。
1.3 实现方法
用户导出新服务器/工程的信息并发送给帆软商务，商务会生成新 License 的迁移程序并发送给用户。
用户在电脑上直接打开，输入原报表服务器的 URL，迁移程序自动将原报表服务器的注册销毁，并解锁新的 FanRuan.lic 。
1.4 注意事项
1）License 迁移之前，必须确保旧的报表工程可以在原服务器上正常启动。
2）临时注册无法迁移，请参考 本地机器信息认证 进行正式注册。
2. Windows 环境编辑
2.1 获取迁移程序
请参考：本地机器信息认证，导出新报表工程的注册信息并发送给帆软商务，获取最新的迁移工具。
注：请在邮件中注明旧服务器环境为 Windows。
客户收到 FineReport 商务发送过来的最新的 License ，如下图所示：
2.2 生成验证码
超级管理员登录旧报表工程的数据决策系统，在决策平台内访问指定 URL 生成验证码。如下图所示：
URL 示例：http://ip:端口/webroot/decision/v10/register/remove/captcha
注1：此处的数据决策系统为原工程，即需要将 License 销毁的工程。
注2：每次访问 URL 重新生成验证码，在新验证码生成时旧验证码失效。
注3：若旧报表工程配置了短域名，则 URL 为 http://域名/decision/v10/register/remove/captcha
2.3 运行迁移程序
2.3.1 输入旧报表工程地址
将「迁移程序」上传至旧报表工程所在服务器，并运行。运行后弹出命令行窗口。提示：卸载服务器目标地址：
输入旧报表工程的服务器地址：http://ip:端口/webroot/decision 或 http://域名/webroot/decision
注1：请确保运行「迁移程序」的服务器与旧报表工程的服务器可以正常通信。否则将提示：连接服务器失败，请检查地址是否正确，重新输入：
注2：若输入的服务器目标地址未注册或为临时注册，则提示用户：迁移失败，报表服务器未注册或为临时注册。
2.3.2 输入验证码
正确输入写在服务器目标地址后，弹出提示：请输入验证码。将 2.2 节获取的验证码输入，如下图所示：
注：验证码有效期30分钟，若验证码校验失败，则提示：验证码错误或已失效，请重新输入
2.3.3 生成 FanRuan.lic 文件
验证码输入成功后，跳出提示：迁移成功，请把当前命令行窗口工作目录下这个lic文件放入报表服务器中。
此时旧报表工程的注册失效，在迁移工具同目录下自动生成新报表工程的注册文件「FanRuan.lic」。如下图所示：
2.4 新工程注册
管理员登录新报表工程的数据决策系统，点击「管理系统>注册管理>版本信息」，点击「上传lic文件」，导入 FanRuan.lic 授权文件，如下图所示：
若正确无误，此时会显示注册成功，如下图所示：
注：FanRuan.lic会自动保存到当前工程%FR-HOME%\webroot\WEB-INF\resources 目录下。
3. Linux 环境编辑
3.1 获取迁移程序
请参考：本地机器信息认证，导出新报表工程的注册信息并发送给帆软商务，获取最新的迁移工具。
注：请在邮件中注明旧服务器环境为 Linux。
客户收到 FineReport 商务发送过来的最新的 License 迁移程序，如下图所示：
3.2 生成验证码
超级管理员登录旧报表工程的数据决策系统，在决策平台内访问指定 URL 生成验证码。如下图所示：
URL 示例：http://ip:端口/webroot/decision/v10/register/remove/captcha
注1：此处的数据决策系统为原工程，即需要将 License 销毁的工程。
注2：每次访问 URL 重新生成验证码，在新验证码生成时旧验证码失效。
注3：若旧报表工程配置了短域名，则 URL 为 http://域名/decision/v10/register/remove/captcha
3.3 运行迁移程序
将「迁移程序」上传至旧报表工程所在服务器。
3.3.1 添加可执行权限
为执行程序添加下可执行权限。代码如下所示：
chmod u+x lic_remove
3.3.2 输入旧报表工程地址
运行后弹出命令行窗口。提示：卸载服务器目标地址。如下图所示：
输入旧报表工程的服务器地址：http://ip:端口/webroot/decision 或 http://域名/webroot/decision
注1：请确保运行「迁移程序」的服务器与旧报表工程的服务器可以正常通信。否则将提示：连接服务器失败，请检查地址是否正确，重新输入：
注2：若输入的服务器目标地址未注册或为临时注册，则提示用户：迁移失败，报表服务器未注册或为临时注册。
3.3.3 输入验证码
正确输入写在服务器目标地址后，弹出提示：请输入验证码。将 3.2 节获取的验证码输入，如下图所示：
注：验证码有效期30分钟，若验证码校验失败，则提示：验证码错误或已失效，请重新输入。
3.3.4 生成 FanRuan.lic 文件
验证码输入成功后，跳出提示：迁移成功，请把当前命令行窗口工作目录下这个lic文件放入报表服务器中。
此时旧报表工程的注册失效，在迁移工具同目录下自动生成新报表工程的注册文件「FanRuan.lic」。如下图所示：
3.4 新工程注册
管理员登录新报表工程的数据决策系统，点击「管理系统>注册管理>版本信息」，点击「上传lic文件」，导入 FanRuan.lic 授权文件，如下图所示：
若正确无误，此时会显示注册成功，如下图所示：
注：FanRuan.lic会自动保存到当前工程%FR-HOME%\webroot\WEB-INF\resources 目录下。
4. Mac 环境编辑
4.1 获取迁移程序
请参考：本地机器信息认证，导出新报表工程的注册信息并发送给帆软商务，获取最新的迁移工具。
注：请在邮件中注明旧服务器环境为 Mac。
客户收到 FineReport 商务发送过来的最新的 License 迁移程序，如下图所示：
4.2 生成验证码
超级管理员登录旧报表工程的数据决策系统，在决策平台内访问指定 URL 生成验证码。如下图所示：
URL 示例：http://ip:端口/webroot/decision/v10/register/remove/captcha
注1：此处的数据决策系统为原工程，即需要将 License 销毁的工程。
注2：每次访问 URL 重新生成验证码，在新验证码生成时旧验证码失效。
注3：若旧报表工程配置了短域名，则 URL 为 http://域名/decision/v10/register/remove/captcha
4.3 运行迁移程序
将「迁移程序」上传至旧报表工程所在服务器。
4.3.1 添加可执行权限
为执行程序添加下可执行权限。代码如下所示：
chomd u+x lic_remove
4.3.2 输入旧报表工程地址
执行迁移程序，代码如下所示：
./lic_remove
运行后弹出命令行窗口。提示：卸载服务器目标地址。如下图所示：
输入旧报表工程的服务器地址：http://ip:端口/webroot/decision 或 http://域名/webroot/decision
注1：请确保运行「迁移程序」的服务器与旧报表工程的服务器可以正常通信。否则将提示：连接服务器失败，请检查地址是否正确，重新输入：
注2：若输入的服务器目标地址未注册或为临时注册，则提示用户：迁移失败，报表服务器未注册或为临时注册。
4.3.3 输入验证码
正确输入写在服务器目标地址后，弹出提示：请输入验证码。将 4.2 节获取的验证码输入，如下图所示：
注：验证码有效期30分钟，若验证码校验失败，则提示：验证码错误或已失效，请重新输入。
4.3.4 生成 FanRuan.lic 文件
验证码输入成功后，跳出提示：迁移成功，请把当前命令行窗口工作目录下这个lic文件放入报表服务器中。
此时旧报表工程的注册失效，在迁移工具同目录下自动生成新报表工程的注册文件「FanRuan.lic」。如下图所示：
4.4 新工程注册
管理员登录新报表工程的数据决策系统，点击「管理系统>注册管理>版本信息」，点击「上传lic文件」，导入 FanRuan.lic 授权文件，如下图所示：
若正确无误，此时会显示注册成功，如下图所示：
注：FanRuan.lic会自动保存到当前工程%FR-HOME%\webroot\WEB-INF\resources 目录下。