Ubuntu 服务器安装 KingbaseES V009R002C012 数据库指南

3 安装过程详解

完成环境准备后，我们就可以开始正式安装 KingbaseES 数据库了。本文将详细介绍从获取安装包到初始化配置的完整过程。

3.1 官方下载 linux 镜像

访问电科金仓官网，KingbaseEs 数据库安装包 (Oracle 兼容)-->V9R2C12(Oracle 兼容版) --> X64 Linux-->下载 KingbaseES_V009R002C012B0003_Lin64_install.iso 镜像。

下载完成之后上传到自己要安装的服务器上。

3.2 授权文件对比

对于下载的文件，建议进行完整性校验，以确保文件在传输过程中没有损坏：

# 计算下载文件的 MD5 校验和
md5sum /mnt/tools/kingbase/KingbaseES_V009R002C012B0003_Lin64_install.iso
# 计算下载文件的 SHA1 校验和
sha1sum /mnt/tools/kingbase/KingbaseES_V009R002C012B0003_Lin64_install.iso

将计算结果与官网提供的校验值进行比对，确保完全一致后再进行后续操作。

3.3 挂载安装包

ISO 格式的安装包需要先挂载才能访问其中的安装文件：

cd /mnt/tools/kingbase
mount KingbaseES_V009R002C012B0003_Lin64_install.iso ./KingbaseESV9

如上图所示，挂载安装包报错了，不用慌，是因为没有创建 KingbaseEsv9 目录，创建之后重新执行即可。

mkdir -p ./KingbaseEsv9

3.4 开始启动安装程序

命令行安装支持中文和英文的文字提示。根据操作系统的语言设置会显示对应语言的提示信息。您可以执行如下命令查看操作系统的语言设置：

echo $LANG

如果系统显示值包含'zh_CN'，则为中文语言，安装程序会显示中文内容。否则，您可以执行如下命令修改语言设置为中文：

# 中文 UTF-8
export LANG=zh_CN.UTF-8
# 英文 UTF-8
export LANG=en_US.UTF-8

特别注意：这里一定要查看自己系统的编码，不然后面安装的时候选择这个字符串没有，快安装完了提示报错。我这里的系统 ubuntu，我这里设置 en_US.UTF-8 比较合适，因为中文有乱码不太适合，根据自己服务器情况选择。

进入到对应目录，开始运行安装：

# 进入您挂载的安装包目录
cd /mnt/tools/kingbase/KingbaseESV9
# 再次执行安装命令
./setup.sh -i console

这里又报错了，遇到了一个常见的安装问题：KingbaseES 安装程序要求使用非 root 用户运行。这是出于安全和管理权限的考虑。别担心，这个问题很容易解决。

1. 在 Linux 系统上，为数据库服务创建独立的用户是一个好习惯，如果上面已经创建了用户请授权后直接使用。

# 创建用户组
groupadd kingbase
# 创建用户并指定主组，同时创建家目录
useradd -g kingbase -m kingbase
# 为 kingbase 用户设置密码（请使用强密码）
passwd kingbase

系统会提示您输入并确认新密码，对应着操作即可。

2. 将安装目录和数据目录的所有权赋予新创建的 kingbase 用户，确保该用户有足够的权限进行安装和写入数据。

# 假设您计划的安装目录是 /opt/Kingbase/ES/V9，数据目录是 /kingbase/data
mkdir -p /opt/Kingbase/ES/V9
mkdir -p /kingbase/data
# 更改目录所有者
chown -R kingbase:kingbase /opt/Kingbase
chown -R kingbase:kingbase /kingbase

3. 切换到 kingbase 用户进行安装：

# 切换到 kingbase 用户，'-' 表示同时切换环境变量
su - kingbase

4. 切换到 kingbase 用户后，再次进入安装脚本所在目录并执行安装命令。

# 进入您挂载的安装包目录
cd /mnt/tools/kingbase/KingbaseESV9
# 再次执行安装命令
./setup.sh -i console

3.5 接受许可协议

输入 quit，按退出安装； 输入 back，按返回前一屏幕； 直接按进行下一步操作。 若无特殊说明，以下各步骤皆与此相同。

3.6 安装包选择

看自己情况选择，新手推荐安装全部。

3.7 安装目录和数据目录设置

如上图所示，又遇到问题了，这是安装 KingbaseES V9 时遇到了许可证（license）文件路径的问题。错误信息表明安装程序期望一个具体的 license 文件，但您提供的 /opt/Kingbase/ES/V9 是一个目录路径。

回到官网这里下载对应的授权文件，然后上传到自己服务器对应的目录。

然后继续执行，注意这里要指定 bat 文件，不能只到文件文件夹，如下图所示：

/opt/Kingbase/ES/V9/license.dat

第一次是上面命令，我这里第二次安装文件是：/data/Kingbase/ES/V9/license.dat

数据存储目录设置：注意这个目录一定要是空文件夹，我第一次安装目录是/kingbase/data 我重新安装目录是：/data/Kingbase/data

3.8 初始化数据库

默认端口：54321（可自定义） 默认账户为：system（可自定义） 密码（自定义） 默认字符集编码为：UTF8（可选 default、GBK、GB2312、GB18030）

• 区域，可选值将随字符集编码选项发生变动。

  • 当字符集编码为 default 时，默认区域值为：default（可选 C）
  • 当字符集编码为 UTF8 时，默认区域值为：zh_CN.UTF-8（可选 en_US.UTF-8、C）
  • 当字符集编码为 GBK 时，默认区域值为：zh_CN.GBK（可选 C）
  • 当字符集编码为 GB2312 时，默认区域值为：zh_CN.GB2312（可选 C）
  • 当字符集编码为 GB18030 时，默认区域值为：zh_CN.GB18030（可选 C）

• 默认大小写敏感为：是（可选否）

• 默认数据块大小为：8k（可选 16k、32k）

• 默认身份认证方法为 scram-sha-256（可选 scram-sm3，sm4，sm3）

• 自定义参数（自定义），可自由输入任何值，作为初始化数据库的参数有关数据库初始化参数，详情可见《KingbaseES 服务器应用参考手册》第 2 章自定义特殊参数：（如果输入值包含以下某一项，请注意特殊情况）

3.9 安装完成

出现以下字眼：successfully 恭喜您，安装成功！会得到一个启动 root.sh 命令。

查看数据目录，会新增了很多文件。 同理，安装目录也会多了很多文件。

3.10 执行 root.sh

如果想注册数据库服务为系统服务，您可以在安装并初始化数据库成功后，执行 root.sh 脚本来注册并启动数据库服务，具体步骤如下：

1. 打开新终端；
2. 切换到 root 用户；

运行${安装目录}/install/script/root.sh。

/opt/Kingbase/ES/V9/install/script/root.sh

如果想启动或停止数据库服务，进入${安装目录}/Server/bin 目录执行如下命令：

# 启动服务
sys_ctl -w start -D /data/Kingbase/data -l "/data/Kingbase/data/sys_log/startup.log"
# 停止服务
sys_ctl stop -m fast -w -D /data/Kingbase/data

3.11 查看已安装的版本信息

进入${安装目录}/Server/bin 目录，执行

cd /kingbase/data/KESRealPro/V009R002C012/Server/bin
./kingbase -V;

可以看到 kingbase (KingbaseES) V009R002C012，说明安装跟我们下载的版本一致！

这个是安装整个流程总结，更多请查看官方文档：4. 安装 KingbaseES — KingbaseES（Oracle 兼容版）产品手册

4 使用体验

完成安装数据库后，我们就可以开始正式使用 KingbaseES 数据库了。

4.1 在线使用数据库

# 切换到 kingbase 用户
su - kingbase
# 连接数据库
ksql -U SYSTEM -d test -p 54321
# 在数据库提示符下执行测试命令
SELECT version();
CREATE TABLE test_table(id INT, name VARCHAR(50));
INSERT INTO test_table VALUES(1, 'KingbaseES Test');
SELECT * FROM test_table;

上面如果没设置系统 ksql 命令，可以指定到安装目录执行

/kingbase/data/KESRealPro/V009R002C012/Server/bin/ksql -U SYSTEM -d test -p 54321

其中，/kingbase/data/KESRealPro/V009R002C012 是安装的目录，每个人的安装目录可能不一样，大家根据自己情况设置。

4.2 常见问题排查

如果安装过程中遇到其他问题，可以检查以下内容：

手动启动数据库（如果服务启动失败）：

su - kingbase
/opt/Kingbase/ES/V9/Server/bin/sys_ctl -D /kingbase/data start

检查依赖库：

ldd /opt/Kingbase/ES/V9/Server/bin/kingbase

查看安装日志：

tail -f /tmp/setup.log

检查端口占用：

netstat -tlnp | grep 54321

检查磁盘空间：

df -h

按照以上步骤操作，您应该能够成功安装 KingbaseES 数据库。如果在某个具体步骤遇到问题，请查阅官方文档或社区支持。