升级CANN

若通过Yum在线安装的CANN软件，升级步骤是通过在指令中指定目标版本号，示例：

sudo yum install -y Ascend-cann-toolkit-9.1.0-linux

若通过Apt-get在线安装的CANN软件，升级步骤是通过在指令中指定目标版本号，示例：

sudo apt-get install -y ascend-cann-toolkit=9.1.0

若通过Conda在线安装的CANN软件，请参考软件包列表，执行对应指令安装。

通过xxx.run格式的软件包离线安装CANN软件后，可参考以下步骤进行升级。需注意，合一包（Ascend-cann_<version>_linux-<arch>.run）不支持通过”--upgrade”参数升级，可以通过卸载后再安装的方式完成升级。

CANN软件兼容性

CANN软件中，Toolkit和ops包支持独立升级（需确保Tookit和ops安装在同一版本目录下），当前主版本（标记为N）与相邻的前后一年的版本兼容，版本兼容区间为[N-1，N，N+1]，最低支持的版本为CANN 8.5.0，例如：9.1.0版本的Toolkit兼容8.5.0版本的ops。
单独升级CANN部分组件（如ops包）时，CANN软件安装目录cann-<version>的版本号保持不变，仅升级组件相关的文件，已安装9.0.0版本的Toolkit和ops后，单独将ops包升级至9.1.0版本，则安装目录仍为cann-9.0.0。

前提条件

升级前，请执行以下示例命令查看当前已安装软件的版本号，确认是否执行升级步骤：
```
bash ${HOME}/Ascend/cann/query_pkg_version.sh
```
升级Toolkit前请确保已满足以下磁盘空间要求：待安装目录可用空间大于已安装软件包所占用空间+10GB，如不满足需清理空间。
示例命令如下：执行df -h <安装目录>查询安装目录的可用空间，执行du -sh <安装目录>查询已安装的软件包占用空间：
1 2
df -h ${HOME}/Ascend/cann du -sh ${HOME}/Ascend/cann

CANN软件包升级

以安装用户登录安装环境，并进入软件包所在路径。
执行如下命令，增加软件包的可执行权限（其中xxx.run请根据实际软件包全名替换）。
1
chmod +x xxx.run
软件包升级。
1
./xxx.run --upgrade
升级完成后，显示如下信息，则说明软件升级成功：
1
xxx upgrade success
xxx表示升级成功的实际软件包名。

CANN子包独立升级

CANN开源开放后，提供了组合包（Toolkit、ops、nnal）和开源子包（hccl、hixl、ops-math等），其中部分子包支持独立升级，用户可以按需升级子包，子包升级时需满足版本配套关系，支持独立升级的子包和版本配套关系详见《版本说明》的“CANN ops子包内可独立升级子包配套关系”。

例如，当前环境已安装9.0.0版本的Toolkit和ops，若需要单独升级单边通信库能力，可以通过独立升级9.1.0版本的cann-hixl来实现。示例命令如下：

bash ./cann-hixl_9.1.0_linux-aarch64.run --upgrade --install-path=/home/custom_path

cann-hixl_9.1.0_linux-aarch64.run为示例子包，执行时请替换为实际子包。
/home/custom_path为示例安装路径，执行时请替换为实际安装路径。需注意，子包升级时，升级路径应与原CANN软件的路径保持一致。

父主题： 升级