部署准备
硬件
下表列出部署 KWDB 所需的硬件规格。
| 项目 | 要求 |
|---|---|
| CPU 和内存 | 单节点配置建议不低于 4 核 8G。对于数据量大、复杂的工作负载、高并发和高性能场景，建议配置更高的 CPU 和内存资源以确保系统的高效运行。 |
| 磁盘 | - 推荐使用 SSD 或者 NVMe 设备，尽量避免使用 NFS、CIFS、CEPH 等共享存储。 - 磁盘必须能够实现 500 IOPS 和 30 MB/s 处理效率。 - 使用 HDD 硬盘部署单机版本时，避免设备数过多或每秒写入测点数过高，否则数据写入性能将显著下降 - KWDB 系统自身启动不会占用过多磁盘容量（低于 1G）。实际所需磁盘大小主要取决于用户的业务量。 |
| 文件系统 | 建议使用 ext4 文件系统。 |
操作系统
KWDB 支持在以下操作系统进行安装部署：
| 操作系统 | 版本 | 裸机部署 | 裸机部署 | 容器部署 | 容器部署 |
|---|---|---|---|---|---|
| ARM64 | x86_64 | ARM64 | x86_64 | ||
| Anolis | 7 | ✓ | ✓ | ||
| 8 | ✓ | ✓ | ✓ | ✓ | |
| CentOS | 7 | ✓ | |||
| 8 | ✓ | ||||
| Debian | V11 | ✓ | |||
| openEuler | 24.03 | ✓ | |||
| Ubuntu | V20.04 | ✓ | ✓ | ✓ | ✓ |
| V22.04 | ✓ | ✓ | ✓ | ✓ | |
| V24.04 | ✓ | ✓ | ✓ | ✓ | |
| UOS | 1050e | ✓ | ✓ | ||
| 1060e | ✓ | ✓ | |||
| 1070e | ✓ | ✓ | ✓ | ✓ | |
| Windows Server | WSL2 | ✓ | ✓ |
说明
- 容器部署需要目标机器已安装 Docker。如未安装，请参考 Docker 官方安装文档 进行安装。对于无法联网的环境，可下载 Docker 二进制包进行离线安装，详见 Docker 离线安装指南。
- 未提及的操作系统版本也许可以运行 KWDB，但尚未得到 KWDB 官方支持。
- 如需获取下载页面未提供的对应版本安装包，请联系 KWDB 技术支持。
软件依赖
裸机部署
下表列出需要在目标机器安装的依赖：
| 依赖 | 版本 | 说明 |
|---|---|---|
| OpenSSL | v1.1.1+ | N/A |
| libprotobuf | v3.6.1 ~ v21.x | Ubuntu 18.04 版本默认的 libprotobuf 版本低于所需版本，用户需要在部署前提前安装高版本的 libprotobuf。 |
| GEOS | v3.3.8+ | 可选依赖 |
| xz-libs | v5.2.0+ | N/A |
| libgcc | v7.3.0+ | N/A |
| libgflags | 系统默认 | N/A |
| libkrb5 | 系统默认 | N/A |
安装时，KWDB 会对依赖进行检查。如果缺少依赖会退出安装并提示依赖缺失。如果目标机器不能联网，用户需要在能联网的机器上根据目标机器的操作系统下载好所有依赖文件，然后将依赖文件复制到目标机器上进行安装。
容器部署
使用脚本部署时，目标机器需已安装 Docker Compose（1.20.0 及以上版本）。
在线安装：参考 Docker Compose 官方安装文档
离线安装：参考 Docker Compose 离线安装指南
Ubuntu/Debian 系统快速安装：
sudo apt-get install docker-compose
端口要求
下表列出 KWDB 服务默认使用的端口。如需使用其他端口，可在安装部署过程中进行修改。
| 端口号 | 说明 |
|---|---|
8080 | 数据库 Web 服务端口 |
26257 | 数据库服务端口和对外连接端口 |
安装包、容器镜像和编译版本
根据不同的使用场景，获取安装包、容器镜像或源码编译版本：
安装包
目前 KWDB 开源仓库提供了以下系统与架构的 DEB 或 RPM 安装包，如需其它系统或架构的安装包，请联系 KWDB 技术支持：
- Ubuntu V20.04 x86_64
- Ubuntu V20.04 ARM64
- Ubuntu V22.04 x86_64
- Ubuntu V22.04 ARM64
获取系统环境对应的 DEB 或 RPM 安装包后，将安装包复制到待安装 KWDB 的目标机器上，然后解压缩安装包：
tar -zxvf <package_name>
解压后生成的目录包含以下文件：
| 文件 | 说明 |
|---|---|
add_user.sh | 安装、启动 KWDB 后，为 KWDB 数据库创建用户。 |
deploy.cfg | 安装部署配置文件，用于配置部署节点的 IP 地址、端口等配置信息。 |
deploy.sh | 安装部署脚本，用于安装、卸载、启动、状态获取、关停和重启等操作。 |
packages 目录 | 存放 DEB 或 RPM 包。 说明：具体包含的文件因安装包类型而异。 |
utils 目录 | 存放工具类脚本。 |
容器镜像
KWDB 支持通过以下方式获取容器镜像：
KWDB 3.1.0 之前的版本
下载容器安装包，解压后在
kwdb_install/packages目录下导入KaiwuDB.tar文件。docker load < KaiwuDB.tar Loaded image: "image-name"KWDB 3.1.0 及以后的版本
运行以下命令，获取 KWDB Docker 镜像。如获取最新的镜像版本，运行
docker pull kwdb/kwdb:latest"命令。docker pull kwdb/kwdb:<version>
源码编译和安装
根据 KWDB 编译和安装说明完成源码下载、编译和安装。