1. 概述
1.1 版本
FineDataLink 版本 | 功能变动 |
---|---|
1.9 | - |
4.0.28 | 注册失败提示信息优化,提供具体失败原因和解决方案 |
1.2 功能简介
本地机器信息认证是最常见的认证方式,操作简单,十分方便。
FineDataLink 工程所在服务器的物理信息固定,用户通过导出 rif 文件,获取 mac 地址和机器码,来生成一个唯一标识的 license 文件。
1.3 注意事项
1)本地机器信息认证,需要 FineDataLink 工程所在服务器的物理信息固定。如不固定,不适合使用该注册方法。
例如要 FineDataLink 工程部署在虚拟机环境下,虚拟机环境下物理信息可能变化,造成注册失败,请选取其他注册方式。
2)一个正式 license 文件在一台机器上只能注册一次,若需要在同一台机器上注册多个工程,则需要购买多个 license 。
3)一个正式 license 文件只适用于一台服务器,如需更换服务器,需要进行注册迁移。
4)请确保工程使用 JDK 1.8 且小版本需在 JDK8u200 以上。
6)Mac地址不允许设置为空,不允许不限。因为正式 license 文件强制校验Mac地址,为空则一定会注册失败。
2. 注册步骤
2.1 确认工程名
打开 FineDataLink 工程所在服务器%Tomcat_HOME%\webapps\目录,确认FineDataLink Web 工程名,默认为webroot。
用户可在注册前根据自身需要修改工程名,注册后将无法修改。
注:此工程名的修改可能会影响模板的超链等设置,请谨慎修改。
修改工程名就是改这个文件夹的名称,修改后,访问工程的地址就变成了http://IP:端口/工程名/decision
2.2 导出注册信息
1)管理员登录 FineDataLink ,点击「管理系统>注册管理>立即注册」,如下图所示:
2)认证方式选择「本地机器信息认证」,点击「导出注册信息」,如下图所示:
导出的文件名为RegistrationInformation.rif,该文件中存储了 FineDataLink 工程的版本信息。
2.3 给商务发送邮件
请使用合同中指定的邮箱发送注册信息给 FineDataLink 商务business@fanruan.com,邮件格式如下:
清单 | 内容 | 注意事项 |
---|---|---|
优先联系 | 请提前联系帆软销售,确认相关事项并签署合同 | - |
发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱,非合同中指定的邮箱,则不予注册 |
收件人 | business@fanruan.com | - |
标题 | XXX 公司注册 FineDataLink 正式授权文件 | 如发送注册信息时,未注明公司名称,则不予注册 |
正文 | 公司名称:XXX 公司 项目名称:XXX 项目 合同签定日期:XXXX年XX月XX日 注册方式:本地机器信息认证 工程版本:请精确到工程小版本和JAR包信息(在「管理系统-注册管理-版本信息」中可查看) | 其他并发数、用户数等信息,将按照签订的合同进行注册 |
附件 | 上述导出的 rif 文件 | 不要打开生成的 RegistrationInformation.rif文件,这会导致文件损坏,如果再将其发送给帆软商务,就会导致注册不成功 |
2.4 获取授权文件进行注册
商务收到邮件,核实无误后会为用户生成FanRuan.lic文件,以邮件方式发送给用户。
点击「管理系统>注册管理>版本信息」,点击「上传lic文件」,上传 FanRuan.lic 授权文件。如下图所示:
认证成功后,效果如下图所示:
注:FanRuan.lic会自动保存到您当前工程%FDL-HOME%\webroot\WEB-INF\resources 目录下。
3. 取消注册
1)进入%HOME%/webroot/WEB-INF/resources 目录下,删除「FanRuan.lic」文件。如下图所示:
2)重启 FineDataLink。
4. 注册失败
4.0.28 之前版本,若注册失败,页面将出现提示弹窗:认证失败,请重新认证。
4.0.28 及之后版本,注册失败提示信息优化,若注册失败,页面将弹窗提示具体失败原因,用户可根据提示信息进行排查。
4.1 单机环境注册失败
若注册失败,页面将弹窗提示具体失败原因,点击「详细信息」按钮,即可查看解决方案或问题排查步骤,如下图所示:
点击「返回」回到注册管理页面,「注册信息」处会显示注册失败和失败原因,点击「查看错误详情」即可查看解决方案或问题排查步骤,如下图所示:
4.2 集群环境注册失败
若注册失败,不同节点的注册失败原因可能不同,页面将弹窗提示每个节点的具体失败原因,点击「详细信息」按钮,即可查看对应的解决方案或问题排查步骤,如下图所示:
点击「返回」回到注册管理页面,「注册信息」处会以列表形式显示每个节点的失败原因,点击「查看错误详情」即可查看对应的解决方案或问题排查步骤,如下图所示:
4.3 失败原因汇总
点击详细信息即可查看注册失败的原因,根据具体失败原因进行排查。
注1:除以下失败原因外,其他统一报错:证书内容不正确。
注2:一次注册过程中有多个失败原因时,仅展示第一次失败的原因。
失败类型 | 失败原因 |
---|---|
lic本身问题 | lic文件损坏或版本错误 |
证书过期 过期时间:xxx | |
lic文件已被销毁 | |
lic上传问题 | lic上传失败 |
lic附件上传失败 | |
lic文件未通过上传校验 | |
硬件问题 | MAC 地址不匹配 本地 MAC 地址:xxx 认证 MAC 地址:xxx |
机器码不匹配 本地机器码:xxx 认证机器码:xxx | |
环境问题 | 授权使用的端口 xxx 存在冲突,已达可授权数量上限 |