#离线升级回退

数据库升级过程中可能因为网络故障、命令错误、配置文件错误及版本错误等原因导致数据库升级失败，此时请运行升级回退恢复升级前环境。

Warn:

仅升级失败才允许回退。

升级回退的过程中会重启数据库。

回退过程中，不建议对数据库节点进行其他操作。如无法避免，只能使用yasboot执行相关管理操作。

若升级失败且回退仍失败，请联系我们的技术支持解决。

升级成功后，执行回退会报错：

$ ./bin/yasboot cluster rollback -c yashandb -p sys_password
yashandb can't rollback because upgrade result is success

# 步骤1：回退数据库

升级失败时执行升级回退预期结果：

$ ./bin/yasboot cluster rollback -c yashandb -p sys_password
+---------------------------------------------------------------------------------------------------------------------+
| type  | uuid             | name                 | hostid   | index        | status  | return_code | progress | cost |
+---------------------------------------------------------------------------------------------------------------------+
| task  | c82ebcbb5fb4acd3 | RollbackYasdbCluster | -        | yashandb     | SUCCESS | 0           | 100      | -    |
+-------+------------------+----------------------+----------+--------------+---------+-------------+----------+------+

task completed, status: SUCCESS

参数介绍：

-c, --cluster 集群名称

# 步骤2：回退yasom与yasagent

Note:

仅23.2.x及以上之间升级失败时，需执行此步骤。

$ ./bin/yasboot package rollback -c yashandb -t /home/yashan/install/hosts.toml 
rollback package...
host0001 100% [====================================================================]    2s

参数介绍：

-c, --cluster 集群名称
-t, --toml  需要服务器配置文件hosts.toml，此处指部署旧版本时生成的hosts.toml文件

# 步骤3：回退后操作

若为顺利执行升级操作而临时调整过某些配置（例如关闭仲裁），回退后若无需再升级应按需还原配置（例如重新开启仲裁）。