GBase 8s V8.8 版本授权(license)激活操作说明

1、文档概述

本文档面向GBase 8s V8.8 数据库用户、实施工程师、运维管理人员，详细说明授权文件的适用范围、默认授权规则、授权变更操作、授权信息查看与字段释义，用于指导用户合规申请、部署与管理数据库授权，保障产品功能正常使用。

GBase 8s 授权由发行码 + 服务码共同控制，发行码控制产品发放功能，数据库安装成功后需生成服务码并在官网注册完成服务激活。

2、授权管理范围

GBase 8s 授权可精细化控制数据库核心能力，主要包含：

• 授权有效期：支持临时授权、长期授权、永久授权管理；
• 最大会话连接数：可按业务需求设置数据库并发连接上限；
• 集群功能与节点：支持 HAC、SSC、RHAC、ER 四类集群能力开通与节点数量管控。

3、适用范围

授权变更仅需替换授权文件即可生效，无需修改数据库内核或重装程序，典型场景：

• 单机版授权升级为集群版授权；
• 一年测试授权转为正式商业授权；
• 授权到期续期、连接数调整、集群功能开通/关闭。

4、默认授权说明

GBase 8s V8.8 产品安装包内置默认授权文件，无需手动申请即可直接使用，相关规则如下：

• 连接数控制：默认连接数无限制，满足日常测试、适配、功能验证需求；
• 集群支持：默认开放全部集群方案，包含 HAC、SSC、RHAC、ER 等集群能力；
• 有效期限：默认授权有效期为1 年，自数据库初始化时间起计算；
• 使用约束：默认授权仅可用于产品适配、功能验证、试用评估场景，不可用于正式生产环境。

查看默认授权

登录数据库服务器，切换至 gbasedbt 用户，执行onpsc -q命令查看授权信息。

5、License 变更

当数据库服务器功能调整或授权文件到期时，需要重新发起license 申请流程，提交项目信息和功能发放信息即可申请新的license文件。

License 文件变更步骤：

1、定位授权目录

进入数据库授权文件存放路径：

cd $GBASEDBTDIR/license/

2、份原授权文件

替换前建议备份原有授权文件 pfrl.ini，避免操作异常导致授权失效：

cp pfrl.ini pfrl.ini.bak

3、替换新授权文件

将申请到的新 pfrl.ini 文件上传至上述目录，覆盖原有文件。

4、配置文件权限与属主

# 修改文件所属用户与用户组
chown gbasedbt:gbasedbt pfrl.ini
# 修改文件访问权限
chmod 755 pfrl.ini

5、重启数据库生效

完成文件替换与权限配置后，重启 GBase 8s 数据库服务，新授权即可生效：

onmode -ky;onclean -ky;oninit -vy

6、License 信息查看

查看命令

以 gbasedbt 用户执行命令，实时查询当前数据库授权状态：

onpsc -q

命令输出示例

[gbasedbt@h4 gbase366]$ onpsc -q
Distribution Code             TEMP-001E-016E-2000-F0000000-01A323
Time limit                   2026-12-26 08:38:09
Connect limit                 30
HAC enable                  yes
Ssc enable                    no
RHAc enable                 no
ER enable                   no
MAC Address                0cc47aa9d8d2
Start time                    2025-12-25 08:38:09
Dedicated To                 GENERAL

输出内容说明：

7、生成服务码

数据库安装完成后，执行命令`onpsc -c`，可以生成涵盖数据库实例信息和服务器信息的服务码：

onpsc -c

命令输出示例

[gbasedbt@h4 gbase366]$ onpsc -c
Distribution Code             TEMP-001E-016E-2000-F0000000-01A323
Service Code0242ac110005-1767925528

输出内容说明：

8、注册服务码

访问官网的产品服务授权模块，选择产品注册功能：

点击“前往操作”按钮，输入执行命令`onpsc -c`返回的发行码和服务码，完成产品注册。

注册成功，会返回信息“注册成功，GBase 数据库产品已注册，服务已激活。”：

同一发行码只能完成一次注册，如重复注册，则注册失败且返回提示信息“服务码已被注册，不能重复注册。”：

9、官网验证

授权许可查询

授权许可查询通过输入发行码，可以查询使用的数据库产品是否为GBase 官方正版授权使用产品。

访问官网的产品服务授权模块，选择授权许可查询功能：

点击“前往操作”按钮，输入执行命令`onpsc -c`或`onpsc -q`查到的发行码(Distribution Code)或纸质授权书中的发行码，完成产品正版化的查询。

验证通过，返回信息“产品授权许可正常”

产品服务查询

产品服务查询通过输入发行码和服务码，可以查询数据库版权状态及服务激活时间。

访问官网的产品服务授权模块，选择产品服务查询功能：

点击“前往操作”按钮，输入执行命令`onpsc -c`查到的发行码(Distribution Code)和服务码(Service Code)，完成产品服务的查询。

完成服务激活的产品，会返回服务状态信息：

10、注意事项

• 授权文件（pfrl.ini）不可随意修改、删除，否则会导致数据库启动失败或功能受限；
• 替换授权前必须备份原文件，操作后务必重启数据库；
• 正式生产环境请使用正式商业授权，避免使用默认测试授权带来服务中断风险。