Linux 系统下 KingbaseES 完整部署指南：从安装准备到卸载与组件管理

Linux 系统下 KingbaseES 完整部署指南：从安装准备到卸载与组件管理，本文详细介绍了 KingbaseES 在 Linux 系统的安装、安装后检查及卸载流程。安装前需完成用户创建（建议新建 kingbase 用户，设 UID、密码并赋予权限）、目录准备（安装目录默认 /opt/Kingbase/ES/V9，数据目录可自定义，还需创建软件存放路径）、安装包处理（官网或通过工作人员获取，校验 MD5/SHA1 值，上传后挂载 iso 文件）。安装有图形化、命令行、静默三种方式，均需选授权文件、安装路径、安装集（完全、服务器、定制安装）等。安装后可查日志、菜单、目录及版本验证，缺库需相应处理。卸载同样有三种方式，部分文件需手动删除，还提及增删组件的两种操作方式及目录结构、参数配置说明。

 

前言

中电科金仓（北京）科技股份有限公司（以下简称“电科金仓”）成立于1999年，是成立最早的拥有自主知识产权的国产数据库企业，也是中国电子科技集团（CETC）成员企业。电科金仓以“提供卓越的数据库产品助力企业级应用高质量发展”为使命，致力于“成为世界卓越的数据库产品与服务提供商”。

电科金仓自成立起始终坚持自主创新，专注数据库领域二十余载，具备出色的数据库产品研发及服务能力，核心产品金仓数据库管理系统KingbaseES（简称“KES”）是面向全行业、全客户关键应用的企业级大型通用数据库。KES产品V9版本已通过国家权威机构认证，产品核心源代码自主率达到100%。2018年，电科金仓申报的“数据库管理系统核心技术的创新与金仓数据库产业化”项目荣获国家科学技术进步二等奖。金仓数据库管理系统KES于2022年入选国务院国资委发布的十项国有企业数字技术典型成果，彰显数据库领域国家队硬实力。继2023年金仓数据库管理系统V8通过第一批《安全可靠测评》后，2024年金仓数据库管理系统V9、金仓分布式HTAP数据库软件集群V3再度入围，至此电科金仓共计2款产品3个版本通过《安全可靠测评》*。

 

🥇 点击进入金仓数据库专栏，本专栏聚焦金仓数据库（KingbaseES）这一国产企业级融合数据库，为开发者及技术决策者提供从基础操作到架构设计的系统化学习路径。从多语法兼容（Oracle/MySQL/PostgreSQL）、多模数据存储（关系 / 文档 / 时序 / GIS）等功能展开讲解！

🌞　正文开始：

一、安装前准备工作
1.1 安装用户
在安装KingbaseES时，安装用户对于安装路径需有“读”、“写”、“执行”的权限。在Linux系统中，需要以非root用户执行安装程序，且该用户要有标准的home目录。 因此，建议在正式安装前，新建kingbase用户作为KingbaseES专用的系统用户，可以先使用root用户运行如下命令创建kingbase用户：

useradd -u2000 kingbase
或
kill -9 `lsof -u kingbase`
usermod -u 2000 kingbase
groupmod -g 2000 kingbase

备注

创建安装系统用户kingbase，UID可以根据实际情况指定，无特殊说明，本指南后续的操作默认使用kingbase用户进行操作。
该命令会同时创建同名用户组kingbase以及用户根目录/home/kingbase。继续运行如下命令设置kingbase用户的密码：

passwd kingbase

备注

密码需要输入两次，保证两次输入的密码相同。

1.2 安装目录
KingbaseES默认的安装目录是/opt/Kingbase/ES/V9。如果不存在，需要使用root用户先创建该目录，并赋予kingbase用户对该目录的读写权限。

mkdir -p /opt/Kingbase/ES/V9
chmod o+rwx /opt/Kingbase/ES/V9

也可以自定义安装路径。如自定义安装路径为 /home/kingbase/kdb，使用kingbase用户创建目录的命令如下：

su - kingbase
mkdir /home/kingbase/kdb

1.3 数据目录
数据目录是KingbaseES中存放数据文件的目录，默认是在安装目录下的data目录。也可以与安装目录分开单独设置。可以根据业务系统数据量来单独设置数据目录路径，例如将数据目录初始化在本机硬盘或者挂载在盘阵上。 可以运行如下命令创建数据目录：

mkdir -p /opt/Kingbase/ES/V9/data

备注

数据目录不必事先创建。安装过程中会提示指定数据目录，如果目录不存在安装程序会自动创建。

1.4 安装包准备
获取安装包

可以通过电科金仓官网下载对应平台的安装程序，也可以通过电科金仓的销售人员、售后支持人员或代理商获取安装程序。 在获得安装程序（iso文件）的同时，应该会获得一个MD5值或SHA1值。建议先通过以下命令查看安装程序文件对应的MD5值或SHA1值，再和拿到的MD5值或SHA1值进行比对。如果一致，说明安装文件正常；如果不一致，说明安装文件可能不完整，安装过程可能无法正常完成。
假设拿到的安装包文件是KingbaseES_V009R001C010_Lin64_install.iso，查看其MD5值：

md5sum KingbaseES_V009R001C010_Lin64_install.iso

查看其SHA1值：

sha1sum KingbaseES_V009R001C010_Lin64_install.iso

上传安装包

将上述安装包软件包上传至服务器到存放软件包的路径（本文示例：/opt/software/）
使用root用户创建存放软件路径

mkdir -p /opt/software/
mkdir -p /opt/software/KingbaseESV9

安装包的挂载与取消

iso格式的安装程序包需要先挂载才能使用,需要使用root用户挂载iso文件，命令如下：

cd /opt/software/
mount KingbaseES_V009R001C010_Lin64_install.iso ./KingbaseESV9

KingbaseES目录下可以看到setup目录和setup.sh脚本。安装完成后可以运行如下命令取消挂载iso文件：

cd /opt/software/
umount ./KingbaseESV9

此时KingbaseES已经和iso文件解除挂载关系，在KingbaseES目录下不会再看到安装相关文件。

二、安装KingbaseES
KingbaseES安装可以使用图形化安装、命令行安装和静默安装三种方式在Linux系统上进行安装部署。

图形化安装
命令行安装
静默安装

 

2.1 图形化安装
启动安装程序
图形化安装支持中文和英文的安装界面。根据操作系统的语言设置会显示对应语言的安装界面。可以执行如下命令查看操作系统的语言设置：
echo $LANG

如果系统显示值包含“zh_CN”，则为中文语言，安装程序会使用中文界面。否则，可以执行如下命令修改语言设置为中文：

export LANG=zh_CN.UTF-8

接下来就可以开始进行KingbaseES的安装了。首先切换为安装用户kingbase，进入安装程序setup.sh所在目录，执行如下命令：

cd /opt/software/KingbaseESV9
sh setup.sh

或

sh setup.sh -i swing

如果当前操作系统中已存在KingbaseES，执行启动命令后将弹出KingbaseES安装程序窗口【实例管理页】。
选择【安装新实例】，点击【下一步】，开始安装KingbaseES。
如果想在已安装实例上增加或删除功能，则可以选择【修改现有实例】，具体参见 增删组件 。

 

 

点击【下一步】按钮，继续本次安装。

许可协议
默认“我接受许可协议条款”的选择框未选中，【下一步】按钮置灰。
当且仅当选择“我接受许可协议条款”后，【下一步】按钮有效。
若点击右上角关闭按钮，将弹出取消安装提示窗口，点击【确认】按钮，退出安装程序。
若点击【取消】，则回到安装界面，继续安装。

选择授权文件
在本步骤需要选择授权文件，点击【浏览】按钮以选择本机上的授权文件。
若指定的授权文件合法，则将显示授权文件的详细信息。

进入该步骤【下一步】按钮默认置灰，若授权文件通过验证，则【下一步】按钮有效。

备注

请在有效期内及时更换正式授权文件，若不选择授权文件，则使用软件自带试用版授权。

选择安装文件夹
此步骤用于选择安装路径。默认安装路径为: /opt/Kingbase/ES/V9。

点击 【浏览】 按钮，弹出文件选择对话框，可选择其他安装路径。
点击 【重置】 按钮，将安装路径恢复为默认安装路径。
点击 【下一步】 按钮，继续安装。

选择安装集
根据安装后数据库服务功能的不同，KingbaseES可分为完全安装、服务器安装和定制安装三种安装集。
完全安装：包括数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。
服务器安装：仅包括数据库服务器。
定制安装：在数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具所有组件中自由选择。
如果选择“完全安装”安装集，系统将安装KingbaseES所有组件，点击【下一步】，至安装预览。
如果选择“服务器安装”安装集，系统将仅安装服务器组件，点击【下一步】，至安装预览。
如果选择“定制安装”安装集，则根据需求选择安装所需功能部件，点击【下一步】，至选择功能组件。

选择功能组件
如选择“定制安装”的安装集，通过点击功能组件项选择或去除对应的组件。点击【下一步】，继续安装。

安装预览
在此步骤会看到即将安装产品的摘要信息，包括：

安装文件夹。
指定安装的功能组件。
安装路径所在磁盘空间信息。

正在安装
点击【安装】按钮后，系统开始安装KingbaseES，安装过程不断刷新安装进度。

创建快捷方式
此界面用于创建快捷方式，方面用户快速访问数据库工具。

选择用户范围：可根据需求选择“当前用户”或“所有用户”。“当前用户”表示仅对当前登录账户有效；“所有用户”则对设备上所有用户可用。
选择程序组：在“选择快捷方式的程序组”区域选择快捷方式的分组，默认为“KingbaseESV009R001”, 可点击输入框进行更改。

安装完成
若安装过程中没有出现任何警告或错误，将显示如下界面。单击【完成】以退出安装程序。若安装过程中出现任何警告或错误，则窗口中显示错误信息。
若勾选“初始化数据库”，单击【完成】后，自动打开“金仓数据库管控工具”，您可以使用“金仓数据库管控工具”创建数据库实例。

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

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

export LANG=zh_CN.UTF-8

接下来开始进行命令行安装过程。首先进入安装程序中setup.sh所在目录，以kingbase用户执行如下命令：

sh setup.sh -i console

命令执行后，将会启动安装程序。

 

输入1，再按，选择“安装新的实例”；
输入2，再按，选择“修改已有实例”。
初次安装，输入1，按，进入“简介”界面。修改存在的实例请参考 install 命令行增删组件 。

简介
输入Q，按退出安装；
直接按进行下一步操作。
若无特殊说明，以下各步骤皆与此相同。

许可协议
在此步骤需要阅读完整的许可协议。连续按<空格>翻页阅读直到结束。

输入1表示接受此许可协议条款。
输入2表示不接受此许可协议条款，输入其他无效。
输入3重新展示许可协议

选择授权文件
此步骤用于选择授权文件，若指定的授权文件合法，则将显示授权文件的详细信息。
输入授权文件的绝对路径后，按以检查授权文件，若授权文件有效，则进入下一步骤。

备注

请在有效期内及时更换正式授权文件，若不选择授权文件，则使用软件自带试用版授权。

选择安装文件夹
此步骤用于选择安装路径。默认安装路径是/opt/Kingbase/ES/V9。
可自行输入一个绝对路径作为安装目录。缺省直接按键，即为默认路径。

选择安装集
根据安装后数据库服务功能的不同，KingbaseES可分为完全安装、服务器安装和定制安装三种安装集。
完全安装：包括数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。
服务器安装：仅包括数据库服务器。
定制安装：在数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具所有组件中自由选择。
输入1，或按接受缺省项，选择“完全安装”安装集，系统将安装KingbaseES所有组件，跳至安装预览。

输入2，选择“服务器安装”安装集，系统将仅安装服务器组件，跳至安装预览。

输入3，选择“定制安装”安装集，可根据需求选择安装所需功能组件，将进入下一步选择功能组件。

选择功能组件
如选择定制安装的安装集，需要继续选择产品功能组件。

安装预览
在此步骤会看到即将安装产品的摘要信息。包括：

安装文件夹。
指定安装的功能组件。
安装路径所在磁盘空间信息。
正在安装
安装过程中会不断刷新安装进度。

创建快捷方式
此界面用于创建快捷方式，方面用户快速访问数据库工具。

选择用户范围：可根据需求选择“当前用户”或“所有用户”。“当前用户”表示仅对当前登录账户有效；“所有用户”则对设备上所有用户可用。
选择程序组：默认为“KingbaseESV009R001”。
安装完成
若安装过程中没有出现任何警告或错误，将显示如下界面。
2.3 静默安装
静默安装注意事项
静默安装模式下，安装程序通过读取配置文件来安装数据库。安装包iso文件挂载后，setup目录下已存在silent.cfg模板文件，需要根据实际安装机器的情况修改参数值。因为Linux挂载iso目录为只读，需要拷贝setup/silent.cfg文件到另外的目录进行修改。
配置文件的参数可参考下表修改。
配置文件参数说明
启动安装
修改完配置文件后，进入安装程序所在目录，以kingbase用户执行如下命令：
./setup.sh -i silent -f $\{配置文件路径\}

-f参数指定修改后配置文件的相对或绝对路径。相对路径是指相对setup/install.jar的相对路径。

三、安装后检查
在安装完成后，可以通过以下几种方式进行安装正确性验证：

查看安装日志
在${安装目录}/install/Logs目录下，存在名称为 " KES_install.log" 的日志文件，其中记录了安装过程的所有信息。
查看开始菜单
查看应用程序菜单中是否安装了KingbaseES菜单项，并且正确关联到对应的程序。开始菜单结构如下：
KingbaseES
数据库开发管理工具
数据迁移工具
数据库管控工具
卸载
查看安装目录（参考 目录一览表)
查看已安装数据库的版本信息
进入${安装目录}/Server/bin目录，执行
./kingbase -V;

或在交互式终端（ksql）中执行

select version();

解决缺库问题
如果安装机器操作系统缺少必要的so库文件，可通过如下命令查看到有缺少so库文件的情况。在${安装目录}/Server/bin目录下行：
ldd * | grep "not found"

在${安装目录}/Server/lib下,执行如下命令检查是否存在缺少的so库文件：
ls
若检查到${安装目录}/Server/lib下存在缺少的so库文件，则在${安装目录}/Server/lib下,执行

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`

若在${安装目录}/Server/lib下,未找到缺少的so库文件，请联系客服人员。

四、卸载KingbaseES
KingbaseES卸载可以使用图形化卸载、命令行卸载和静默卸载三种方式在Linux系统上进行软件卸载。

4.1 图形化卸载
启动卸载
以kingbase用户登录系统后，进入${安装目录}/Uninstaller目录，执行如下命令，启动卸载程序。
sh startUninstall.sh -i swing

点击【卸载】按钮，准备卸载；点击【取消卸载】按钮，取消卸载。

确认卸载
点击【确认】按钮，开始卸载；点击【取消】按钮，取消卸载。
若取消勾选“保留本地历史数据”，会强制删除安装目录下的文件

正在卸载
此步骤用于显示卸载进度。

完成卸载
对于初始化生成的文件或程序运行中生成的文件，卸载过程当中无法自动删除，请退出卸载程序后手动删除。

4.2 命令行卸载
启动卸载
以kingbase用户登录系统后，进入${安装目录}/Uninstaller目录，执行如下命令，启动卸载程序。
sh startUninstall.sh -i console

准备卸载

完成卸载
对于初始化生成的文件或程序运行中生成的文件，卸载过程当中无法自动删除，请退出卸载程序后手动删除。

4.3 静默卸载
以kingbase用户登录系统后，进入${安装目录}/Uninstaller目录，执行以下命令：

sh startUninstall.sh -i silent

如果是通过静默安装方式安装的，可以不加-i参数，否则必须附加-i参数。

卸载过程没有提示信息，等待卸载过程完成即可。
————————————————
版权声明：本文为CSDN博主「xcLeigh」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/weixin_43151418/article/details/151424420