# 版本升级和回退
本节介绍对整体HCE版本的升级及回退操作。
版本升级或回退时，会同时将RPM包更新到目标系统对应的RPM包版本，和osmt.conf配置文件中的黑白名单rpm列表无关。
#### 版本升级
1. 确认repo源配置正常。 请检查默认的/etc/yum.repos.d/hce.repo配置文件中参数是否正确，正确的配置如下。
   ```
   [base]
   name=HCE $releasever base
   baseurl=https://repo.huaweicloud.com/hce/$releasever/os/$basearch/
   enabled=1
   gpgcheck=1
   gpgkey=https://repo.huaweicloud.com/hce/$releasever/os/RPM-GPG-KEY-HCE-2
   [updates]
   name=HCE $releasever updates
   baseurl=https://repo.huaweicloud.com/hce/$releasever/updates/$basearch/
   enabled=1
   gpgcheck=1
   gpgkey=https://repo.huaweicloud.com/hce/$releasever/updates/RPM-GPG-KEY-HCE-2
    
   [debuginfo]
   name=HCE $releasever debuginfo
   baseurl=https://repo.huaweicloud.com/hce/$releasever/debuginfo/$basearch/
   enabled=0
   gpgcheck=1
   gpgkey=https://repo.huaweicloud.com/hce/$releasever/debuginfo/RPM-GPG-KEY-HCE-2
   ```
   ![](https://support.huaweicloud.com/usermanual-hce/public_sys-resources/note_3.0-zh-cn.png)
   - 错误的配置内容可能会导致OSMT升级失败或非预期的升级行为。
   
   - HCE 3.0中，RPM-GPG-KEY-HCE-2换成RPM-GPG-KEY-HCE-3。
   
   - 使用时需要将$releasever和$basearch替换成环境实际配置，$releasever为OS版本号，可替换为2.0，$basearch为节点架构，可替换为aarch64或x86_64。
     
2. 更新OSMT软件版本。 OSMT软件版本和HCE版本存在配套关系。HCE默认安装当前系统的OSMT工具，系统升级时，需要将OSMT更新至目标系统版本对应的OSMT版本。
   执行**dnf update osmt -y --releasever** \[*系统目标版本号* \] 更新OSMT软件版本。
   ![](https://support.huaweicloud.com/usermanual-hce/public_sys-resources/note_3.0-zh-cn.png)
   - 若误将OSMT删除，执行**dnf install osmt -y --releasever** \[*系统目标版本号* \] 进行安装。例如，将当前系统为HCE 2.0，则执行**dnf install osmt -y** **--releasever 2.0**命令安装OSMT2.0版本。
   
   - 如果是将OSMT从2.0升级到3.0，需要先修改repo源配置，将/etc/yum.repos.d/hce.repo文件中的gpgkey配置中的RPM-GPG-KEY-HCE-2换成RPM-GPG-KEY-HCE-3。
     
3. 升级HCE系统版本。 **osmt update --releasever** \[*系统目标版本号* \]**--reboot_config** \[*重启配置*\]
   请根据是否需要立刻重启，选择合适的升级方式。更多的升级选项，详见[osmt update -h](https://support.huaweicloud.com/usermanual-hce/hce_02_0031.html#hce_02_0031__li284mcpsimp)。
   - 将HCE 2.0升级到目标版本，如HCE 3.0。 **osmt update --releasever 2.0**
     升级后，须执行**reboot**命令重启系统，目标系统版本才能生效。
     
   
   - 将HCE 2.0升级到目标版本，如HCE 3.0，并立刻重启。 **osmt update --releasever 2.0 --reboot_config always**
     
   
   - 将HCE 2.0升级到目标版本，如HCE 3.0，并指定重启时间，如"2022-12-30 23:00:00"。 **osmt update --releasever 2.0 --reboot_config** **"2022-12-30 23:00:00"**
     
     
4. 重启完成后，检查是否升级成功。 执行**cat /etc/hce-latest** 查看**hceversion** 字段，若此字段中版本部分是**--releasever**指定的版本号，表示升级成功。
   
5. （可选）删除升级备份文件。 确认升级后功能正常后，执行**osmt remove**删除备份文件。
   ![](https://support.huaweicloud.com/usermanual-hce/public_sys-resources/note_3.0-zh-cn.png)
   请确认升级无异常后再执行**osmt remove** 。执行**osmt remove**将删除所有升级备份数据，执行后无法再执行回退。
   
 
#### 版本回退
1. 请根据是否需要立刻重启，选择合适的回退方式。
   - 回退至原系统，不立刻重启。 **osmt rollback**
     
   
   - 回退至原系统并立刻重启。使用此方式，请忽略步骤[2]。
     **osmt rollback --reboot_config always**
     
    
2. 执行**reboot** 命令重启系统。
   必须重启系统才能回退到HCE的原系统版本。
   
3. 检查是否回退成功。 可执行**cat /etc/hce-latest** 查看**hceversion**字段，若此字段中版本部分是升级前的版本号，表示已回退成功。