作者：胖头鱼的鱼缸

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

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

因此只能使用 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/configsetenforce 0[reboot]

2.3 配置 hosts 文件

cat >>/etc/hosts<<EOF10.10.10.190 kwdbEOF

2.4 创建用户

useradd kaiwudbecho "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=tlsmanagement_user=kaiwudbrest_port=8080kaiwudb_port=26257data_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.shPlease 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 单节点裸机部署，并完成了连接即简单测试。官方文档和安装文件还是有不少小纰漏，希望改进。老规矩，知道写了些啥。