手把手教你安装部署金仓数据库 KingbaseES

一、为什么选择 KingbaseES？

在数字化转型的浪潮中，数据库作为企业数据管理的核心基础设施，其稳定性、安全性和性能至关重要。KingbaseES 作为电科金仓自主研发的企业级关系型数据库，凭借其高可用、高性能和国产化适配能力，已广泛应用于政务、金融、能源等关键领域。

本文将以实战为导向，手把手带你安装部署 KingbaseES，助你掌握企业级数据库部署的核心技能。

二、硬件与系统准备

1. 硬件配置建议

KingbaseES 数据库支持物理服务器或云虚拟机部署，同时也提供 Docker 镜像版本，本文以传统物理服务部署为例说明。建议的服务器配置如下：

• CPU：建议选择 x86_64 或国产海光、鲲鹏、飞腾等架构，核心数根据业务负载选择，最少不低于 8 核。

• 内存：建议不低于 16GB ，按 “物理内存 40% 分配给 shared_buffers” 原则配置，并考虑数据库并发度适当预留会话所需内存。

• 存储：采用 RAID10 阵列保障数据安全，建议 SSD 存储 WAL 日志、数据文件。

• 网络：双千兆网卡，生产环境建议配置万兆网卡。

2. 软件环境要求

KingbaseES 数据库支持各种主流的 Windows 和 Linux 操作系统，尤其是基于 Linux 内核的国产操作系统（如 Kylin、统信等），本文以银河麒麟 V10 为例。

3. 内核参数优化（生产环境必做）

为了避免在 KingbaseES 安装和使用过程中出现问题，需要检查和设置内核参数（文件系统、共享内存、信号量和网络等）。

可通过编辑/etc/sysctl.conf 文件修改参数，添加以下参数并执行 sysctl -p 生效：

#使用用户root执行
fs.aio-max-nr = 1048576
fs.file-max = 6815744
kernel.shmall = 2097152
kernel.shmmax = 17179869184
net.ipv4.ip_local_port_range = 9000 65500
net.core.rmem_default = 262144
net.core.rmem_max = 4194304
net.core.wmem_default = 262144
net.core.wmem_max = 1048576

通过编辑/etc/security/limits.conf，调整用户资源限制，设置 nofile 和 nproc 等参数：

#使用用户root执行
kingbase soft nofile 1048576
kingbase hard nofile 1048576
kingbase soft nproc 131072
kingbase hard nproc 131072
kingbase soft stack 10240
kingbase hard stack 32768
kingbase soft core unlimited
kingbase hard core unlimited

4.KingbaseES 安装包下载及校验

从金仓官网（https://download.kingbase.com.cn/xzzx/index.htm）下载对应平台的 KingbaseES 数据库软件安装包（.iso 文件）及授权文件（license.dat）及 MD5 和 SHA1 校验值。

通过以下命令查看安装程序文件对应的 MD5 值或 SHA1 值，并比较是否与金仓官网获取的 MD5 和 SHA1 校验值一致：

# 假设拿到的安装包文件是KingbaseES_V009R001C002B0014_Lin64_install.iso
# 查看其MD5值
md5sum KingbaseES_V009R001C002B0014_Lin64_install.iso
# 查看其SHA1值
sha1sum KingbaseES_V009R001C002B0014_Lin64_install.iso

三、数据库安装：从安装到配置的全流程实操

1. 创建安装用户与目录

创建用户 kingbase,并将用户 kingbase 的密码设置为 kingbase123（在实际生产环境中需要设置为强度更高的用户密码）。

# 使用用户root执行
groupadd kingbase
useradd kingbase -g kingbase
echo "kingbase123" | passwd --stdin kingbase
# 创建安装目录
mkdir -p /opt/Kingbase/ES/V9
chown -R kingbase:kingbase /opt/Kingbase/ES/V9

2.挂载安装包

iso 格式的安装程序包需要先挂载才能使用。挂载 iso 文件需要使用 root 用户。比如挂载的目录是 iso 文件同级目录 KingbaseES，可以运行如下命令进行挂载：

# 挂载安装包
mount -t iso9660 -o loop KingbaseES_V009R001C002B0014_Lin64_install.iso /mnt/iso

3. 启动安装程序

切换为安装用户 kingbase，进入安装程序 setup.sh 所在目录，执行如下命令：

# 图形化安装
./setup.sh
 
# 命令行安装
./setup.sh -i console

按照安装指令执行即可。安装过程中需注意：

• 选择“Full” 安装模式

• 设置数据库编码为 UTF-8

• 配置兼容模式（可选 ORACLE、PG 或 MySQL 等）

• 设置数据目录为 /opt/Kingbase/ES/V9/data

四、注册与验证

1. 注册数据库服务为系统服务

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

# 打开新终端，切换到root用户
./opt/Kingbase/ES/V8/bin/install/script/root.sh

2. 验证安装

使用用户 kingbase，验证 KingbaseES 数据库是否已经正确安装。

# 启动数据库
./sys_ctl -D /opt/Kingbase/ES/V9/data start
 
# 检查进程
ps -ef | grep kingbase      
 
# 连接数据库
ksql -d test -U system
 
# 执行测试查询
test=# SELECT version();

五、生产环境优化配置

安装完成后，建议继续执行如下的配置操作

1. 配置防火墙

打开防火墙服务 firewalld.service 的数据库访问端口 54321：

# 使用用户root执行
# 开放数据库端口
firewall-cmd --zone=public --add-port=54321/tcp --permanent
firewall-cmd --reload

2. 配置环境变量

为了便于管理 KingbaseES 数据库，需要 DBA 使用 vi 编辑器，在 Bash shell 的初始化

文件/home/kingbase/.bashrc 中为用户 kingbase 添加以下环境变量：

export KINGBASE_HOME=/opt/Kingbase/ES/V9/kingbase
export PATH=$KINGBASE_HOME/Server/bin:$PATH
export PATH=$KINGBASE_HOME/ClientTools/bin：$KINGBASE_HOME/ClientTools/guitools/KStudio:$PATH
export KINGBASE_DATA=/opt/Kingbase/ES/V9/data
export KINGBASE_PORT=54321

六、经验谈：安装常见注意事项

权限问题

• 安装用户需对安装目录有读写权限，避免使用 root 用户直接安装。

• 若安装失败，检查 install/Logs 目录下的安装日志。

兼容性与参数

• 若需兼容 Oracle 语法，初始化时选择“ORACLE”模式。

• 大小写敏感设置需谨慎，初始化后不可修改。

七、总结

通过本文的实战操作，你已掌握 KingbaseES 生产环境的搭建全流程。从硬件规划到系统配置，从数据库安装到生产环境优化配置，每一步都为企业级应用筑牢基础。

后续我们将深入探讨 KingbaseES 内核、用户、会话与数据管理、高可用集群搭建、性能调优及故障处理等内容。

关注我，获取更多数据库实战干货！