通过Docker安装KingbaseES V9并激活开发License

embedded/2024/9/23 5:22:39/

简单介绍一下在Docker中安装人大金仓（KingbaseES V9）的过程，以及如何更换默认的License为官方提供的365天有效期的开发License。下面的安装过程都是在WSL2中完成的。

安装

首先，我们可以去KingbaseES的官网（https://www.kingbase.com.cn/xzzx/index.htm ，在软件版本中，注意下载的镜像为x86版本）下载docker镜像，下载完成后导入即可。

sudo docker import -i kdb_x86_64_V009R001C001B0025.tar
# 导入后可以在images中看到kingbase
sudo docker images
REPOSITORY                              TAG       IMAGE ID       CREATED         SIZE
kingbase_v009r001c001b0025_single_x86   v1        716f9488ab82   3 months ago    718MB

然后就可以启动容器了，可以直接使用下面的脚本来完成

sudo docker run -tid --name kingbase \-e ENABLE_CI=yes \-e NEED_START=yes \-e DB_USER=root \-e DB_PASSWORD=password \-e DB_MODE=mysql \-p 4321:4321 kingbase_v009r001c001b0025_single_x86:v1 /bin/bash
# 如果需要映射数据文件到宿主机可以再添加 -v /mnt/kingbase/data:/home/kingbase/userdata/\

容器启动后，我们就可以简单的看一下系统的版本来确认一下安装成功

sudo docker exec -it kingbase ksql -Uroot kingbase -c 'select get_license_info();'

当然，如果直接交互式的使用的话，还是直接用sudo docker exec -it kingbase ksql -Uroot kingbase 进入到ksql中使用比较方便。

更换License

我们可以通过下面的命令从宿主来直接查看KingbaseES的版本

sudo docker exec -it kingbase ksql -Uroot kingbase -c 'select get_license_info();``'

刚启动的Docker容器中大概是这个样子的

                           get_license_info                           
----------------------------------------------------------------------License序列号 --- 启用 --- 33645922-A629-11EE-A0E1-000C29CBE49F+生产日期 --- 启用 --- 2023-12-29                              +产品名称 --- 启用 --- KingbaseES                              +细分版本模板名 --- 启用 --- SALES-企业版                +产品版本号 --- 启用 --- V009R001C                            +浮动基准日期 ------ 启用                                    +有效期间 --- 启用 --- 90                                      +用户名称 --- 启用 --- 人大金仓官网试用授权          +项目名称 --- 启用 --- 人大金仓官网试用授权          +
... ...

如果希望使用有效期更久的开发版License，可以先到官网（https://www.kingbase.com.cn/xzzx/index.htm ，在授权文件中）去下载一个开发版的License文件（解压后就是license_34151_0.dat），然后再宿主机中把用新的授权文件覆盖原来的，并且调整文件的权限

sudo docker cp ./license_34151_0.dat kingbase:/home/kingbase/userdata/etc/license.dat
sudo docker exec -it kingbase sudo chown kingbase.kingbase /home/kingbase/userdata/etc/license.dat
sudo docker exec -it -u 0 kingbase chmod 644 /home/kingbase/userdata/etc/license.dat

完成上面一步后，不需要重启数据，直接查看License信息就会发现已经更新成功了，大概是下面这个样子

                           get_license_info                           
----------------------------------------------------------------------License序列号 --- 启用 --- DF3316AC-69B2-11EE-A0E1-000C29CBE49F+生产日期 --- 启用 --- 2023-10-13                              +产品名称 --- 启用 --- KingbaseES V8                           +细分版本模板名 --- 启用 --- SALES-开发版 V9R1           +产品版本号 --- 启用 --- V009R001C                            +浮动基准日期 ------ 启用                                    +有效期间 --- 启用 --- 365                                     +用户名称 --- 启用 --- 官方网站试用授权                +项目名称 --- 启用 --- 官方网站试用授权                +
... ...