数据库升级
升级方式
不同部署方式支持的升级方式有所不同：
单机部署：
- 使用升级脚本将 2.1.x 离线升级至 2.2.0，有关详细信息，参见单机升级。
- 使用升级和标签调整脚本将 2.0.4 或 2.0.4.1 升级至 2.1.0，有关详细信息，参见 2.1.0 版本数据库升级。
- 导入导出升级：通过导入导出方式将任一版本升级至最新版本。有关详细信息，参见数据导出和数据导入。
多副本集群：
- 通过逐一升级集群节点将 2.1.x 在线升级至 2.2.0，有关详细信息，参见多副本集群升级。
- 使用升级和标签调整脚本将 2.0.4 或 2.0.4.1 在线升级至 2.1.0，有关详细信息，参见 2.1.0 版本集群升级。
- 导入导出升级：通过导入导出方式将之前任一版本升级至最新版本。具体操作，参见数据导出和数据导入。注意：使用导入导出升级方式升级后，集群的高可用性可能会受到影响。
单副本集群：
说明
升级后无法简单降级至之前版本。如果需要降级，必须先卸载当前版本，再使用原有版本安装 KaiwuDB，然后使用卸载前创建的备份将数据还原到数据库。有关卸载单机版数据库的详细信息，参见卸载数据库。有关卸载集群版本的详细信息，参见卸载集群。
三权分立模式下，如需从历史版本升级到 KaiwuDB 2.1.1 及后续版本，升级前需要删除已有的
secroot、sysroot、auditroot、secadmin、sysadmin、auditadmin用户。如未删除，启动新版本时，系统报错：failed to run migration "disallow exist separate user": found users [auditadmin, auditroot, secadmin, secroot, sysadmin, sysroot] which are now reserved names. Please drop the role using a previous version of KaiwuDB and try
单机升级
本节介绍了如何将 2.1.x 单机版本离线升级至 2.2.0 版本。
升级过程中，如果出现节点未安装 KaiwuDB、KaiwuDB 仍在运行中、版本有误或部署方式有误等错误，系统将中止升级，并给与用户相应提示。
升级过程中，如果因新版本导入失败导致升级失败，系统将保留数据目录、证书和配置文件，删除节点中的新版本安装文件，用户可以选择手动安装新版本或旧版本。
前提条件
- 待升级节点已安装 KaiwuDB。
- 已备份待升级节点的用户数据目录。
- 已获取新版本的 KaiwuDB 安装包，且新版本高于已安装版本。
- 用户为 root 用户或者拥有
sudo权限的普通用户。- root 用户和配置
sudo免密的普通用户在执行命令时无需输入密码。 - 未配置
sudo免密的普通用户在执行命令时，需要输入密码进行提权。 - 容器部署方式下，如果用户为非 root 用户，需要通过
sudo usermod -aG docker $USER命令将用户添加到docker组。
- root 用户和配置
步骤
将新版本安装包拷贝至待升级的节点，解压安装包。
检查 KaiwuDB 服务是否已停止。如果 KaiwuDB 服务仍在运行中，执行
systemctl stop kaiwudb命令停止服务。systemctl status kaiwudb切换至新版本的安装包目录。
执行本地升级命令。
./deploy.sh upgrade -l或者
./deploy.sh upgrade --local执行成功后，控制台输出以下信息：
UPGRADE COMPLETED: KaiwuDB has been upgraded successfully!启动 KaiwuDB。
systemctl start kaiwudb启动成功后，检查数据库是否已正常运行。
systemctl status kaiwudb
多副本集群升级
本节介绍了如何通过逐一升级集群节点将 2.1.x 多副本集群在线升级至 2.2.0 版本。
在升级过程中，升级节点上的压缩与生命周期可能会执行失败，在升级完成后恢复正常。如果升级过程中出现错误，例如节点未安装 KaiwuDB、节点状态异常或部署方式有误，系统将中止升级，并给与相应提示。
准备升级
步骤：
确保客户端与多个节点通信，避免单节点升级时客户端通信中断。
查看集群状态。
在 KaiwuDB 监控平台的
总览页面查看集群状态：在
节点状态下检查是否有异常节点或不可用节点，如果有，需要确认原因，重新启动或者停用该节点。集群中存在异常或不可用节点时，将无法进行升级。
在
副本状态下检查是否有不可用分区或副本数不足分区。
在
Nodes下检查各节点版本是否一致，内存和 CPU 等资源是否有足够的余量，如果资源紧张，需要先添加节点到集群中，再进行升级操作，以避免升级后的版本可能使用更多的资源。
通过命令查看集群状态：
检查集群节点状态。
<kwbase_path>/kwbase node status [--host=<ip:port>] [--insecure | --certs-dir=<path>]查看副本状态。
SELECT sum((metrics->>'ranges.unavailable')::DECIMAL)::INT AS ranges_unavailable, sum((metrics->>'ranges.underreplicated')::DECIMAL)::INT As ranges_underreplicated FROM kwdb_internal.kv_store_status;
在 KaiwuDB 监控平台的
事件页面或使用SHOW JOBSSQL 命令检查是否存在正在执行的模式更改或批量导入操作。使用
SELECT * from kwdb_internal.rangesSQL 命令检查集群内表的 leaseholder（租约持有者）和副本的分布是否均匀。备份集群。如果升级失败，可以使用备份将集群还原到之前的状态。
执行升级
为集群中的每个节点，执行以下升级操作。确保每次只升级一个节点。该节点重新加入集群后，确认节点版本、状态无误后，再升级下一个节点。
前提条件：
- 待升级节点已安装 KaiwuDB，且节点状态为存活状态（
is_available和is_live均为true）。 - 已备份待升级节点的用户数据目录。
- 已获取新版本的 KaiwuDB 安装包，且新版本高于已安装版本。
- 用户为 root 用户或者拥有
sudo权限的普通用户。- root 用户和配置
sudo免密的普通用户在执行命令时无需输入密码。 - 未配置
sudo免密的普通用户在执行命令时，需要输入密码进行提权。 - 容器部署方式下，如果用户为非 root 用户，需要通过
sudo usermod -aG docker $USER命令将用户添加到docker组。
- root 用户和配置
步骤：
将新版本的安装包拷贝到待升级的节点，解压安装包。
检查 KaiwuDB 服务是否已停止。如果 KaiwuDB 服务仍在运行中，执行
systemctl stop kaiwudb命令停止服务。systemctl status kaiwudb切换至新版本的安装包目录。
执行本地升级命令。
./deploy.sh upgrade -l或者
./deploy.sh upgrade --local执行成功后，控制台输出以下信息：
UPGRADE COMPLETED: KaiwuDB has been upgraded successfully! ...启动 KaiwuDB。
systemctl start kaiwudb启动成功后，检查数据库是否已正常运行。
systemctl status kaiwudb
单副本集群升级
本节介绍了如何将 2.1.x 单副本集群离线升级至 2.2.0 版本。
升级过程中，如果出现节点未安装 KaiwuDB、KaiwuDB 仍在运行中、版本有误或部署方式有误等错误，系统将中止升级，并给与用户相应提示。
升级过程中，如果因新版本导入失败导致升级失败，系统将保留数据目录、证书和配置文件，删除节点中的新版本安装文件，用户可以选择手动安装新版本或旧版本。
前提条件
- 待升级节点已安装 KaiwuDB。
- 已备份所有节点的用户数据目录。
- 已获取新版本的 KaiwuDB 安装包，且新版本高于已安装版本。
- 用户为 root 用户或者拥有
sudo权限的普通用户。- root 用户和配置
sudo免密的普通用户在执行命令时无需输入密码。 - 未配置
sudo免密的普通用户在执行命令时，需要输入密码进行提权。 - 容器部署方式下，如果用户为非 root 用户，需要通过
sudo usermod -aG docker $USER命令将用户添加到docker组。
- root 用户和配置
步骤
在集群所有节点执行停止数据库命令。
systemctl stop kaiwudb在每个节点执行以下升级操作：
将新版本安装包拷贝至待升级的节点，解压安装包。
切换至新版本的安装包目录。
执行本地升级命令。
./deploy.sh upgrade -l或者
./deploy.sh upgrade --local执行成功后，控制台输出以下信息：
UPGRADE COMPLETED: KaiwuDB has been upgraded successfully!
所有节点完成升级后，在每个节点执行以下命令启动数据库。
启动数据库。
systemctl start kaiwudb启动成功后，检查数据库是否已正常运行。
systemctl status kaiwudb