须知

如果是批量安装，参考配置批量安装完成相关配置后，请直接从3开始执行。
如果是Atlas 300I Pro或Atlas 300V Pro，则必须在inventory_file中提前配置cus_npu_info参数，如Atlas 300I Pro配置为300i-pro，Atlas 300V Pro配置为300v-pro，参考示例如下：
```
[ascend]
localhost ansible_connection='local' cus_npu_info='300i-pro'
```

安装步骤

以软件包的安装用户登录待安装设备。
将ascend-deployer整个目录上传到待安装设备的用户家目录（如“$HOME”）下。如果是直接在待安装设备上使用ascend-deployer的下载功能，请忽略此步骤。
- 非root用户使用离线部署工具时，需具有ascend-deployer目录的操作权限。
- 如果是使用root用户安装，且需要其他用户能够使用root用户后续安装的python等，请提前设置环境umask为022，设置前请确认该umask权限符合所在组织的安全要求。
（可选）root用户安装驱动、CANN软件包时，支持指定驱动的运行用户、用户组（默认为HwHiAiUser，具体请参考准备安装及运行用户）以及CANN软件包、toolbox软件包的安装路径（默认为“/usr/local/Ascend”）。如需指定，可自行修改ascend-deployer/inventory_file文件（以下参数设置仅对root用户安装时有效）。文件内容参考如下：
如果待安装环境上已存在全局配置文件“/etc/Ascend/ascend_cann_install.info”和“/etc/Ascend/ascend_toolbox_install.info”，则以下install_path参数无效，以全局配置文件中指定的安装路径为准。
```
[ascend:vars]
user=HwHiAiUser
group=HwHiAiUser
install_path=/usr/local/Ascend
```
npu和边缘组件（atlasedge、ha）不支持自行指定安装路径，npu默认安装路径为“/usr/local/Ascend”，边缘组件（atlasedge、ha）默认安装路径为“/usr/local”。

进入ascend-deployer目录，执行安装脚本（安装用户需具有install.sh的可执行权限），可根据需要选择安装方式（指定场景安装或指定软件安装）。

如果用户是在本机上使用pip安装ascend-deployer，则可在本机任意路径使用ascend-deployer命令进行安装。与执行安装脚本命令的区别是将以下命令中的"./install.sh"替换为"ascend-deployer"，如"ascend-deployer --install-scene=auto"。

指定场景安装（仅支持root用户）

无论指定何种场景安装，都会自动安装docker，便于进行容器部署。在安装过程中会创建相应的docker组。
```
./install.sh --install-scene=<scene_name>
```
ascend-deployer工具提供几个基本安装场景，具体可参考可选安装场景。命令示例如下：
```
./install.sh --install-scene=auto       //自动安装所有能找到的软件包
```

指定软件安装

如果使用root用户，支持安装ascend-deployer工具下载的所有软件。如果使用非root用户，仅支持安装表1所示软件。请先使用root用户安装完sys_pkg（系统组件）、npu（驱动与固件，为昇腾设备时安装）等后，再使用非root用户安装表1中的软件。

表1 软件列表
软件	说明
python、gcc	python3.x.x和gcc7.3.0，安装在$HOME/.local/目录下。
框架	包括tensorflow、pytorch、mindspore。
CANN软件	包括nnae、nnrt、tfplugin、toolkit，安装在$HOME/Ascend目录下。 CANN 5.0.1版本以前的toolkit软件包不支持使用非root用户安装。
toolbox	安装在$HOME/Ascend目录下。非root用户安装toolbox会跳过工具包中容器引擎插件Ascend-docker-runtime的安装。如果需要使用Ascend-docker-runtime，请使用root用户安装toolbox。
MindStudio	安装在$HOME目录下。如果非root用户需要安装MindStudio，请先使用root用户安装MindStudio（部分依赖需要root用户安装）后，再使用非root用户安装MindStudio。

./install.sh --install=<package_name_1>,<package_name_2>

<package_name_x>可选范围可通过执行./install.sh --help查看。命令示例如下：

./install.sh --install=sys_pkg,python,npu     //安装系统组件、python、驱动和固件
./install.sh --install=toolkit    //安装toolkit
./install.sh --install=tfplugin    //安装tfplugin
./install.sh --install=tensorflow    //安装tensorflow
./install.sh --install=ief         //安装IEF Agent
./install.sh --install=mindstudio      //安装MindStudio

IEF Agent安装完成后，需要登录管理控制台-智能边缘平台，选择左侧导航栏的“边缘资源 > 边缘节点”，在边缘节点列表中查看已纳管的边缘节点状态。如果节点状态为“运行中”，表示纳管成功。

请按照“sys_pkg>python>npu>CANN软件包（toolkit、nnrt等）>AI框架（tensorflow、mindspore或pytorch）”的顺序进行安装。
安装npu时，会提前获取设备健康状态。如果设备存在问题，则会终止整个安装过程。
安装npu后，请根据安装npu过程中的系统提示信息决定是否重启系统（如需重启，请执行reboot命令）。
部分组件存在运行时依赖，如AI框架需要toolkit或nnae提供运行时依赖。
所有python库的安装都必须先安装python，如tensorflow、mindspore、pytorch等。
其中指定“--install=mindspore”会安装下载操作中下载好的mindspore包，用户也可参考Mindspore官网自行安装，请注意mindspore与驱动、固件、CANN软件的版本配套关系。

安装后检查，可通过以下命令检查指定组件能否正常工作。
```
./install.sh --test=<target>
```
<target>可选范围可通过执行./install.sh --help查看。命令示例如下：
```
./install.sh --test=toolbox        //测试toolbox是否正常
```

执行安装命令

须知

安装步骤