1. 概述编辑
1.1 版本
| 报表服务器版本 | 功能变动 |
|---|---|
| 11.0 | - |
| 11.0.18 | 注册失败提示优化，提供具体失败原因及解决方案 |
| 11.5 | 注册步骤新增导出和发送工程 ID |
| 11.5.9 | 工程ID与工程注册信息合并导出，精简注册步骤 |
1.2 功能简介
本地机器信息认证通过读取报表工程所在服务器的物理信息，生成唯一标识的 license 文件，从而完成授权注册。
整个流程分为三步：导出服务器的 MAC 地址和机器码、将信息发送给帆软商务获取 license 文件、将 license 文件上传至工程完成注册。
1.3 注意事项
1）服务器物理信息必须固定。若工程部署在容器化环境或虚拟机环境下，物理信息可能随时变化，导致注册失败，请改用其他认证方式。
2）一个正式 license 文件在同一台机器上只能注册一次。若需在同一台机器上注册多个工程，须购买多个 license。
3）一个正式 license 文件仅适用于一台服务器。更换服务器时，需进行注册迁移。
4）同一服务器跨大版本升级（如 10.0 升级至 11.0）后，需进行注册迁移，推荐使用 授权迁移插件。
5）请确保工程使用 JDK 1.8，且小版本在 JDK 8u200 及以上。
6）MAC 地址不允许为空或设置为不限。正式 license 文件强制校验 MAC 地址，为空则注册必然失败。
2. 注册步骤编辑
2.1 确认工程名
1）打开工程安装目录%FR_HOME%/webapps，查看当前工程文件夹名称，默认为 webroot。
2）如需自定义工程名，请在注册前完成。注册完成后将无法再修改工程名。
注：修改工程名可能影响模板中的超链等配置，请在修改前确认相关影响并做好备份。
修改后，访问工程的地址变为 http://IP:端口/工程名/decision。
2.2 导出工程ID信息（11.5~11.5.8版本必做）
11.5~11.5.8版本 FineReport 工程需完成此操作，其他版本请跳过。
1）以管理员身份登录 FineReport 系统，依次点击「管理系统 > 注册管理」。
2）在工程信息 > 应用工程 ID 右侧，点击「导出ID」按钮。
3）系统生成并下载「appID.rif」文件，该文件包含工程的唯一 ID 信息。
2.3 导出注册信息
1）以管理员身份登录 FineReport 系统，依次点击「管理系统>注册管理」。
2）在「注册信息>版本注册」右侧，点击「立即注册」按钮。
3）认证方式选择「本地机器信息认证」，点击「导出注册信息」按钮。
4）系统生成并下载「RegistrationInformation.rif」文件，该文件包含工程版本和服务器机器信息。11.5.9 及之后版本，该文件还包含工程的唯一 ID 信息。
2.4 获取授权文件
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com。商务核实无误后将生成FanRuan.lic文件并通过邮件返回给客户。
注1：请提前联系帆软销售确认相关事项并签署合同，再发送注册邮件。
注2：若有任何特殊情况，请在邮件中注明。
邮件发送清单
| 清单 | 内容 | 注意事项 |
|---|---|---|
| 发件人 | 合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册 |
| 收件人 | business@fanruan.com | - |
| 标题 | XXX 公司注册 FineReport 正式授权文件 | 如发送注册信息时，未注明公司名称，则不予注册 |
| 正文 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 注册方式：本地机器信息认证 工程版本：精确到工程小版本和JAR包信息（可在管理系统 > 注册管理 > 版本信息中查看） | 其他并发数、用户数等信息，将按照签订的合同进行注册 |
| 附件 | 2.2节导出的appID.rif | 1）仅 11.5~11.5.8 版本的 FineReport 需附上此文件，其他版本无需 2）请勿用任何程序打开 .rif 文件，打开操作会导致文件损坏，损坏后发送给商务将导致注册失败 |
| 2.3节导出的RegistrationInformation.rif | 请勿用任何程序打开 .rif 文件，打开操作会导致文件损坏，损坏后发送给商务将导致注册失败 |
2.5 上传 lic 文件
1）收到商务返回的 FanRuan.lic 文件后，以管理员身份登录 FineReport 系统，依次点击「管理系统>注册管理>立即注册」。
2）认证方式选择「本地机器信息认证」，点击「上传lic文件」，选择 FanRuan.lic 文件上传。
3）上传成功后，页面显示「注册成功」，即完成授权注册。
FanRuan.lic 文件会自动保存到工程 /webroot/WEB-INF/resources 目录下。
集群工程的 lic 文件存储在集群文件服务器的 resources 文件夹中。
3. 取消注册编辑
1）删除 lic 文件：进入 工程/webroot/WEB-INF/resources 目录，删除 FanRuan.lic 文件。
注1：集群工程的 lic 文件存储在集群文件服务器的 resources 文件夹中。
注2：使用 MinIO 等 S3 类型文件服务器时，不支持直接在后端删除文件，须通过浏览器登录文件服务器前端进行删除操作。
2）重启工程：重启 FineReport 工程，使取消注册生效。
4. 注册失败编辑
11.0.18 之前的版本，注册失败时页面仅提示「注册失败，请重新注册」，不显示具体原因。
11.0.18 及之后的版本，注册失败时页面会弹窗提示具体失败原因，并提供对应的解决方案或排查步骤。
4.1 单机环境注册失败
注册失败后，页面弹窗显示具体失败原因。点击「详细信息」按钮，可查看解决方案或排查步骤。
点击「返回」后，注册管理页面的「注册信息」区域也会显示失败原因，点击查看错误详情可再次查看解决方案。
4.2 集群环境注册失败
集群环境下，不同节点的注册失败原因可能不同。页面弹窗会分节点展示每个节点的具体失败原因，点击对应节点的详细信息按钮，可查看该节点的解决方案或排查步骤。
点击返回后，注册管理页面会以列表形式展示各节点的失败原因，点击查看错误详情可查看对应解决方案。
4.3 失败原因汇总
除下表所列原因外，其他情况统一报错「证书内容不正确」。
一次注册过程中存在多个失败原因时，页面仅展示第一个失败原因。
| 失败类型 | 失败原因 |
|---|---|
| lic本身问题 | lic文件损坏或版本错误 |
| 证书过期 过期时间：xxx | |
| lic文件已被销毁 | |
| lic上传问题 | lic上传失败 |
| lic附件上传失败 | |
| lic文件未通过上传校验 | |
| 工程信息问题 | MAC 地址不匹配 本地 MAC 地址：xxx 认证 MAC 地址：xxx |
机器码不匹配 本地机器码：xxx 认证机器码：xxx | |
工程中和lic中的应用工程ID不匹配 工程中的应用工程ID：xxxx lic中的应用工程ID：xxxx | |
| 环境问题 | 授权使用的端口 xxx 存在冲突，已达可授权数量上限 |
5. 注册过期提醒编辑
授权到期前 15 天开始提醒。在此期间，超级管理员每次登录帆软平台时，系统会推送通知：您的授权许可将于 n 天后过期，请尽快重新授权。
收到提醒后，请及时联系帆软商务续期，避免授权到期后影响正常使用。
