作者：胖头鱼的鱼缸

原文链接：https://mp.weixin.qq.com/s/-4Ec88ItlOyeR0HEiwy72g

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上的安装包下载列表则是：

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

分区如下：

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就弹出了“创建新链接”的页面，这里尝试将数据库的连接加入：

选择KaiwuDB驱动

配置连接信息并测试

测试成功后点击完成即可。

检查数据库

创建数据库

这里就不做其他数据库的功能性测试了。

7 意见和建议

• 官方文档小问题比较多，包括但不限于内容错误、表达不明确或未提醒等，希望检查并修正

• 安装包适配系统覆盖不足，最重要的是连列表中的都没覆盖完

• 在比较重要的操作系统配置，没有明确说明

总结

本期完成了KWDB单节点裸机部署，并完成了连接即简单测试。官方文档和安装文件还是有不少小纰漏，希望改进。
老规矩，知道写了些啥。