KWDB Install — KWDB 安装

KWDB 安装概述 本技能为 KaiwuDB 提供脚本部署，适用于 Linux 环境下的裸机或容器部署。支持单副本和多副本集群部署，并提供完整的部署工作流指导。

强制规则 以下三个规则必须严格遵守：

• 禁止猜测安装参数

不要猜测或假设任何安装参数，除非用户明确指定。所有配置参数（端口、IP、数据目录、安全模式等）必须逐一确认用户。 即使用户说“使用默认值”，也必须显式列出默认值并确认用户。 安装包路径必须由用户显式提供，并且不能猜测。

• 安装失败时必须读取日志

安装命令失败时，必须读取与安装脚本相同路径下的 log/ 目录中的日志文件以获取详细的失败信息。 日志文件路径：/opt/kaiwudb//log/ 或 kaiwudb_install/log/ 安装失败后，先读取日志 ls -la log/ cat log/install.log 或最新生成的日志文件

• 报告失败后退出，禁止任意重试

安装失败后，必须： 清晰地向用户显示从日志中获得的错误信息 解释可能的原因 退出安装过程，不要自行重试 等待用户指令后决定下一步 异常：只有当用户明确请求“重试”时，才能再次执行安装命令。

前置条件 系统要求 硬件：内存至少 8 GB RAM（推荐 16 GB），CPU 至少 2 核（推荐 4 核），磁盘至少 50 GB 可用空间（推荐 SSD） 操作系统：CentOS 7/8，Ubuntu 18.04/20.04/22.04 网络：所有节点必须具有网络连接 用户权限：节点之间配置了无密码 SSH 登录，用户必须是 root 或具有 sudo 权限 对于容器部署，非 root 用户必须在 docker 组中

部署步骤 步骤 1：确认部署模式 首先，我需要确认您需要的部署模式： 询问：“请选择部署模式：单节点部署（single）或集群部署（cluster）？”

步骤 1.1：确认集群副本数 - 集群模式仅 如果选择集群部署，我需要进一步确认副本数： 询问：“请选择集群部署类型：单副本集群（single-replica）或多副本集群（multi-replica）？”

步骤 2：确认安装包位置 接下来，我需要确认 KaiwuDB 安装包的位置。 安装包应该是一个以 KaiwuDB 为前缀的 .tar.gz 文件，例如：KaiwuDB-1.0.0.tar.gz。 询问：“请提供 KaiwuDB 安装包的完整路径（包括文件名）。安装包应该是一个以 KaiwuDB 为前缀的 tar.gz 文件，例如 /path/to/KaiwuDB-1.0.0.tar.gz。” 注意：必须等待用户提供确切的路径，并且不能自行猜测。

步骤 3：验证安装包 确认安装包位置后，验证文件是否存在并且格式正确： 检查安装包是否存在 if [ ! -f "$INSTALL_PACKAGE_PATH" ]; then echo "错误：安装包不存在，请检查路径是否正确" exit 1 fi 检查文件名格式 if [[ "$(basename $INSTALL_PACKAGE_PATH)" != KaiwuDB*.tar.gz ]]; then echo "错误：安装包文件名不正确。它应该是一个以 KaiwuDB 为前缀的 tar.gz 文件" exit 1 fi

步骤 4：解压安装包并配置 创建安装目录 sudo mkdir -p /opt/kaiwudb 解压安装包 tar -xzf "$INSTALL_PACKAGE_PATH" -C /opt/kaiwudb 进入安装目录 cd /opt/kaiwudb/kaiwudb_install

步骤 5：配置 deploy.cfg 文件 我将根据您选择的部署模式逐步询问每个配置项，然后根据您的回答修改 deploy.cfg 配置文件。 强制：除非用户自愿说“全部默认”或明确指定参数值，否则每个项必须逐一确认。 即使用户选择默认值，也必须显示并确认默认值。

全局配置（global）- 所有模式共用 安全模式（secure_mode）： 询问：“请选择安全模式：不安全模式（insecure）、TLS 安全模式（tls，默认）或 TLCP 安全模式（tlcp）” 管理用户（management_user）： 询问：“请输入 KaiwuDB 管理用户名（默认：kaiwudb）” RESTful 端口（rest_port）： 询问：“请输入 KaiwuDB Web 服务端口（默认：8080）” KaiwuDB 服务端口（kaiwudb_port）： 询问：“请输入 KaiwuDB 服务端口（默认：26257）” BRPC 端口（brpc_port）： 询问：“请输入 KaiwuDB BRPC 端口（默认：...）”