KingbaseES V8 详细部署指南(人大金仓)

第一阶段：安装前准备

在开始安装之前，充分的准备工作可以避免绝大多数问题。

项目	内容
官方网址	https://www.kingbase.com.cn/
下载入口	“产品中心” -> “下载中心” -> KingbaseES V8
文件类型	寻找 .iso 后缀的文件
关键选择	根据操作系统和CPU架构选择 Lin_64 / Win_64 / aarch64
必要条件	需要注册并登录官网账号

硬件和软件要求
● 操作系统: openEuler 22.03 (LTS-SP3)。
● CPU: x86-64 架构的 CPU。
● 内存: 建议 4GB 以上，生产环境根据业务量调整。
● 磁盘空间:

• 安装目录: 至少 10GB 可用空间。
• 数据目录: 根据数据量预估，建议至少 10GB 起步。

1.关闭防火墙和selinux

systemctl stop firewalld
systemctl disable firewalld
setenforce 0
sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config

2.配置系统资源限制

echo "* soft nofile 65536" >> /etc/security/limits.conf
echo "* hard nofile 65536" >> /etc/security/limits.conf
echo "* soft nproc 65536" >> /etc/security/limits.conf
echo "* hard nproc 65536" >> /etc/security/limits.conf

3.调整内核参数

echo "kernel.sem = 5010 64128000 50100 1280" >> /etc/sysctl.conf
echo "fs.file-max = 7672460" >> /etc/sysctl.conf
sysctl -p

4.创建专用系统用户

为了安全，强烈不建议使用 root 用户来运行 KingbaseES 服务。我们需要创建一个专用的低权限用户。

# 创建一个名为 kingbase 的用户，并设置密码
groupadd kingbase
useradd -g kingbase -d /data/kingbase -m kingbase
passwd kingbase
3er4#ER$                 #kingbase用户密码

5.创建安装和数据目录

尽量将软件和数据分开放置

# 创建存放软件目录
mkdir -p /data/software/ 
mkdir -p /data/software/KingbaseESV8

# 创建安装目录并赋予执行权限
mkdir -p /data/Kingbase/ES/V8
chmod o+rwx /data/Kingbase/ES/V8

# 创建数据目录
mkdir -p /data/Kingbase/ES/V8/data

# 将目录的所有权赋予 kingbase 用户
chown -R kingbase:kingbase /data/kingbase

第二阶段：执行安装

1.挂载安装镜像

cd /data/software/
mount -o loop KingbaseES_V008R006C009B0014_Lin64_install.iso ./Kingbase

2.切换到kingbase用户

su - kingbase

3.运行安装程序（命令行模式）

cd  /data/software/KingbaseESV8
./setup.sh -i console

4.命令行安装

点击查看代码

● 启动： 命令是 ./setup.sh -i console。
● TUI 流程： 这是请求的核心。需要引导用户完成他们将在终端中看到的提示。将按时间顺序列出它们。
  a. 欢迎界面 -> Enter 继续。
  b. 许可协议 ->  Enter继续。
  c. DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): y
  d. 安装集 -> 输入 1 选择“典型”。
  e. Use the Trial license if no license is selected.
     Please replace the offical license before expiration.
     File Path : ->  Enter继续。
  f. 安装路径 -> 它会显示一个默认值。输入自己的路径：/data/Kingbase/ES/V8。
  g. 数据目录 -> 同上。输入 /data/Kingbase/ES/V8/data。
  h. 端口 -> 默认 54321。只需按 Enter。
  i. 管理员密码 -> 关键步骤。输入一个强密码并确认。默认用户是 system。
  j. 数据库编码 -> 强烈推荐 UTF8（避免乱码）。
  k. Database Locale. ->  Enter继续。
  l. database mode-> 输入 3 继续。（注：此处根据实际业务需求选择兼容模式）
  m. enter the case sensitivity.-> 输入 2 继续。
  n. enter block size-> 输入 3 继续。
  o. enter the authentication method.->  Enter继续。
  p. enter database custom parameters.->  Enter继续。
  q. The database will be initialized, which may take some time. Please be patient.->  Enter继续。-> 开始安装。
  r. If you want to register KingbaseES V8 as OS service, please run
     /data/Kingbase/ES/V8/install/script/root.sh   -> Enter 退出。
  s. 完成 -> 执行exit ->退到root用户

5.初始化(使用root用户执行初始化操作)

/data/Kingbase/ES/V8/install/script/root.sh

第三阶段：配置系统服务

1.检查服务和端口

ps -ef | grep kingbase
ss -lntup | grep 54321

2.创建 systemd 服务文件

vim /etc/systemd/system/kingbase.service

• 将以下内容粘贴进去

点击查看代码

[Service]
# --- 用户和组配置 ---
User=kingbase
Group=kingbase

# --- 环境变量配置 ---
# 设置 KingbaseES 的数据目录路径，这是关键！
Environment="PGDATA=/data/Kingbase/ES/V8/data"
# (可选) 设置 KingbaseES 的安装目录
Environment="KINGBASE_HOME=/data/Kingbase/ES/V8"

# --- 服务类型 ---
Type=forking

# --- 启动、停止、重载命令 ---
# 请确保 sys_ctl 的路径是正确的
ExecStart=/data/Kingbase/ES/V8/Server/bin/sys_ctl start -D ${PGDATA}
ExecStop=/data/Kingbase/ES/V8/Server/bin/sys_ctl stop -D ${PGDATA} -m fast
ExecReload=/data/Kingbase/ES/V8/Server/bin/sys_ctl reload -D ${PGDATA}

# --- 其他配置 ---
Restart=on-failure
RestartSec=5s
TimeoutSec=300
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

3.启用并启动服务

Tips:执行此操作前需要手动将之前服务kill 掉

# 重新加载 systemd 配置
systemctl daemon-reload

# 设置服务开机自启
systemctl enable kingbase.service

# 启动 KingbaseES 服务
systemctl start kingbase

# 检查 KingbaseES 服务状态
systemctl status kingbase

# 停止 KingbaseES 服务
systemctl stop kingbase

第四阶段：验证与连接

1.检查服务状态

systemctl status kingbase

如果看到 Active: active (running) 的绿色字样，说明服务已成功启动。

2.连接数据库

# 切换到 kingbase 用户
su - kingbase -s /bin/bash

# 使用 ksql 连接数据库
/data/Kingbase/ES/V8/Server/bin/ksql -U system -d test -h 127.0.0.1

输入密码后，如果看到 test=# 提示符，说明连接成功。

3. 执行简单 SQL 验证

SELECT version();
\q

第五阶段：配置命令全局环境变量

在/etc/profile 最后追加如下命令，然后执行source /etc/profile使配置生效

vim  /etc/profile
...............
...............
export PATH=$PATH:/data/Kingbase/ES/V8/Server/bin


source  /etc/profile