1. 概述
1.1 版本
报表服务器版本 | 功能变动 |
---|---|
11.0 | - |
11.0.18 | 注册失败提示优化,提供具体失败原因,帮助用户排查问题 |
1.2 应用场景
用户需要注册多个工程,多次导出工程信息十分麻烦,又不想本地搭建授权服务器。
帆软搭建了一个公有云认证服务器,客户通过填写认证信息发起授权请求,发送至公有云认证服务器,统一验证授权。
1.3 功能简介
公有云注册方式有以下几个特点:
1)报表工程进行公有云注册,将不受物理信息限制,物理信息变化不会导致注册失败。
2)客户报表服务器必须与授权服务器通过公网连通,不允许开放外网的客户无法使用该注册方式。
需要开放的外网地址包括:
域名 | 端口 | 说明 |
---|---|---|
https://register.fanruan.com | 443 | 公有云认证服务器 |
https://cloud.fanruan.com | 443 | 网址管理中心 |
3)注册方式简便易操作,基本不会发生注册失败的情况。
4)用户申请一个授权,可注册多个工程,价格按照「最大可注册量」产生波动。
可以在任意报表服务器注册,较为灵活。
1.4 注意事项
报表工程会每 2 小时向公有云认证服务器进行一次查询认证,若连续 12 次(即 24 小时后)认证失败,则报表工程显示注册失败,需重新输入账号密码进行注册。
11.0.18 及之后版本,将在「管理系统>注册管理」页面内以列表形式显示每次认证的失败时间和失败原因,帮助用户排查问题,如下图所示:
注:集群环境下,每个节点的失败原因可能不同,将显示每个节点的失败原因。
2. 注册步骤
2.1 获取授权
支持两种获取方式:
1)自助注册(推荐):通过在线自助注册平台,无需等待,自动即刻生成授权文件进行使用,但不支持FineReport&FineBI集成的工程。
2)商务协助:发送邮件给帆软商务,协助生成授权文件,支持任意帆软工程,但需要耐心等待。
2.1.1 自助注册(推荐)
详情请参见:产品正式注册
1)请提前联系帆软销售,确认相关事项并签署合同,并达成回款要求。
2)请使用指定账号登录帆软通行证,并完成企业认证。
3)请在「服务平台-产品注册」页面,选择对应合同,确认注册功能点,进行自助注册,并获取公有云账号和密码。
说明 | |
---|---|
0 准备步骤 | 达成自助注册前提: 1)请提前联系帆软销售,确认相关事项并签署合同 2)请确保达成合同约定的回款要求 3)请使用合同约定的指定账号登录帆软通行证 4)请完成企业认证 |
1 自助注册入口 | 访问「产品注册」页面 |
2 选择合同 | 选择合同,点击「立即注册」 如已注册数达到注册总数,将无法进行在线注册 |
3 功能点确认 | 确认已授权功能点与帆软产品合同中注明的功能点一致 |
4 进行自助注册 | 1)选择注册方式:公有云注册 2)设定登录账号: 请设定贵司希望使用的登录账号名称,若账号名称已被占用则不可使用 密码由帆软在注册成功后自动生成,无法固定 3)输入注册工程数:即集群工程节点个数,单机输入1,不可大于剩余可注册工程数 |
5 完成注册 | 点击「立即注册」,可获取公有云账号和密码,点击支持复制。 |
2.1.2 商务协助
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com,邮件格式如下:
商务收到邮件,核实无误后会为用户生成账号和密码,以邮件方式发送给用户。
注:若有任何特殊情况,请在邮件中注明。
清单 | 要求 | 注意事项 | |
---|---|---|---|
优先联系 | 请提前联系帆软销售,确认相关事项并签署合同 | - | |
发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱,非合同中指定的邮箱,则不予注册 | |
收件人 | business@fanruan.com | - | |
标题 | XXX 公司注册 FineReport 正式授权文件 | 如发送注册信息时,未注明公司名称,则不予注册 | |
正文 | 基础信息 | 公司名称:XXX 公司 项目名称:XXX 项目 合同签定日期:XXXX年XX月XX日 | - |
注册方式 | 公有云认证 | - | |
最大可注册量 | 允许注册的工程数 | 若不提供该选项,则默认为1 可在部署成功后,在注册管理页面「最大连接数」中查看 | |
工程版本 | 请精确到工程小版本和JAR包信息 在「管理系统-注册管理-版本信息」中可查看 | - | |
账号 | 公有云账号名 | 如需指定公有云账号名,请在邮件中注明该项,若账号名已被占用则不可使用 如不指定/指定不可用公有云账号名,商务将为您随机生成一个账号 |
2.2 验证注册
管理员登录数据决策系统,点击「管理系统>注册管理>立即注册」,如下图所示:
认证方式选择「公有云认证」,输入商务发送邮件中的账号和密码,点击「提交认证」,认证成功。如下图所示:
默认采用 RSA 对公有云密码进行加密存储,若切换加密算法,同步进行密码更新。
3. 注册失败
11.0.18 之前版本,若注册失败,页面将出现提示弹窗:认证失败,请重新认证。
11.0.18 及之后版本,注册失败提示信息优化,若注册失败,页面将弹窗提示具体失败原因,用户可根据提示信息进行排查。
3.1 单机环境注册失败
若注册失败,页面将弹窗提示具体失败原因,点击「详细信息」按钮,即可查看具体失败原因或问题排查方案,如下图所示:
点击「返回」回到注册管理页面,「注册信息」处会显示注册失败和失败原因,点击「查看错误详情」即可查看具体失败原因或问题排查方案,如下图所示:
3.2 集群环境注册失败
若注册失败,不同节点的注册失败原因可能不同,页面将弹窗提示每个节点的具体失败原因,点击「详细信息」按钮,即可查看具体失败原因或问题排查方案,如下图所示:
点击「返回」回到注册管理页面,「注册信息」处会以列表形式显示每个节点的失败原因,点击「查看错误详情」即可查看对应的失败原因或问题排查方案,如下图所示:
3.3 失败原因
注册失败原因汇总如下,用户可根据具体失败原因或错误详情中提示的排查方案进行排查。
注1:除以下外失败原因外,其他统一报错:证书内容不正确。
注2:一次注册过程中有多个失败原因时,仅展示第一次失败的原因。
错误码 | 错误名 | 含义 |
---|---|---|
10000 | JSON_PARSER_ERROR | 数据格式不正确 |
10001 | PARAM_INPUT_ERROR | 您输入的参数有误 |
20000 | DO_NOT_NEED_DEACTIVATE | 该机器未授权无需解除绑定(解除绑定的时候出现该提示,说明这台机器因未授权无需解除绑定) |
20001 | MYSQL_UPDATE_ERROR | 更新 MYSQL 数据库出错 |
20002 | REDIS_UPDATE_ERROR | 往 REDIS 数据库里插入数据出错 |
30000 | LICENSE_EXPIRED | 证书已过期 |
30001 | REPORT_VERSION_ERROR | 版本不匹配 |
30002 | ACCOUNT_STATUS_ERROR | 账户状态不正常 |
30003 | LICENSE_IP_ERROR | IP 不在允许的范围之内 |
30004 | LICENSE_DOMAIN_ERROR | 域名不在允许的范围之内 |
30005 | LICENSE_APPNAME_ERROR | 应用名不在允许的范围之内 |
30006 | ACCOUNT_INPUT_ERROR | 该账户和密码并未被授权 |
30007 | REGISTER_OUT_OF_LIMIT | 已达可授权数量上限 |
- | 工程服务器与云注册服务器连接失败 | - |
4. 注册迁移
获取授权时,注明了最大可注册量。
1)服务器数量不超过最大可注册数时,可直接使用原服务器公有云账号在新服务器注册。
2)若超过最大可注册数,原服务器解除绑定后,新服务器使用原服务器公有云账号注册。
管理员登录数据决策系统,点击「管理系统>注册管理>版本信息」,点击「重新注册>解除绑定」,即可解除旧服务器的绑定。如下图所示:
注:原服务器若不解除绑定,新服务器使用原服务器公有云账号注册时,注册失败,提示:已达可授权数量上限。