数据库升级

单机升级

KWDB 单机部署仅支持离线升级。裸机版本和容器版本升级方式略有不同，裸机版本升级方式见裸机版本升级；容器版本升级方式见容器版本升级。

如果升级过程中出现错误，例如节点未安装 KWDB, KWDB 仍在运行中、版本有误或部署方式有误，系统将中止升级，并给与用户相应提示。

如果升级过程中因新版本导入失败导致升级失败，系统将保留数据目录、证书和配置文件，删除节点中的新版本安装文件，由用户自行决定后续手动安装新版本或旧版本。

注意

升级后无法简单降级到之前版本。如果需要降级，必须先卸载现有版本，使用原有版本安装后，并通过卸载前创建的备份将数据还原到数据库。数据库卸载步骤见卸载数据库。

裸机版本升级

前提条件：

• 待升级节点已安装 KWDB。
• 已备份待升级节点的用户数据目录。
• 已获取新版本的 KWDB 安装包，且新版本高于已安装版本。
• 用户为 root 用户或者拥有 sudo 权限的普通用户。
  • root 用户和配置 sudo 免密的普通用户在执行命令时无需输入密码。
  • 未配置免密的普通用户在执行命令时需要输入密码进行提权。

步骤：

1. 将新版本的安装包拷贝到待升级的节点，解压安装包。

2. 检查 KWDB 服务是否已停止，如果 KWDB 服务仍在运行中，执行 systemctl stop kaiwudb 命令停止服务。

   systemctl status kaiwudb
   

3. 在新版本的安装包目录执行本地升级命令。

   ./deploy.sh upgrade -l
   

   或者

   ./deploy.sh upgrade --local
   

   升级成功后，系统将显示以下提示信息：

   UPGRADE COMPLETED: KaiwuDB has been upgraded successfully! ...
   

4. 如需从 2.0.4 升级至 2.1.0 版本，执行时序标签调整命令。

   sudo -u kaiwudb <alter_tag_path>/alter_tag <store_path>
   

   参数说明：

   • alter_tag_path：alter_tag 脚本所在目录，默认为 kaiwudb_install/others。
   • store_path：数据文件的存储路径，使用 deploy.sh 脚本部署时，数据文件的存储路径默认为/var/lib/kaiwudb；使用源码编译部署时，存储路径取决于 --store 的配置，未指定时，KaiwuDB 将在 kwbase 所在目录下创建名为 kwbase-data 的数据目录。

   示例：

   sudo -u kaiwudb ./others/alter_tag /var/lib/kaiwudb/ 
   

5. 启动 KWDB。

   systemctl start kaiwudb
   

6. 启动成功后，检查数据库是否已正常运行。

   systemctl status kaiwudb
   

容器版本升级

前提条件：

• 待升级节点已安装 KWDB。
• 已备份待升级节点的用户数据目录。
• 已获取新版本的 KWDB 安装包，且新版本高于已安装版本。
• 用户为 root 用户或者拥有 sudo 权限的普通用户。
  • root 用户和配置 sudo 免密的普通用户在执行命令时无需输入密码。
  • 未配置 sudo 免密的普通用户在执行命令时，需要输入密码进行提权。
  • 如果用户为非 root 用户，需要通过 sudo usermod -aG docker $USER 命令将用户添加到 docker 组。

步骤：

1. 将新版本的安装包拷贝到待升级的节点，解压安装包。

2. 检查 KWDB 服务是否已停止。如果 KWDB 服务仍在运行中，执行 systemctl stop kaiwudb 命令停止服务。

   systemctl status kaiwudb
   

3. 在新版本的安装包目录执行本地升级命令。

   ./deploy.sh upgrade -l
   

   或者

   ./deploy.sh upgrade --local
   

   执行成功后，控制台输出以下信息：

   UPGRADE COMPLETED: KaiwuDB has been upgraded successfully! ...
   

4. 如需从 2.0.4 版本升级至 2.1.0 版本，执行以下命令调整时序标签。

   1. 导入工具镜像。

      docker load -i others/tool.tar
      

   2. 启动工具容器。

      docker run -itd --privileged --name tool -v /var/lib/kaiwudb/:/opt/kaiwudb/ kaiwudb_tool:latest
      

   3. 进入容器执行标签调整命令。

      <alter_tag_path>/alter_tag <store_path>
      

      参数说明：

      • alter_tag_path：alter_tag 脚本所在目录，默认为/kaiwudb/bin。
      • store_path：数据文件的存储路径，存储路径取决于启动容器时指定的挂载目录。

      示例：

      /kaiwudb/bin/alter_tag /opt/kaiwudb/
      

   4. 退出工具容器。

   5. 删除工具容器。

      docker rm tool
      

   6. 删除工具镜像。

      docker rmi kaiwudb_tool:latest
      

5. 启动 KaiwuDB。

   systemctl start kaiwudb
   

6. 启动成功后，检查数据库是否已正常运行。

   systemctl status kaiwudb
   

集群升级

KWDB 集群支持 KWDB 2.0 和 2.0.4 版本通过导入导出方式升级到 2.1.0 版本，具体导入导出操作见数据导出和数据导入。

注意

由于 2.0.4 版本与早期版本之间存在兼容性差异，使用导入导出方式升级到 2.0.4 版本后，集群的高可用性可能会受到影响.