本地机器信息认证

1.1 版本

1.2 功能简介

本地机器信息认证是最常见的认证方式，操作简单，十分方便。

报表工程所在服务器的物理信息固定，用户通过导出 rif 文件，获取 mac 地址和机器码，来生成一个唯一标识的 license 文件。

1.3 注意事项

1）本地机器信息认证，需要报表工程所在服务器的物理信息固定。如不固定，不适合使用该注册方法。

     例如报表工程部署在虚拟机环境下，虚拟机环境下物理信息可能变化，造成注册失败，请选取其他注册方式。

2）一个正式 license 文件在一台机器上只能注册一次，若需要在同一台机器上注册多个工程，则需要购买多个 license 。

3）一个正式 license 文件只适用于一台服务器，如需更换服务器，需要进行注册迁移。

4）同一服务器下跨大版本升级（9.0升级10.0）后，需要进行注册迁移。推荐使用：授权迁移插件 。

5）请确保工程使用 JDK 1.8 且小版本需在 JDK8u200 以上。

6）Mac地址不允许设置为空，不允许不限。因为正式 license 文件强制校验Mac地址，为空则一定会注册失败。

2.1 确认工程名

打开报表工程所在服务器%FR_HOME%\webapps\目录，确认报表 Web 工程名，默认为webroot。

用户可在注册前根据自身需要修改工程名，注册后将无法修改。

注：此工程名的修改可能会影响模板的超链等设置，请谨慎修改。

      修改工程名就是改这个文件夹的名称，修改后，访问工程的地址就变成了http://IP:端口/工程名/decision

2.2 导出注册信息

启动 FineReport 工程所在服务器，管理员访问数据决策系统，点击「管理系统>注册管理」；

在「版本信息」 Tab 页下点击「立即注册」，认证方式选择「本地机器信息认证」，点击「导出注册信息」，如下图所示：

导出的文件名为RegistrationInformation.rif，该文件中存储了报表工程的版本信息。

2.3 获取授权文件

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

商务收到邮件，核实无误后会为用户生成FanRuan.lic文件，以邮件方式发送给用户。

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

2.4 上传 lic 文件

管理员登录数据决策系统，点击「管理系统>注册管理>立即注册」，如下图所示：

认证方式选择「本地机器信息认证」，点击「上传lic文件」，上传上一节获取的 FanRuan.lic 文件。如下图所示：

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

注：FanRuan.lic会自动保存到工程/webroot/WEB-INF/resources 目录下(若为集群工程，该文件存储在集群文件服务器的resources文件夹中。

1）进入工程/webroot/WEB-INF/resources 目录下，删除「FanRuan.lic」文件，如下图所示：

注1：若为集群工程，该文件存储在集群文件服务器的resources文件夹中。

注2：请注意文件服务器类型是否支持后端删除等传输细节（例如minio等S3类型，必须通过浏览器登录前端访问）

2）重启FineReport工程。

11.0.18 之前版本，若注册失败，页面将出现提示弹窗：注册失败，请重新注册。

11.0.18 及之后版本，注册失败提示信息优化，若注册失败，页面将弹窗提示具体的失败原因，并提供相应的解决方案或问题排查步骤。

4.1 单机环境注册失败

若注册失败，页面将弹窗提示具体失败原因，点击「详细信息」按钮，即可查看解决方案或问题排查步骤，如下图所示：

点击「返回」回到注册管理页面，「注册信息」处会显示注册失败和失败原因，点击「查看错误详情」即可查看解决方案或问题排查步骤，如下图所示：

4.2 集群环境注册失败

若注册失败，不同节点的注册失败原因可能不同，页面将弹窗提示每个节点的具体失败原因，点击「详细信息」按钮，即可查看对应的解决方案或问题排查步骤，如下图所示：

点击「返回」回到注册管理页面，「注册信息」处会以列表形式显示每个节点的失败原因，点击「查看错误详情」即可查看对应的解决方案或问题排查步骤，如下图所示：

4.3 失败原因汇总

注册失败原因汇总如下，用户可根据具体失败原因以及错误详情进行问题排查。

注1：除以下失败原因外，其他统一报错：证书内容不正确。

注2：一次注册过程中有多个失败原因时，仅展示第一次失败的原因。

提醒：期限为 15 天，自达到提醒期限开始，超级管理员每次登录管理平台，都会收到平台通知

内容：您的授权许可将于 n 天后过期，请尽快重新授权。如下图所示：