KWDB 在虚拟机下的 unbuntu24.04x86-64 版本下编译安装实践

2025-07-30
重庆
本文字数：3368 字
阅读完需：约 11 分钟

作者：jiao_zg

前言：

随着物联网，智能制造，人工智能，机器人等技术的发展，单纯的关系型数据库已经不能满足所有的存储场景了。时序数据库，大模型数据在一些场合下也需要和关系型数据库共同搭配，才能完成一些融合业务。这些信息化，物联网，大模型等应用对数据的需要使用诸如关系型数据库，时序数据库等不同的类型的数据库产品，这无论是部署还是维护都会带来一些开销。本文介绍一款方便用在物联网，机器人方向的一款数据库产品：kwdb.它融合了关系型数据库，时序数据库等多种类型的数据库，很适合用在 iot 应用中。本文在 unbuntu24.04.2 x64 操作系统中，通过编译安装 KWDB 数据库，并编写简单 demo，为 IOT 的场景搭建基础的专用数据库。

一、环境准备

硬件：台式机 pc windwos 虚拟机

系统：unbuntu24.04.2 x64

kwdb:V2.2.0

二、部署规划

2.1.部署模式:

裸机，单机部署，非安全模式启动测试

为了便于测试，本文主要讲解单机部署方式。

2.2.部署方式：

源码编译

本文使用 Ubuntu 进行演示。本文将安装过程记录下来，并把遇到的坑记录下来，分享给大家。

2.3.环境依赖及版本

KWDB 支持在 Linux 操作系统进行安装部署，下表列出了编译和运行 KWDB 所需的软件依赖。

编译依赖：

运行依赖：

温馨提示：上述的版本请保证从操作系统到组件版本的一致性，否则可能会出现各种问题，请保持版本的一致性。如果不确定当前系统组件的安装版本，可以通过组件的命令 --version 进行查看，或者自行了解组件版本查看的方法，确定好组件版本之后再进行后续步骤，如果版本过高或者过低，都需要进行额外的降低版本或者升级版本的操作，请注意不要嫌麻烦，否则可能后续会造成更多的麻烦。如果根据本文进行操作，请保证使用的操作系统和本文一致，否则可能会出现其他类型的错误。如果没有对应的操作系统版本，可以到 unbuntu 官网下载，本文使用的初始版本就是直接下载后的，（例如对应的 cmake 是 4.1 版本，先降级到 3.28 后再降级到 3.23 版本，操作比较特殊）使用虚拟机安装好之后即可验证了。

4.源码下载

在 KWDB 代码仓库下载代码，并将其存储到 GOPATH 声明的目录。

5.安装路径：

/home/jiao/go

复制代码

三、环境准备及依赖安装

安装编译依赖，运行依赖，操作工具包等

3.1.安装编译依赖

参考 2.3 的表格

为了方便执行，本文将所有的依赖项统一放到一个命令里执行，请注意可能和你的系统版本有差异，所以可能会出现部分组件已安装或者找不到的情况，没关系，如果有报错的情况可后面单独执行安装。

sudo apt update && sudo apt install -y ca-certificates golang cmake autoconf golang-yacc build-essential checkinstall libssl-dev libprotobuf-dev liblzma-dev libmcurses-dev  libncursesw-dev libatomic1 libstdc++6 protobuf-compiler git

复制代码

跟本文环境不一致的操作系统，如上述组件如有一个失败，请单独进行编译安装，如果都成功且经过验证版本都符合，则可直接进入 3.2 进行运行依赖安装操作，否则需要将本部分所有依赖安装正确才能进入到下个环节，否则会出现 make 编译时失败。

修改 cmake 为 3.28 版本

# 添加 Kitware 的 CMake 仓库（包含历史版本）wget -O - https://apt.kitware.com/keys/kitware.gpg | sudo gpg --dearmor -o /usr/share/keyrings/kitware-archive-keyring.gpgecho "deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/kitware.list
# 更新仓库并安装 CMake 3.23sudo apt updatesudo apt install cmake=3.2*

复制代码

注：该版本仍然比较高，需要降级到 3.23 以下，后面会讲解

单独安装 go

sudo apt  install golang-go

复制代码

执行 gopath 查看 gopath 安装路径

 go env

复制代码

找到对应的路径，该值配置在环境变量的 gopath 中

设置环境变量

sudo vim /etc/profile

复制代码

设置 GOPATH（仅在当前终端生效）

export GOPATH="/home/jiao/go"

复制代码

/home/jiao/go 为了不出现路径不一致的操作，请将该目录和代码存放的路径保持一致

使环境变量生效

source /etc/profile

复制代码

sudo mkdir -p "$GOPATH/src" "$GOPATH/pkg" "$GOPATH/bin"

复制代码

单独安装 git

sudo apt install git

复制代码

3.2 安装运行依赖

参考 2.3 的表格

sudo apt update && sudo apt install -y openssl libssl-dev libprotobuf-dev protobuf-compiler libgeos-dev xz-utils squashfs-tools libgcc-12-dev squashfuse mount

复制代码

3.3 安装其他

安装 vim 工具

sudo apt install vim

复制代码

3.4 修改 cmak 版本到 3.20

# 查看当前 CMake 版本cmake --version
# 卸载 CMake 3.23sudo apt-get remove cmakesudo apt-get autoremovesudo apt-get clean
# 下载 CMake 3.20.3 源代码wget https://github.com/Kitware/CMake/releases/download/v3.20.3/cmake-3.20.3.tar.gztar -xzf cmake-3.20.3.tar.gzcd cmake-3.20.3
# 安装依赖项sudo apt-get updatesudo apt-get install -y build-essential g++ libssl-dev
# 创建构建目录并配置mkdir buildcd build../bootstrap
# 编译和安装make -j$(nproc)sudo make install
# 验证安装cmake --version

复制代码

安装过程比较慢，请耐心等待

3.5 安装 liblzma-dev

sudo apt-get install -y liblzma-dev

复制代码

四、部署步骤

## 4.1. 使用 git clone 命令：下载源码

#请勿修改目录路径中的 src/gitee.com/kwbasedb首先进入到代码下载路径/home/jiao/go，这里一定要和 export GOPATH="/home/jiao/go" 中的值保持一致#请勿修改目录路径中的 src/gitee.com/kwbasedbsudo git clone https://gitee.com/kwdb/kwdb.git /home/jiao/go/src/gitee.com/kwbasedb

复制代码

首次拉取代码

git config --global --add safe.directory /home/jiao/go/src/gitee.com/kwbasedbsudo git submodule update --init

复制代码

执行更新

sudo git submodule update --remote

复制代码

4.2.构建安装

cd  /home/jiao/go/src/gitee.com/kwbasedbsudo mkdir build && cd build

复制代码

4.3 运行 CMake 配置

sudo cmake .. -DCMAKE_BUILD_TYPE=Debug

复制代码

注意：等号前后不要有空格

4.4 禁用 Go 模块功能

sudo vim /etc/profile

复制代码

添加下面一行

export GO111MODULE=off

复制代码

使修改生效

source /etc/profile

复制代码

结果如下：

4.5 编译

4.5.1 编译

注意所在目录：

/home/jiao/go/src/gitee.com/kwbasedb/buildsudo make

复制代码

可能中间会因为上述组件安装失败或者版本问题导致错误，根据错误进行修正，修正后的结果最终完成日志

4.5.2 安装

/home/jiao/go/src/gitee.com/kwbasedb/buildsudo make install

复制代码

安装后的结果如下：使用 debug 模式

4.5.3 验证是否成功

进入 kwbase 脚本所在目录，查看数据库版本，验证是否安装成功。

cd /home/jiao/go/src/gitee.com/kwbasedb/install/bin./kwbase version

复制代码

安装成功后

五、使用自带工具体验

5.1 启动数据库

5.1.1 设置共享库的搜索路径。

export LD_LIBRARY_PATH=../lib

复制代码

考虑持久运行，可以修改/etc/profile

5.1.2 进入 kwbase 脚本所在目录。

cd /home/jiao/go/src/gitee.com/kwbasedb/install/bin

复制代码

5.1.3 启动数据库。

./kwbase start-single-node --insecure --listen-addr=:26257 --background

复制代码

启动提示在非安全模式下运行，先不用管，我们使用的也是单机部署，非集群部署，先忽略

5.2 使用本地数据库工具连接数据库

由于本文安装时使用的是非安全模式，所以使用非安全模式安装

注意：如果远程的话 hosthost 修改为对应 ip 地址

sudo ./kwbase sql --insecure --host=localhost

复制代码

5.3 创建第一个融合数据库

在 5.2 进入命令行操作界面之后，执行下面操作

sql 命令详情参考附件 4 链接

5.3.1 创建关系型数据库

CREATE DATABASE db1;

复制代码

查看创建的数据库

SHOW DATABASES;

复制代码

5.3.2 创建时序数据库

创建数据库命令

CREATE TS DATABASE ts1;

复制代码

查看创建的数据库

SHOW DATABASES;

复制代码

看结果是显示了关系和时序数据库两个数据库

六、附件：

1.源码 kwdb: KWDB 是一款面向【AIoT 场景】的【分布式多模数据库】，支持在同一实例同时建立时序库和关系库并融合处理多模数据，具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力，具有稳定安全、高可用、易运维等特点。 - Gitee.com

2.参考目录：

README.md · KWDB/kwdb - Gitee.com

3.编译 cmake 版本参考

centos7. 编译安装 cmake 3.23.0 - He_LiangLiang - 博客园

4.sql 命令参考：

文档中心-KaiwuDB

发布于: 刚刚阅读数: 2

原文链接:【http://xie.infoq.cn/article/8449576846f1dc7083b7dedef】。文章转载请联系作者。

KaiwuDB

关注

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

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

发布

暂无评论

创作场景

KWDB 在虚拟机下的 unbuntu24.04x86-64 版本下编译安装实践

前言：

一、环境准备

二、部署规划

2.1.部署模式:

2.2.部署方式：

2.3.环境依赖及版本

4.源码下载

5.安装路径：

三、环境准备及依赖安装

3.1.安装 编译依赖

3.2 安装运行依赖

3.3 安装其他

3.4 修改 cmak 版本到 3.20

3.5 安装 liblzma-dev

四、部署步骤

4.2.构建安装

4.3 运行 CMake 配置

4.4 禁用 Go 模块功能

4.5 编译

4.5.1 编译

4.5.2 安装

4.5.3 验证是否成功

五、使用自带工具体验

5.1 启动数据库

5.1.1 设置共享库的搜索路径。

5.1.2 进入 kwbase 脚本所在目录。

5.1.3 启动数据库。

5.2 使用本地数据库工具连接数据库

5.3 创建第一个融合数据库

5.3.1 创建关系型数据库

5.3.2 创建时序数据库

六、附件：

KaiwuDB

评论

3.1.安装编译依赖