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

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系统上进行安装部署。

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

KingbaseES整体的安装流程如下图所示：

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所有组件，点击【下一步】，至安装预览。 如果选择“服务器安装”安装集，系统将仅安装服务器组件，点击【下一步】，至安装预览。 如果选择“定制安装”安装集，则根据需求选择安装所需功能部件，点击【下一步】，至选择功能组件。

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

• 选择用户范围：可根据需求选择“当前用户”或“所有用户”。“当前用户”表示仅对当前登录账户有效；“所有用户”则对设备上所有用户可用。
• 选择程序组：在“选择快捷方式的程序组”区域选择快捷方式的分组，默认为“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 命令行增删组件 。

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

输入授权文件的绝对路径后，按以检查授权文件，若授权文件有效，则进入下一步骤。

备注

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

可自行输入一个绝对路径作为安装目录。缺省直接按键，即为默认路径。

• 完全安装：包括数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。
• 服务器安装：仅包括数据库服务器。
• 定制安装：在数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具所有组件中自由选择。

输入1，或按接受缺省项，选择“完全安装”安装集，系统将安装KingbaseES所有组件，跳至安装预览。

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

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

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

• 选择用户范围：可根据需求选择“当前用户”或“所有用户”。“当前用户”表示仅对当前登录账户有效；“所有用户”则对设备上所有用户可用。
• 选择程序组：默认为“KingbaseESV009R001”。

2.3 静默安装

• 配置文件的参数可参考下表修改。
• 配置文件参数说明

./setup.sh -i silent -f $\\{配置文件路径\\}

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

三、安装后检查

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

• 数据库开发管理工具
• 数据迁移工具
• 数据库管控工具
• 卸载

./kingbase -V;

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

select version();

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 图形化卸载

sh startUninstall.sh -i swing

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

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

4.2 命令行卸载

sh startUninstall.sh -i console

4.3 静默卸载

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

sh startUninstall.sh -i silent

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

卸载过程没有提示信息，等待卸载过程完成即可。

联系博主

    xcLeigh 博主，全栈领域优质创作者，博客专家，目前，活跃在CSDN、微信公众号、小红书、知乎、掘金、快手、思否、微博、51CTO、B站、腾讯云开发者社区、阿里云开发者社区等平台，全网拥有几十万的粉丝，全网统一IP为 xcLeigh。希望通过我的分享，让大家能在喜悦的情况下收获到有用的知识。主要分享编程、开发工具、算法、技术学习心得等内容。很多读者评价他的文章简洁易懂，尤其对于一些复杂的技术话题，他能通过通俗的语言来解释，帮助初学者更好地理解。博客通常也会涉及一些实践经验，项目分享以及解决实际开发中遇到的问题。如果你是开发领域的初学者，或者在学习一些新的编程语言或框架，关注他的文章对你有很大帮助。

    亲爱的朋友，无论前路如何漫长与崎岖，都请怀揣梦想的火种，因为在生活的广袤星空中，总有一颗属于你的璀璨星辰在熠熠生辉，静候你抵达。

     愿你在这纷繁世间，能时常收获微小而确定的幸福，如春日微风轻拂面庞，所有的疲惫与烦恼都能被温柔以待，内心永远充盈着安宁与慰藉。

    至此，文章已至尾声，而您的故事仍在续写，不知您对文中所叙有何独特见解？期待您在心中与我对话，开启思想的新交流。

     💞 关注博主 🌀 带你实现畅游前后端！

     🥇 从零到一学习Python 🌀 带你玩转Python技术流！

     🏆 人工智能学习合集 🌀 搭配实例教程与实战案例，帮你构建完整 AI 知识体系

     💦 注：本文撰写于CSDN平台,作者：xcLeigh（所有权归作者所有） ，https://xcleigh.blog.csdn.net/，如果相关下载没有跳转，请查看这个地址，相关链接没有跳转，皆是抄袭本文，转载请备注本文原地址。

     📣 亲，码字不易，动动小手，欢迎 点赞 ➕ 收藏，如 🈶 问题请留言（或者关注下方公众号，看见后第一时间回复，还有海量编程资料等你来领！），博主看见后一定及时给您答复 💌💌💌