更换 Kingbase V9 License 踩坑记

更换 Kingbase V9 License 踩坑记

本地测试环境使用KDTS迁移数据时候遇到连接用户过多错误，原因是初始化Kingbase实例时候指定的开发版license限制最大连接数10。

我用官网的更换 license 文件 - License管理 | KingbaseES方法更换失败：

[kingbase@localhost V9]$ ./Server/bin/sys_ctl -D data reload_license -L ./license_4_V009R001C-pro_180days.dat

SELECT GET_LICENSE_VALIDDAYS();
-- | get_license_validdays |
-- | 364                   |

仍然是原来的 开发版365天 授权。

所以在此记录更换license步骤。

第一步：定位当前的 License 文件并确定操作

1. 登录数据库，执行以下 SQL 查询数据目录的绝对路径：

SHOW data_directory;

假设返回结果为：/opt/Kingbase/ES/V9/data

2. 在该目录的父级查找 license.dat 文件：

find /opt/Kingbase/ES/V9/ -name "license.dat"

输出了三个license.dat文件，已知安装时候使用的授权是开发版365天。经过 ls -la，确认了这三个文件：

文件路径	内容	描述	是否更换
/opt/Kingbase/ES/V9/KESRealPro/V009R001C010/Server/bin/license.dat	企业版，90天试用授权	ksql、sys_dump等客户端工具启动时校验自身合法性	猜测KDTS使用ksql/sys_dump/sys_restore等命令时候可能会校验该授权文件。
/opt/Kingbase/ES/V9/KESRealPro/V009R001C010/license.dat	开发版，365天试用授权	数据库实例实际使用的授权	予以替换
/opt/Kingbase/ES/V9/license.dat -> /opt/Kingbase/ES/V9/KESRealPro/V009R001C010/license.dat	软链接	初始化数据库实例时候指定的授权文件，在实例化数据库时被迁移到了KESRealPro/V009R001C010/license.dat	予以替换

因此只需要替换/opt/Kingbase/ES/V9/KESRealPro/V009R001C010/license.dat即可。

第二步：替换真正的授权文件

1. 准备授权文件

新的授权文件上传到了/opt/Kingbase/ES/V9/license_4_V009R001C-pro_180days.dat。先以root用户修改新授权文件权限：

sudo -i 
# [sudo] kingbase 的密码：
cd /opt/Kingbase/ES/V9/
chown kingbase:kingbase license_4_V009R001C-pro_180days.dat
chmod 77 license_4_V009R001C-pro_180days.dat

2. 备份并替换授权文件

切换到kingbase用户，备份并替换授权文件：

su kingbase
# 确认当前目录
cd /opt/Kingbase/ES/V9/
mv ./KESRealPro/V009R001C010/license.dat ./KESRealPro/V009R001C010/license.dat.260617.bak
ls -la ./KESRealPro/V009R001C010/ | grep license
# -rw-rw-r--  1 kingbase kingbase 5036  6月 17 09:58 license.dat
# -rw-rw-r--  1 kingbase kingbase 4998  6月 16 15:02 license.dat.260617.bak

第三步：重载license

1. 重载license再次失败

按照官方文档，sys_ctl ... reload_license ...：

cd /opt/Kingbase/ES/V9/Server/bin
./sys_ctl -D /opt/Kingbase/ES/V9/data reload -L /opt/Kingbase/ES/V9/KESRealPro/V009R001C010
/license.dat
# Checking license file...
# Check successfully. license file will expire in 2026-12-14.
# Reload successfully.

在数据库查询中验证：

SELECT GET_LICENSE_VALIDDAYS();
-- | get_license_validdays |
-- | 364                   |

仍然是原来的 开发版365天 授权。

2. 重启数据库实例

./sys_ctl restart -D /opt/Kingbase/ES/V9/data
# 等待服务器进程关闭 .... 完成
# 服务器进程已经关闭
# 等待服务器进程启动 ....2026-06-17 10:24:48.035 CST [46474] LOG:  请尽快配置有效的归档命令做WAL日志文件的归档
# ...
#  完成
# 服务器进程已经启动

在数据库查询中验证授权：

SELECT GET_LICENSE_VALIDDAYS();
-- | get_license_validdays |
-- | 180                   |

至此，已经把旧的 license从开发版 365天 替换为专业版 180天。