数据库管理-第315期 KWDB单节点裸机试玩（20250414）

原创胖头鱼的鱼缸 2025-04-13

数据库管理315期 2025-04-14

数据库管理-第315期 KWDB单节点裸机试玩（20250414）

1 环境说明
2 操作系统配置

2.1 关闭防火墙
2.2 关闭SELinux
2.3 配置hosts文件
2.4 创建用户
2.5 安装依赖包
2.6 其他配置

3 安装KWDB

3.1 解压安装包
3.2 修改配置文件
3.3 安装数据库
3.4 重新加载systemd守护进程的配置文件
3.5 启动数据库
3.6 检查数据库运行状态
3.7 配置开机启动
3.8 新建数据库用户（可选）

4 安装后检查
5 访问数据库
6 KWDB开发者中心

选择KaiwuDB驱动
配置连接信息并测试
检查数据库
创建数据库

7 意见和建议
总结

数据库管理-第315期 KWDB单节点裸机试玩（20250414）

作者：胖头鱼的鱼缸（尹海文）
Oracle ACE Pro: Database
PostgreSQL ACE Partner

10年数据库行业经验
拥有OCM 11g/12c/19c、MySQL 8.0 OCP、Exadata、CDP等认证
墨天轮MVP，ITPUB认证专家
圈内拥有“总监”称号，非著名社恐（社交恐怖分子）

公众号：胖头鱼的鱼缸
CSDN：胖头鱼的鱼缸（尹海文）
墨天轮：胖头鱼的鱼缸
ITPUB：yhw1809。
除授权转载并标明出处外，均为“非法”抄袭
复制

KWDB 是由开放原子开源基金会孵化及运营的开源项目，是一款面向 AIoT 场景的分布式多模数据库产品，支持在同一实例同时建立时序库和关系库并融合处理多模数据，具备千万级设备接入、百万级数据秒级写入、亿级数据秒级读取等时序数据高效处理能力，具有稳定安全、高可用、易运维等特点。
本期试玩一下KWDB单节点裸机部署。参考信息如下：

Gitee：https://gitee.com/kwdb/kwdb
官网文档：https://www.kaiwudb.com/kaiwudb_docs/#/oss_v2.2.0/quickstart/install-kaiwudb/quickstart-bare-metal.html

1 环境说明

在选择操作系统时，遇到了第一个问题，官网的操作系统支持列表如下：

本想选择Anolis OS8.6，但是Gitee上的安装包下载列表则是：

没有Anolis OS（其实还有几个也没有）对应的安装包，另一方面：

因此只能使用KylinOS V10 SP3 2403，这期间还得重装系统，具体环境如下：

项目	内容
操作系统	KylinOS V10 SP3 2403
IP地址	10.10.10.190
CPU	4
内存	16G
磁盘	150G

分区如下：

2 操作系统配置

2.1 关闭防火墙

systemctl stop firewalld.service 
systemctl disable firewalld.service
复制

2.2 关闭SELinux

sed -i 's/^SELINUX=enforcing$/SELINUX=disabled/' /etc/selinux/config
setenforce 0
[reboot]
复制

2.3 配置hosts文件

cat >>/etc/hosts<<EOF
10.10.10.190 kwdb
EOF
复制

2.4 创建用户

useradd kaiwudb
echo "Kwdb#123" | passwd --stdin kaiwudb
复制

2.5 安装依赖包

数据库依赖包如如下：

在KylinOS V10 SP3 2403需要安装：

yum -y install protobuf geos
复制

2.6 其他配置

这里无论是在Gitee还是官方文档中，都没有关于/etc/sysctl.conf和/etc/security/limits.conf，暂且把相关配置留下，看后面安装过程是否会遇到问题。

3 安装KWDB

安装包：tar -xvf KWDB-2.2.0-kylinV10_2403-x86_64-rpms.tar.gz

3.1 解压安装包

tar -xvf KWDB-2.2.0-kylinV10_2403-x86_64-rpms.tar.gz
复制

3.2 修改配置文件

cd kwdb_install/
vim ./deploy.cfg
# 基本信息如下：
[global]
secure_mode=tls
management_user=kaiwudb
rest_port=8080
kaiwudb_port=26257
data_root=/var/lib/kaiwudb
[local]
node_addr=10.10.10.190
复制

3.3 安装数据库

./deploy.sh install --single
复制

这里小小吐槽一下官方文档要求需要给这个文件加执行权限，但是解压后已有执行权限，直接运行即可：

这中间需要输入kaiwudb用户的密码，但是交互终端做的非常不好，希望改进。

3.4 重新加载systemd守护进程的配置文件

systemctl daemon-reload
复制

3.5 启动数据库

./deploy.sh start
# 对应关闭数据库则是
#./deploy.sh stop
复制

3.6 检查数据库运行状态

./deploy.sh status
复制

3.7 配置开机启动

systemctl enable kaiwudb
复制

3.8 新建数据库用户（可选）

如果跳过该步骤，系统将默认使用root用户，且无需密码访问数据库。

./add_user.sh
Please enter the username: 
Please enter the password:
[ADD USER COMPLETED]:User creation completed.
复制

4 安装后检查

经过对/etc/sysctl.conf（包含sysctl.d/下）和/etc/security/limits.conf（包含limits.d/下）均为变更，在生产环境中是否会对数据库运行造成影响，官方文档并没有明确说明，希望改进。下面是/etc/sysctl.conf中包含的Kylin自带的内容：

数据目录内容如下：

5 访问数据库

kwbase sql --insecure --host=10.10.10.190
复制

root密码？我这里并没有执行add_user.sh，应该是无需密码即可访问数据库啊？！这里仔细阅读官方文档，因为部署前配置了tls作为安全模式，需要指定安全认证文件，这里希望在文档中可以重点强调一下。换一个命令试试：

kwbase sql --certs-dir=/etc/kaiwudb/certs --host=10.10.10.190 -u root
# 官方文档的认证文件路径为etc/kwdb/certs，又是一个错误
复制

终于可以正常访问数据库了。

还是用add_user.sh创建一个用户然后再尝试登陆：

6 KWDB开发者中心

KWDB还提供了一个可视化界面的开发者中心（KaiwuDB Developer Center，下简称KWDC），这里下载了一个Windows版的：

虽然官方文档要求了OpenJRE 8及以上版本但是包里面是已经集成了JRE，不需要单独安装。

打开KWDC就弹出了“创建新链接”的页面，这里尝试将数据库的连接加入：