1. 概述
1.1 版本
| FineBI服务器版本 |
|---|
| 7.0 |
1.2 功能简介
本地机器信息认证操作简单，十分方便。
用户通过导出 rif 文件，获取 mac 地址和机器码，来生成一个唯一标识的 license 文件。
1.3 注意事项
1）本地机器信息认证，需要 FineBI 工程所在服务器的物理信息固定。如不固定，不适合使用该注册方法。
例如要 FineBI 工程部署在虚拟机环境下，虚拟机环境下物理信息可能变化，造成注册失败，请选取其他注册方式。
2）一个正式 license 文件在一台机器上只能注册一次，若需要在同一台机器上注册多个工程，则需要购买多个 license 。
3）一个正式 license 文件只适用于一台服务器，如需更换服务器，需要进行注册迁移。
4）同一服务器下跨大版本升级（6.0 升级7.0）后，需要进行注册迁移。
5）请确保工程使用 JDK 1.8 且小版本需在 JDK8u200 以上。
6）Mac 地址不允许设置为空，不允许不限。因为正式 license 文件强制校验 Mac 地址，为空则一定会注册失败。
2. 注册步骤
2.1 确认工程名
管理员登录运维平台，在「开发者模式」下，通过「变更访问路径」，即可查看FineBI的工程名，默认为webroot。
用户可在注册前根据自身需要修改工程名，注册后将无法修改。
注：此工程名的修改可能会影响模板的超链等设置，请谨慎修改。
修改后，访问工程的地址就变成了http://IP:端口/工程名/decision
2.2 导出工程ID信息
1）管理员登录 FineBI 系统，点击「管理系统>注册管理」。
2）在「工程信息>应用工程ID」后，点击「导出ID」按钮。
3）导出的文件名为「appID.rif」，该文件中存储了工程的ID信息。
2.3 导出工程注册信息
1）管理员登录 FineBI 系统，点击「管理系统>注册管理」。
2）在「注册信息>版本注册」后，点击「立即注册」/「重新注册」按钮。
3）认证方式选择「本地机器信息认证」，点击「导出注册信息」/「导出集群注册信息」。
4）导出的文件名为「RegistrationInformation.rif」，该文件中存储了工程的版本和机器信息。
2.4 获取授权文件
请使用合同中指定的邮箱发送注册信息给 FineBI 商务business@fanruan.com，邮件格式如下：
商务收到邮件，核实无误后会为您生成一个FanRuan.lic授权文件，以邮件方式发送给您。
注1：若有任何特殊情况，请在邮件中注明。
注2：临时注册建议直接通过「帆软软件-临时授权自助导航」入口申请。
| 清单 | 内容 | 注意事项 | |
|---|---|---|---|
| 优先联系 | 请提前联系帆软销售，确认相关事项并签署合同 | ||
| 发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册 | |
| 收件人 | business@fanruan.com | - | |
| 标题 | XXX 公司注册 FineBI 正式授权文件 | 如发送注册信息时，未注明公司名称，则不予注册 | |
| 正文 | 基础信息 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 | 其他并发数、用户数等信息，将按照签订的合同进行注册 |
| 注册方式 | 本地机器信息认证 | - | |
| BI引擎节点数 | 允许注册的bi-engine-worker引擎总数 「管理系统>系统管理>引擎集群管理」中可查看，worker数量=节点总数-1 | 若不提供该选项，则以合同为准 若提供的引擎数超出合同范围，则以合同为准 若合同未规定节点数，则默认为1 | |
| 附件 | rif文件 | 上述2.2节和2.3节导出的 rif 文件 1）appID.rif 2）RegistrationInformation.rif | 不要打开生成的 appID.rif 和 RegistrationInformation.rif文件，这会导致文件损坏，如果再将其发送给帆软商务，就会导致注册不成功 |
| 工程版本信息 | 管理员登录FineBI系统，点击「管理系统>注册管理>版本信息」，查看版本信息。 请将此页面完整截图，作为附件发送
| ||
| BI引擎信息 | 管理员登录FineBI系统，点击「管理系统>系统管理>引擎集群管理」，查看bi-engine-worker数量。 请将此页面完整截图，作为附件发送
| ||
2.5 上传lic文件
收到商务返回的 FanRuan.lic 文件后，管理员登录FineBI系统，点击「管理系统>注册管理>版本信息」。
点击「立即注册」，认证方式选择「本地机器信息认证」，点击「上传lic文件」，上传上一节获取的 FanRuan.lic 文件。如下图所示：
若正确无误，此时会显示注册成功，如下图所示：
注：FanRuan.lic会自动保存到当前工程 /webroot/WEB-INF/resources 目录下。
3. 取消注册
1）进入 FineBI 文件服务器中，在/WEB-INF/resources目录下，删除「FanRuan.lic」文件
注：请注意文件服务器类型是否支持后端删除等传输细节（例如minio等S3类型，必须通过浏览器登录前端访问）
2）使用运维平台的「组件管理」功能，重启 FineBI 应用节点，取消注册成功。
4. 注册失败
4.1 现象描述
若注册失败，页面将出现提示弹窗，如下图所示：
4.2 失败原因
点击详细信息即可查看注册失败的原因，根据具体失败原因进行排查。
| 失败原因 | 具体提示 |
|---|---|
| 证书已过期 | 过期时间：2019-02-22 |
| 版本不匹配 | 认证应用版本：9.0 本地应用版本：10.0 |
| MAC 地址不匹配 | 认证 MAC 地址：xxx 本地 MAC 地址：xxx |
| 机器码不匹配 | 认证机器码：xxx 本地机器码：xxx |
| 应用名不匹配 | 认证应用名：xxx 本地应用名：xxx |
| 已达可授权数量上限 | 证书已被同服务器上其他工程使用 |
| 工程内容不匹配 | 认证工程内容：xxx 本地工程内容：xx |
注：除上述外失败原因外，其他统一报错：证书内容不正确。
有多个失败原因时，平台中会全部显示出来。
上一篇：服务凭证
