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）若超过最大可注册数，原服务器解除绑定后，新服务器使用原服务器公有云账号注册。
管理员登录数据决策系统，点击「管理系统>注册管理>版本信息」，点击「重新注册>解除绑定」，即可解除旧服务器的绑定。如下图所示：
注：原服务器若不解除绑定，新服务器使用原服务器公有云账号注册时，注册失败，提示：已达可授权数量上限。
