文章链接：KWDB一键部署全攻略

作者：青学会会长

在当前国产化替代的大背景下，国产数据库的应用越来越广泛。今天，我们将为大家介绍一款面向AIoT场景的国产开源分布式多模数据库——KWDB，并详细讲解如何在麒麟操作系统上一键安装KWDB单机版数据库。

KWDB数据库简介

KWDB（KaiwuDB社区版）是由开放原子开源基金会孵化及运营的开源项目，是一款面向AIoT（人工智能物联网）场景的分布式多模数据库产品。作为国产自主研发的多模数据库，KWDB以其强大的性能和灵活的功能，正逐渐成为国内数据库领域的新星。

KWDB的核心定位

KWDB是一款开源的多模数据库，由浪潮集团控股的数据库企业主导开发。它以多模架构、时序数据处理为核心，主要面向工业物联网、数字能源、交通车联网、智慧城市、数字政务等多种场景提供专业的数据存储和处理解决方案。自2024年8月由KaiwuDB 2.0 正式开源而来，经过近一年的孵化，目前最新版本已经发展到2.2.0，可以说已经是一款比较成熟的数据库了。

KWDB的技术特点

KWDB具备以下几个突出的技术特点：

1. 多模数据融合处理：支持在同一实例同时建立时序库和关系库，并能够融合处理多种模型的数据，满足复杂业务场景需求。
2. 高性能数据处理能力：具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力，适合大规模IoT应用场景。
3. 稳定安全：提供完善的安全机制，支持TLS安全模式连接和认证方式，保障数据安全。
4. 高可用性：具备完善的集群部署和故障恢复机制，确保业务连续性。
5. 易于运维：提供简单直观的部署和管理工具，降低运维复杂度。
6. 丰富的接口支持：提供JDBC、ODBC、RESTful API等多种接口，方便与各类应用系统集成。

KWDB的应用场景

KWDB特别适合以下应用场景：

• 工业物联网：处理大量传感器数据，支持实时监控和分析。
• 数字能源：能源设备监控、能耗分析和预测。
• 交通车联网：车辆数据采集、路况分析和智能调度。
• 智慧城市：城市基础设施监控、环境数据分析。
• 数字政务：政务数据整合、分析和共享。

KWDB的部署方式

KWDB支持多种部署方式，包括：

• 单节点裸机部署：适合测试环境或小规模应用场景。
• 集群部署：适合生产环境，提供高可用性和扩展性。
• 容器部署：支持Docker容器化部署，便于云环境使用。

对于初次接触KWDB的用户，单节点裸机部署是最简单直接的方式，特别是在麒麟操作系统环境下，KWDB提供了一键安装脚本，大大简化了部署过程。

麒麟系统一键安装KWDB单机数据库

介绍如何在麒麟操作系统上一键安装KWDB单机版数据库。通过以下步骤，您可以快速部署并开始使用这款强大的国产时序数据库。

环境准备

硬件要求

在安装KWDB之前，请确保您的服务器满足以下基本硬件要求：

• CPU：建议4核及以上
• 内存：建议16GB及以上
• 磁盘：建议150GB及以上（根据实际数据量调整）

操作系统要求

KWDB支持多种国产操作系统，本文以麒麟操作系统为例：

• 推荐使用：KylinOS V10 SP3 2403版本

系统配置

在安装KWDB之前，需要进行以下系统配置：

1. 关闭防火墙

systemctl stop firewalld.service
systemctl disable firewalld.service

2. 关闭SELinux

sed -i 's/^SELINUX=enforcing$/SELINUX=disabled/' /etc/selinux/config
setenforce 0
# 需要重启系统使配置生效

3. 配置hosts文件

假设您的服务器IP为10.10.10.190，主机名为kwdb：

cat >>/etc/hosts<<EOF
192.168.70.222 kwtest
EOF

4. 创建数据库管理用户

useradd kaiwudb
echo "kaiwudb" | passwd --stdin kaiwudb

5. 安装依赖包

在麒麟操作系统上，KWDB依赖以下软件包：

yum -y install protobuf geos

下载与安装KWDB

1. 获取安装包

您可以从KWDB的官方Gitee仓库下载适合麒麟操作系统的安装包： https://gitee.com/kwdb/kwdb

对于KylinOS V10 SP3 2403版本 ，请下载对应的安装包：KWDB-2.2.0-kylinV10_2403-x86_64-rpms.tar.gz

2. 解压安装包

将下载好的安装包上传到服务器后，执行以下命令解压：

mkdir -p /soft
--上传文件，解压
tar -xvf KWDB-2.2.0-kylinV10_2403-x86_64-rpms.tar.gz

3. 修改配置文件

进入解压后的安装目录，修改配置文件：

cd kwdb_install/
vi ./deploy.cfg

[global]
secure_mode=tls
management_user=kaiwudb
rest_port=8080
kaiwudb_port=26257
data_root=/var/lib/kaiwudb

[local]
node_addr=192.168.70.222

请根据实际情况修改以下参数：

• secure_mode：安全模式，可选值为tls或insecure
• management_user：管理用户名
• rest_port：REST API端口
• kaiwudb_port：数据库服务端口
• data_root：数据存储根目录
• node_addr：节点IP地址（您的服务器IP）

4. 一键安装KWDB

执行以下命令开始安装：

./deploy.sh install --single

安装过程中，系统会提示输入kaiwudb用户的密码，请输入之前设置的密码。

5. 启动数据库服务

安装完成后，执行以下命令启动数据库服务：

./deploy.sh start

6. 检查数据库运行状态

执行以下命令检查数据库是否正常运行：

./deploy.sh status

或者使用systemctl命令查看服务状态：

systemctl status kaiwudb

如果看到类似以下输出，说明数据库已成功启动：

● kaiwudb.service - KaiwuDB Service
   Loaded: loaded (/etc/systemd/system/kaiwudb.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2025-03-18 14:21:11 CST; 49s ago

7. 配置开机自启动

如果需要数据库在系统重启后自动启动，可以执行：

systemctl enable kaiwudb

创建数据库用户（可选）

默认情况下，系统使用root用户且无需密码访问数据库。如果需要创建新用户，可以执行：

bash

./add_user.sh

按照提示输入用户名和密码即可。

连接数据库

使用命令行工具连接

安装完成后，可以使用以下命令连接数据库：

安全模式连接（如果配置了TLS）

kwbase sql --certs-dir=/etc/kaiwudb/certs --host=192.168.70.222 -u root

常见问题与解决方案

1. 安装过程中遇到依赖问题

如果安装过程中提示缺少依赖包，请使用以下命令安装：

yum -y install protobuf geos

2. 无法连接数据库

如果配置了TLS安全模式但使用非安全模式连接，会出现连接失败。请确认：

• 使用正确的连接参数（安全模式或非安全模式）
• 检查防火墙是否已关闭
• 确认数据库服务是否正常运行

3. 权限问题

如果遇到权限相关错误，请检查：

• kaiwudb用户是否正确创建
• 数据目录权限是否正确
  
  

通过文章的介绍，我们了解了KWDB这款国产开源多模数据库的核心特点和应用场景，并详细讲解了如何在麒麟操作系统上一键安装KWDB单机版数据库。KWDB作为一款面向AIoT场景的分布式多模数据库，具有高性能、易部署、易使用的特点，非常适合各类物联网应用场景。

希望本文能够帮助您快速上手KWDB数据库，为您的国产化替代之路提供有力支持。如需了解更多高级功能，请参考KWDB官方文档。

参考资料

1. KWDB官方文档：https://www.kaiwudb.com/kaiwudb_docs/
2. KWDB官方代码仓库：https://gitee.com/kwdb/kwdb