--- title: 安装CANN description: "- 单击 获取链接(https://www.hiascend.com/developer/download/commercial/result?module=cann)" url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/softwareinst/instg/instg_0054.html sourcePath: /source/zh/canncommercial/900/softwareinst/instg/instg_0054.html indexId: 74e0194f7cb16e391577856e5c2a00cf910c2a84b7684011c725efbbfc1a726e64 --- # 安装CANN #### 前提条件 - 单击 获取链接(https://www.hiascend.com/developer/download/commercial/result?module=cann) ，在左侧配套资源的“编辑资源选择”中进行配置，筛选配套的软件包，获取开发套件包Ascend-cann-toolkit__linux-.run和算子包Ascend-cann--ops__linux-.run，以安装用户登录安装环境，将软件包上传到安装环境任意路径（如“/home/package”）。 - 安装开发套件包前请确保安装目录可用空间大于10G，如不满足请清理空间或更换安装目录。 #### 安装依赖 可使用root或非root用户（非root用户需与CANN软件包安装用户保持一致）安装。如果使用非root用户安装，需要用到提权命令，请用户自行获取所需的sudo权限，使用完成后请取消涉及高危命令的权限，否则有sudo提权风险。 请参考以下操作进行安装，以下命令会安装最新版本或指定版本的依赖，关于Python第三方库、glibc版本要求请参见运行依赖列表。 1. 执行命令安装所需依赖 Debian、Ubuntu、veLinux： 1 sudo apt-get install -y gcc g++ python3 python3-pip openEuler、CentOS、Kylin、BCLinux、UOS V20、AntOS、AliOS、CTyunOS、CULinux、Tlinux、MTOS、vesselOS： 1 sudo yum install -y gcc gcc-c++ python3 python3-pip CANN支持Python3.7.x至3.13.x版本，若安装失败、版本不满足或者未包含动态库libpython3.x.so请参见编译安装Python操作。 2. 安装Python第三方库（如果使用root用户安装，请将命令中的--user删除）。 1 pip3 install attrs cython numpy decorator sympy cffi pyyaml pathlib2 psutil protobuf==3.20.0 scipy requests absl-py --user 以上命令会安装最新版本或指定版本的依赖，关于Python第三方库（numpy、scipy等）需与Python版本配套使用，具体版本要求请参见运行依赖列表。 若安装过程中提示pip源不可用，请参见配置pip源，完成后再执行安装命令。 #### 安装Toolkit 安装Toolkit软件前请确保安装目录可用空间大于10G，如不满足请清理空间或更换安装目录。 1. 以软件包的安装用户登录安装环境。将获取到的Toolkit上传到安装环境任意路径（如“/home/package”）。 2. 安装软件包（安装命令支持--install-path=等参数，具体使用方式请参见参数说明）。 1 bash ./Ascend-cann-toolkit_9.0.0_linux-aarch64.run --install 如果用户未指定安装路径，则软件会安装到默认路径下，默认安装路径如下。root用户：“/usr/local/Ascend”，非root用户：“${HOME}/Ascend”，${HOME}为当前用户目录。 3. 配置环境变量，当前以非root用户安装后的默认路径为例，请用户根据set_env.sh的实际路径执行如下命令。 ``` # 安装Toolkit包时配置 source ${HOME} /Ascend/cann/set_env.sh # 其中 请替换为实际架构 export LD_LIBRARY_PATH= ${HOME} /Ascend/cann/ -linux/devlib/:$LD_LIBRARY_PATH ``` 上述环境变量配置只在当前窗口生效，用户可以按需将以上命令写入环境变量配置文件（如.bashrc文件）。 4. 安装后检查。执行如下命令查询CANN版本信息，查询结果与安装软件包的版本一致时，则验证安装成功。 a. 进入软件包安装信息文件目录。 ``` cd ${HOME} /Ascend/cann/ -linux ``` 其中${HOME}/Ascend为非root用户默认安装路径，请用户根据实际安装路径替换。表示CPU架构（aarch64或x86_64）。 b. 执行命令，查看version字段提供的版本信息。 ``` cat ascend_toolkit_install.info ``` #### 安装ops CANN算子包集成一系列库文件，包括算子基础框架，算子库（包含math、nn、cv和transformer）、TBE算子、HCCL集合通信库、HIXL单边通信库和 DVPP库，具体文件包括单算子API执行（如aclnn类API）动态库/静态库文件、算子源码以及kernel二进制文件，优化高性能计算场景下的整体运行能力。 **表1 安装ops算子包** | 产品类型 | 架构 | 安装命令 | | | | --- | --- | --- | --- | --- | | Atlas 350 加速卡 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas 350 加速卡 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-950\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas A3 系列产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas A3 系列产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-A3\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas A2 系列产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas A2 系列产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas 训练系列产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas 训练系列产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-910\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas 推理系列产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas 推理系列产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310p\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | | | Atlas 200I/500 A2 推理产品 | aarch | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | Atlas 200I/500 A2 推理产品 | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-aarch64.run \-\-install | | | | x86\_64 | 1 2 wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | 1 2 | wget https://ascend\-repo.obs.cn\-east\-2.myhuaweicloud.com/CANN/CANN%209.0.0/Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run bash ./Ascend\-cann\-310b\-ops\_9.0.0\_linux\-x86\_64.run \-\-install | | | |