KWDB 是浪潮 KaiwuDB 推出的开源分布式多模数据库，专注于 AIoT 场景的数据管理需求。本文将详细介绍从环境准备、安装部署到基本测试的全流程操作，并总结实践中的常见问题与解决方案。
一、环境准备与安装前检查
1.1 系统要求
KWDB 2.2.0 支持多种操作系统环境，包括：
- Ubuntu：20.04/22.04 LTS 版本（推荐）
- CentOS：7.x/8.x 版本
- 龙蜥（Anolis OS）：8.x 版本
硬件要求：
- 内存：最低 4GB，生产环境推荐 8GB 以上
- 存储：至少 50GB 可用空间
- CPU：x86_64 架构，建议 4 核以上
1.2 依赖组件安装
在 Ubuntu 22.04 系统上，需要先安装以下依赖：
sudo apt update
sudo apt install -y cmake
sudo snap install go --classic
sudo apt install -y libprotobuf-dev
这些组件是 KWDB 运行的基础环境，缺少任一组件都可能导致安装失败
1.3 安装包获取
从官方仓库下载预编译的 KWDB 安装包：
wget https://gitee.com/kwdb/kwdb/releases/download/V2.2.0/KWDB-2.2.0-ubuntu22.04-x86_64-debs.tar.gz
下载完成后解压：
tar zxvf KWDB-2.2.0-ubuntu22.04-x86_64-debs.tar.gz
cd kwdb_install/
二、单机版安装部署
2.1 基础配置
在安装前需要配置环境变量，避免依赖冲突：
echo 'export GO111MODULE=off' >> ~/.bashrc
echo 'export GO111MODULE=off' >> /etc/profile
source ~/.bashrc
source /etc/profile
2.2 执行安装
使用提供的部署脚本进行安装：
./deploy.sh install --single
安装过程需要 root 权限，会提示输入密码。安装完成后重新加载系统服务配置：
systemctl daemon-reload
2.3 启动与验证
启动 KWDB 服务：
Bash
systemctl start kaiwudb.service
检查服务状态：
systemctl status kaiwudb
正常运行的输出应显示"active (running