反馈已提交

网络繁忙

注册常见问题

  • 文档创建者:文档助手1
  • 历史版本:19
  • 最近更新:Suki陈 于 2022-12-28
  • 1. 概述

    本文将主要介绍不同注册方式下,系统注册出现问题的原因和解决方案。

    2. Lic上传卡住

    问题描述:

    上传注册Lic文件时,卡在上传中的页面无进展。

    排查步骤:

    进入工程%FR_HOME%/webroot/WEB-INF/resources 目录下,查看「FanRuan.lic」文件的修改时间,判断文件是否成功上传。

    1)文件未成功上传

    原因分析:若文件未成功上传,一般是由于系统禁用了PUT请求,导致请求不正常

    解决方案:用户可通过安装「PUT、DELETE请求转成POST」插件,将 PUT、DELETE 请求转成 POST 请求。详情请参见:PUT、DELETE请求转成POST插件

    2)文件成功上传

    原因分析:若文件成功上传,可能是前台没有及时刷新。

    解决方案:手动刷新下平台页面,查看是否显示注册成功。若仍未成功注册,请根据注册失败的报错信息参考下文解决。

    3. Lic上传失败

    问题描述:

    上传注册Lic文件时,弹窗报错「文件 FanRuan.lic不能通过校验,请检查他。」

    解决方案:

    管理员登录数据决策系统,点击「管理系统>安全管理>安全防护」,临时关闭「文件上传校验」,待注册成功后再打开。

    4. 证书已过期

    问题描述:

    注册时,提示「注册失败,请重新注册」。点开详细信息,提示:

    过期时间:xxxx-xx-xx

    原因分析:

    当前工程使用的注册Lic文件,已到达合同约定的过期时间。

    解决方案:

    1)若确定已达到合同约定的过期时间,请联系销售进行续购。

    2)若合同约定的过期时间还未到,但lic已过期,请联系销售重新索要正确的注册Lic文件。

    5. 版本不匹配

    问题描述:

    注册时,提示「注册失败,请重新注册」。点开详细信息,提示:

    • 认证应用版本:9.0

    • 本地应用版本:10.0

    原因分析:

    帆软有两种版本升级情况,大版本(9升10,10升11)和小版本(10.0.1升10.0.2)

    1)大版本升级影响授权

    跨大版本升级,例如从 9.0 升级到 10.0 ,会对授权文件有影响,需要重新注册或迁移授权。

    2)小版本升级不影响授权

    小版本之间的升级,例如从 10.0.9 升级到 10.0.10 ,对授权文件无影响。

    解决方案:

    1)若为全新注册,且合同约定的工程版本与产品版本一致,请联系销售重新索要正确的注册Lic文件。

    2)若为升级的新工程,不能直接使用老工程的注册Lic文件,请联系销售确定升级后的授权迁移相关事项。

    6. MAC地址不匹配

    问题描述:

    注册时,提示「注册失败,请重新注册」。点开详细信息,提示:

    认证 MAC 地址:xxx

    本地 MAC 地址:xxx

    排查步骤:

    MAC 地址,用于在网络中唯一标示一个网卡。一台设备可以有多个网卡,每个网卡都有唯一的 MAC 地址。

    注册 Lic 文件中的 MAC 地址,必须能与服务器的任意一个 MAC 地址匹配。

    Linux 或 Unix 系统的 MAC 地址格式和一般的MAC形式不一样,比如为 0*001F296EFD64。

    服务器系统
    部署方式原因分析和解决方案
    Windows-

    原因分析:更换了网卡,导致MAC地址变更

    解决方案:请联系商务重新授权

    原因分析:手动修改了工程所在服务器的MAC地址

    解决方案:

    方案一:把MAC地址改回来

    方案二:联系商务重新授权

    Linuxdocker部署

    原因分析:

    若未固定 docker 的 MAC 地址和 UUID,重启会随机改变MAC地址

    解决方案:

    1)docker部署,建议固定MAC地址

    2)不绑定MAC地址,建议使用私有云/公有云认证

    虚拟机

    原因分析:

    虚拟机的MAC地址分为三种:

    1)固定MAC地址:可以配置固定的MAC地址,重启不变。

    2)继承宿主机MAC地址:和宿主机MAC地址保持一致,重启不变。

    3)动态MAC地址:前缀相同,后四位随机变动,重启改变。

    解决方案:

    1)确认近期是否更换宿主机硬件或重装系统,若更换会导致MAC地址变更,请联系商务重新授权

    2)若虚拟机为动态MAC地址,建议使用私有云/公有云认证

    物理机


    原因分析:

    使用脚本重启,脚本中没有切换 root 用户, 或者访问对应命令的权限。

    解决方案:

    尽量使用root用户启动并给与访问对应命令的权限

    原因分析:

    Linux系统的中间件(如Tomcat),以root和非root用户启动,MAC地址会不一样

    解决方案:

    尽量使用root用户启动并且保持一致

    7. 机器码不匹配

    问题描述:

    注册时,提示「注册失败,请重新注册」。点开详细信息,提示:

    • 认证机器码:xxx

    • 本地机器码:xxx

    排查步骤:

    因素
    原因分析和解决方案
    系统硬件

    原因分析:更换了硬件,如cpu,硬盘,主板等,都会导致机器码变化

    解决方案:请联系商务重新授权

    JDK

    原因分析:机器码的读取是依赖JDK的,JDK更换可能会导致机器码变化

    解决方案:修改回原先的JDK,修改回原先的环境变量

    虚拟机

    原因分析:虚拟机重启会导致机器码变化

    解决方案:请联系商务重新授权

    虚拟机不建议使用本地机器信息认证,建议使用私有云/公有云认证

    权限

    原因分析:Linux系统的中间件(如Tomcat),以root和非root用户启动,机器码会不一样,甚至获取不到

    解决方案:尽量使用root用户启动并且保持一致

    云系统

    原因分析:修改配置就会导致机器码变化

    解决方案:请联系商务重新授权

    虚拟机不建议使用本地机器信息认证,建议使用私有云/公有云认证

    8. 应用名不匹配

    问题描述:

    注册时,提示「注册失败,请重新注册」。点开详细信息,提示:

    • 认证应用名:xxx

    • 本地应用名:xxx

    原因分析:

    工程地址形如http://ip:port/工程名/decision,工程名一般为webroot

    当出现该报错时,一般都是由于工程名被改动了

    解决方案:

    在给商务发送授权申请邮件时:

    • 若备注了工程名,那么返回的注册Lic文件就是邮件中备注的工程名

    • 若未备注工程名,那么返回的注册Lic文件对应的工程名为webroot

    请将工程的用户名修改成与注册Lic文件一致。

    9. 已达可授权数量上限

    问题描述:

    注册时,提示「注册失败,请重新注册」。点开详细信息,提示:

    超过最大注册数量

    排查步骤:

    注册方式因素
    原因分析和解决方案
    本地机器认证服务器下存在多个工程

    原因分析:

    工程所在服务器下,存在其他工程,占用了该注册Lic文件。

    解决方案:

    检查工程所在服务器下的其他工程%FR_HOME%/webroot/WEB-INF/resources目录下,查看「FanRuan.lic」文件的修改时间。

    若为新增的注册Lic文件,删除后,进入到正确的工程重新注册即可。

    工程重复加载

    原因分析:

    Tomcat域名配置不正确,在Tomcat的server.xml中配置了两个<host>,一个域名一个ip,该配置方式导致工程重复启动两次,所以lic会报错已占用。

    解决方案:

    删除xml中ip的<host>,只保留域名的<host>,ip还是可以正常访问的,不需要单独配ip。

    指定启动路径

    原因分析:

    server.xml中配置了虚拟路径,导致工程二次重启了。

    解决方案:

    Tomcat设置报表工程访问路径的正确方式请参见:Tomcat设置报表工程访问路径

    方案一:注释掉server.xml中docBase配置,重启后即可正常注册。

    方案二:将webroot工程移动到webapps文件夹外的路径,然后指定对应路径,重启后即可正常注册。

    服务器上安装的设计器也进行了注册原因分析:
    服务器上安装了设计器(多出现在windows服务器上),设计器也用相同的Lic文件进行了注册。
    解决方案:
    关闭设计器,给工程重新注册,然后移除设计器安装目录下%FR_HOME%/webroot/WEB-INF/resources文件夹中的「FanRuan.lic」文件。
    公有云工程占用授权

    原因分析:

    申请公有云授权时,会提交一个最大可注册量

    如果超出了这个最大可注册量,就会出现此报错

    解决方案:

    将老工程上的授权手动解绑,再到新工程上绑定

    物理信息变更

    原因分析:

    虚拟机重启,物理信息变更,导致达到注册上线

    请联系技术支持,确认名下是否存在占用公有云注册数的工程

    解决方案:

    请技术支持协助解绑,再进行工程绑定

    10. 证书内容不正确

    问题描述:

    注册时,提示「注册失败,请重新注册」。点开详细信息,提示:

    证书内容不正确

    排查步骤:

    因素
    原因分析和解决方案
    用户权限

    原因分析:

    启动工程的用户,没有写文件的权限,配置777权限,日志报错: [Resource] Write failed!

    解决方案:

    重新配置写权限即可,或尽量使用root用户启动

    重复运行迁移程序

    原因分析:

    在授权迁移时,第一次运行迁移程序成功后,会产生一个新授权。

    使用新授权注册成功后,若再次运行迁移程序,会将当前已正式注册的授权销毁。

    解决方案:

    请联系商务重新授权

    更多原因

    出现该报错的更多情况,都需要根据工程实际情况一一排查,建议联系技术支持

    技术支持联系方式:

    • 在线支持:前往「服务」,选择「在线支持」

    • 电话:400-811-8890

    11. 本地容器认证

    11.1 节点已经全部重启

    问题描述:

    工程本地容器认证,重启后注册页报错,提示「节点已经全部重启」。

    原因分析:

    重启服务器后,本地容器认证就是需要重新注册,产品设计如此。

    解决方案:

    重新手机扫码认证即可。

    11.2 错误码40002,lic已在其他机器注册

    问题描述:

    修改了服务器的配置库后,重启服务器,再用手机扫码认证。

    提示「错误码40002,lic已在其他机器注册」。

    原因分析:

    修改配置库后,本地容器认证需要重新注册。

    解决方案:

    请联系商务取消原服务器的注册授权,再次使用商务发送的 Container.lic 文件进行注册。

    12. 私有云认证程序启动异常

    认证程序启动时,会出现各种报错信息,请按照具体报错排查

    报错

    已卸载认证服务器之前卸载过,如需再次在同一授权服务器使用认证服务器,需重新获取机器信息重新注册
    已过期

    跟系统时间有关系

    如注册时的系统时间是12-21-16:18:55,私有云生效的时间是12-21-16:40:29

    错误码30002

    账户状态不正常

    1)销毁原认证服务器后,没有重新生成新的机器信息,而是直接使用了原机器信息,造成rif机器信息文件中sessionid重复

    2)跟执行启动命令权限有关系,推荐root运行

    address already in use

    端口被占用。重新换接口启动认证程序:

    使用命令行启动程序的时候后面加参数-port端口指定另外端口

    • Windows下例如:.srever.exe -port 8090

    • Linux/Mac下例如:./server -port 8090

    13. 公有云认证

    13.1 网络问题

    1)客户报表服务器必须与授权服务器通过公网连通,不允许开放外网的客户无法使用该注册方式。

    需要开放的外网地址包括:

    域名
    端口说明
    https://register.fanruan.com443公有云认证服务器
    https://cloud.fanruan.com443网址管理中心

    2)连接网址管理中心未开启,导致工程无法联网。

    管理员登录数据决策系统,点击「管理系统>系统管理>常规」,开启「连接网址管理中心」。如下图所示:

    13.2 系统时间问题

    原因分析:工程服务器上的系统时间与当前实际的时间不一致。

    解决方案:把服务器的系统时间修改为当前对应的时间即可。

    13.3 账号存在特殊字符

    原因分析:公有云账号不支持中文和中文标点符号。

    解决方案:联系商务更换公有云账号。

    14. 达到限制值

    注册时,会对注册时间、数据连接数、并发数、用户数进行限制。若达到限制值,则会出现报错或异常状态。

    若当前系统已注册,超级管理员登录数据决策系统,在当前页下访问http://IP:端口/webroot/decision/v10/register/info/license,即可查看注册时的限制值。如下图所示:

    • 若数据连接数达到限制值,则将无法添加数据连接,新添加的数据连接不显示。

    • 若并发数达到限制值,则后登录的 IP 地址将无法登录。

    • 若注册为永久注册,过期时间为100年后。100年过期后,请联系帆软商务进行免费注册。

    • 若更换服务器硬件,有可能造成机器码更改,从而导致注册失效。

    • 若更改报表工程名,会导致工程名不一致,从而导致注册失效。

    • 若用户数达到限制值,则将无法添加用户,新添加的用户报错「与其他管理员操作冲突,请刷新后重试」。

    • 若分布式节点数达到限制值,则将无法新增节点,新添加的节点不显示。

    image.png

    15. 缺少功能点

    若使用 FineReport 时,发现某些功能不可用,直接报错或者打不开,出现类似报错:您使用了未注册的功能。如下图所示:

    注:功能点的影响请参见:注册管理

    这是由于注册时未购买某些功能点。在「数据决策系统>管理系统>注册管理>功能列表」中,可以查看到已注册的功能点,如下图所示:

    如需新增购买某些功能点,请联系帆软商务,商务邮箱 business@fanruan.com

    16. 多种注册并存

    当服务器同时拥有 license 授权文件和加密锁,则以 license 授权文件为主。

    因为服务器首先会去读取 license 授权文件,若授权文件不存在才会读取加密锁,因此 MAC 地址注册的优先级高于加密锁注册。

    17. license 文件没有生效导致图表显示空白

    使用新的 license 文件后,设计器预览图表显示空白?

    因为将获取的 FanRuan.lic 文件放到报表工程%FR-HOME%\webroot\WEB-INF\resources目录下,没有重新启动 Web 服务器,导致图表不能预览。

    所以使用 license 文件必须重新启动 Web服务器,license 才能生效。

    18. 报空指针错误

    在预览一些模板时,报 java.lang.NullPointException 空指针异常。

    因为该模板中包含了一些 license 文件中不包含的功能。

    附件列表


    主题: 部署集成
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持