#离线升级回退

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

Warn：

仅升级失败才允许回退。

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

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

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

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

# 步骤1：回退数据库

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

$ ./bin/yasboot cluster rollback -c yashandb
 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间升级失败时，需执行此步骤。

执行如下命令，回退yasom与yasagent。

$ ./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文件