---
title: 安装、回退和卸载CANN冷补丁包
description: "CANN软件包支持冷补丁升级，即支持独立升级单个或多个库文件的功能。因此发布CANN冷补丁包。"
url: https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/latest/softwareinst/instg/instg_0056.html
sourcePath: /source/zh/CANNCommunityEdition/920beta1/softwareinst/instg/instg_0056.html
indexId: 26a4a62d3e73bdbbe13d414f713fee3b2f90b439434f364308e73032ee4d991575
---
# 安装、回退和卸载CANN冷补丁包

CANN软件包支持冷补丁升级，即支持独立升级单个或多个库文件的功能。因此发布CANN冷补丁包。

#### 约束

- 冷补丁仅能支持对应的基线版本或相关的冷补丁版本进行升级。
- 基于同一基线版本的冷补丁，需保证后续安装的冷补丁版本大于之前安装的冷补丁版本。
- 仅支持回退一个冷补丁版本。
- 冷补丁包提供run和rpm格式的软件包。


#### 安装、回退影响

- 安装、回退过程禁止进行其他维护操作动作。
- 冷补丁包安装、回退过程中会导致业务中断。
- 冷补丁包安装、回退后，不会影响正常业务。


#### CANN冷补丁包相关操作（run格式）

CANN冷补丁包支持安装、回退等操作，用户根据实际需要选择相应参数。参数说明请参见表1。

以安装冷补丁为例，命令参考如下（请注意将命令中的xxx.run替换为实际包名）：

```
./
xxx
.run --install
```


**表1 补丁包支持参数说明**

| 参数 | 说明 |
| --- | --- |
| \-\-help \| \-h | 查询帮助信息。 |
| \-\-version | 查询软件包版本。 |
| \-\-info | 查询软件包构建信息。 |
| \-\-list | 查询软件包文件列表。 |
| \-\-check | 检查软件包的一致性和完整性。 |
| \-\-quiet | 静默安装，跳过交互式信息。 |
| \-\-nox11 | 不使用x11模式运行。 |
| \-\-noexec | 不执行安装脚本。配套\-\-extract=<path>使用，格式为：\-\-noexec \-\-extract=<path>。 |
| \-\-extract=<path> | 解压软件包中文件到指定目录。使用该参数时，用户无需手动建立指定的目录，解压过程中会自动创建，例如：\-\-noexec \-\-extract=./package.run，则命令执行后会自动将解压后的内容放在package目录。 |
| \-\-tar arg1 [arg2 ...] | 对软件包执行tar命令，使用tar后面的参数作为命令的参数。例如执行\-\-tar xvf命令，解压run安装包的内容到当前目录。 |
| \-\-install | 安装冷补丁包。 |
| \-\-rollback | 回退到前一版本。 |
| \-\-uninstall | 清除原版本冷补丁的备份库文件，不支持回退。 |
| \-\-install\-path=<path> | 指定冷补丁包安装路径。 若通过该参数指定了安装路径，运行用户需要对指定的安装路径有可读写权限。 若不指定： 优先读取全局配置文件“ascend\_cann\_install.info”中的安装路径。 可在如下目录查看是否存在该文件： root用户：/etc/Ascend 非root用户：${HOME}/Ascend 如果当前环境不存在“ascend\_cann\_install.info”，则将安装到默认路径下： 若使用root用户安装，默认安装路径为：/usr/local/Ascend 若使用非root用户安装，默认安装路径为：${HOME}/Ascend |


#### CANN冷补丁包安装（rpm格式）

rpm格式只能在root权限下操作，非root用户操作rpm需用到提权命令，例如sudo -E rpm -Uvh *.rpm，请用户自行获取所需的sudo权限。使用完成后请取消涉及高危命令的权限，否则有sudo提权风险。


CANN冷补丁包安装命令示例如下（其中xxx.rpm请根据实际软件包全名替换）：
```
rpm -Uvh xxx.rpm
```