1. 概述
1.1 版本
| 报表服务器版本 | 功能变动 |
|---|---|
| 11.0 | - |
| 11.0.18 | 注册失败提示信息优化，提供具体失败原因和解决方案 |
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. 注册步骤
2.1 确认工程名
打开报表工程所在服务器%FR_HOME%\webapps\目录，确认报表 Web 工程名，默认为webroot。
用户可在注册前根据自身需要修改工程名，注册后将无法修改。
注：此工程名的修改可能会影响模板的超链等设置，请谨慎修改。
修改工程名就是改这个文件夹的名称，修改后，访问工程的地址就变成了http://IP:端口/工程名/decision
2.2 导出注册信息
启动 FineReport 工程所在服务器，管理员访问数据决策系统，点击「管理系统>注册管理」；
在「版本信息」 Tab 页下点击「立即注册」，认证方式选择「本地机器信息认证」，点击「导出注册信息」，如下图所示：
导出的文件名为RegistrationInformation.rif，该文件中存储了报表工程的版本信息。
2.3 获取授权文件
支持两种获取方式：
1）自助注册（推荐）：通过在线自助注册平台，无需等待，自动即刻生成授权文件进行使用，但不支持FineReport&FineBI集成的工程。
2）商务协助：发送邮件给帆软商务，协助生成授权文件，支持任意帆软工程，但需要耐心等待。
2.3.1 自助注册（推荐）
详情请参见：产品正式注册
1）请提前联系帆软销售，确认相关事项并签署合同，并达成回款要求。
2）请使用指定账号登录帆软通行证，并完成企业认证。
3）请在「服务平台-产品注册」页面，选择对应合同，确认注册功能点，进行自助注册，并获取授权文件FanRuan.lic
| 说明 | |
|---|---|
| 0 准备步骤 | 达成自助注册前提： 1）请提前联系帆软销售，确认相关事项并签署合同 2）请确保达成合同约定的回款要求 3）请使用合同约定的指定账号登录帆软通行证 4）请完成企业认证 |
| 1 自助注册入口 | 访问「产品注册」页面 |
| 2 选择合同 | 选择合同，点击「立即注册」 如已注册数达到注册总数，将无法进行在线注册
|
| 3 功能点确认 | 确认已授权功能点与帆软产品合同中注明的功能点一致
|
| 4 进行自助注册 | 1）选择注册方式：本地机器信息注册 2）输入项目名称：为便于贵司授权有问题时查询、维护，请输入项目名称，例如：XX公司XX项目、XX地区XX项目 3）上传注册信息：上传2.2节获取的RegistrationInformation.rif文件
|
| 5 完成注册 | 点击「立即注册」，可获取授权文件FanRuan.lic，点击下载到本地
|
2.3.2 商务协助
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com，邮件格式如下：
商务收到邮件，核实无误后会为用户生成FanRuan.lic文件，以邮件方式发送给用户。
注：若有任何特殊情况，请在邮件中注明。
| 清单 | 内容 | 注意事项 |
|---|---|---|
| 优先联系 | 请提前联系帆软销售，确认相关事项并签署合同 | - |
| 发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册 |
| 收件人 | business@fanruan.com | - |
| 标题 | XXX 公司注册 FineReport 正式授权文件 | 如发送注册信息时，未注明公司名称，则不予注册 |
| 正文 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 注册方式：本地机器信息认证 工程版本：请精确到工程小版本和JAR包信息（在「管理系统-注册管理-版本信息」中可查看） | 其他并发数、用户数等信息，将按照签订的合同进行注册 |
| 附件 | 上述导出的 rif 文件 | 不要打开生成的 RegistrationInformation.rif文件，这会导致文件损坏，如果再将其发送给帆软商务，就会导致注册不成功 |
2.4 上传 lic 文件
管理员登录数据决策系统，点击「管理系统>注册管理>立即注册」，如下图所示：
认证方式选择「本地机器信息认证」，点击「上传lic文件」，上传上一节获取的 FanRuan.lic 文件。如下图所示：
若正确无误，此时会显示注册成功，如下图所示：
注：FanRuan.lic会自动保存到您当前工程%FR-HOME%\webroot\WEB-INF\resources 目录下。
3. 取消注册
1）进入%FR_HOME%/webroot/WEB-INF/resources 目录下，删除「FanRuan.lic」文件，如下图所示：
2）重启FineReport工程。
4. 注册失败
11.0.18 之前版本，若注册失败，页面将出现提示弹窗：注册失败，请重新注册。
11.0.18 及之后版本，注册失败提示信息优化，若注册失败，页面将弹窗提示具体的失败原因，并提供相应的解决方案或问题排查步骤。
4.1 单机环境注册失败
若注册失败，页面将弹窗提示具体失败原因，点击「详细信息」按钮，即可查看解决方案或问题排查步骤，如下图所示：
点击「返回」回到注册管理页面，「注册信息」处会显示注册失败和失败原因，点击「查看错误详情」即可查看解决方案或问题排查步骤，如下图所示：
4.2 集群环境注册失败
若注册失败，不同节点的注册失败原因可能不同，页面将弹窗提示每个节点的具体失败原因，点击「详细信息」按钮，即可查看对应的解决方案或问题排查步骤，如下图所示：
点击「返回」回到注册管理页面，「注册信息」处会以列表形式显示每个节点的失败原因，点击「查看错误详情」即可查看对应的解决方案或问题排查步骤，如下图所示：
4.3 失败原因汇总
注册失败原因汇总如下，用户可根据具体失败原因以及错误详情进行问题排查。
注1：除以下失败原因外，其他统一报错：证书内容不正确。
注2：一次注册过程中有多个失败原因时，仅展示第一次失败的原因。
| 失败类型 | 失败原因 |
|---|---|
| lic本身问题 | lic文件损坏或版本错误 |
| 证书过期 过期时间：xxx | |
| lic文件已被销毁 | |
| lic上传问题 | lic上传失败 |
| lic附件上传失败 | |
| lic文件未通过上传校验 | |
| 硬件问题 | MAC 地址不匹配 本地 MAC 地址：xxx 认证 MAC 地址：xxx |
机器码不匹配 本地机器码：xxx 认证机器码：xxx | |
| 环境问题 | 授权使用的端口 xxx 存在冲突，已达可授权数量上限 |
5. 注册过期提醒
提醒：期限为 15 天，自达到提醒期限开始，超级管理员每次登录管理平台，都会收到平台通知
内容：您的授权许可将于 n 天后过期，请尽快重新授权。如下图所示：
