写点什么

KWDB 一键部署全攻略

作者:KaiwuDB
  • 2025-07-25
    重庆
  • 本文字数:2737 字

    阅读完需:约 9 分钟

KWDB一键部署全攻略

作者:青学会会长


原文链接:https://mp.weixin.qq.com/s/DdLyvMVZO8Ttq0BT-3uqNg


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


KWDB 数据库简介

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

KWDB 的核心定位

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

KWDB 的技术特点

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


  • 多模数据融合处理:支持在同一实例同时建立时序库和关系库,并能够融合处理多种模型的数据,满足复杂业务场景需求。

  • 高性能数据处理能力:具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力,适合大规模 IoT 应用场景。

  • 稳定安全:提供完善的安全机制,支持 TLS 安全模式连接和认证方式,保障数据安全。

  • 高可用性:具备完善的集群部署和故障恢复机制,确保业务连续性。

  • 易于运维:提供简单直观的部署和管理工具,降低运维复杂度。

  • 丰富的接口支持:提供 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.servicesystemctl disable firewalld.service
复制代码

2. 关闭 SELinux

sed -i 's/^SELINUX=enforcing$/SELINUX=disabled/' /etc/selinux/configsetenforce 0# 需要重启系统使配置生效
复制代码

3. 配置 hosts 文件

假设您的服务器 IP 为 10.10.10.190,主机名为 kwdb:


cat >>/etc/hosts<<EOF192.168.70.222 kwtestEOF
复制代码

4. 创建数据库管理用户

useradd kaiwudbecho "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=tlsmanagement_user=kaiwudbrest_port=8080kaiwudb_port=26257data_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 用户且无需密码访问数据库。如果需要创建新用户,可以执行:



./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 官方文档。


参考资料


KWDB 官方文档:https://www.kaiwudb.com/kaiwudb_docs/


KWDB 官方代码仓库:https://gitee.com/kwdb/kwdb


发布于: 刚刚阅读数: 5
用户头像

KaiwuDB

关注

还未添加个人签名 2021-04-29 加入

KaiwuDB 是浪潮集团控股的数据库企业,公司汇聚了全球顶尖的数据库人才,以多模数据库为核心产品,面向工业物联网、数字能源、交通车联网、智慧产业等各大行业领域,提供领先创新的数据服务软件。

评论

发布
暂无评论
KWDB一键部署全攻略_KaiwuDB_InfoQ写作社区