快速上线

准备安装环境

• 安装依赖前确保服务器能够连接外网，已配置可用的软件源和pip源。如果需要更换软件源可参考检查源，配置pip源可参考配置pip源。
• 安装驱动前需要创建驱动运行用户HwHiAiUser（运行驱动进程的用户），安装驱动时无需指定运行用户，默认即为HwHiAiUser。

  groupadd HwHiAiUser
  useradd -g HwHiAiUser -d /home/HwHiAiUser -m HwHiAiUser -s /bin/bash

下载软件

下载本软件即表示您同意华为企业业务最终用户许可协议（EULA）的条款和条件。

若用户需要查询昇腾软件版本配套关系，可单击链接进行查询。

上传安装包并添加权限

1. 将MCU的zip包解压至本地文件夹，获取Ascend-hdk-310p-mcu_23.2.4.hpm安装包。
2. 再将下载的run包和解压获取的hpm包上传至服务器任意目录（以“/home”为例）。
3. 给安装包添加权限。

   cd /home
   chmod +x Ascend-hdk-310p-npu-driver_24.1.rc1_linux-aarch64.run
   chmod +x Ascend-hdk-310p-npu-firmware_7.1.0.6.220.run
   chmod +x Ascend-cann-toolkit_8.0.RC1_linux-aarch64.run
   chmod +x Ascend-cann-kernels-310p_8.0.RC1_linux.run  

安装NPU驱动固件

如果环境OS为Linx 6.0.90/Linx 6.0.100操作系统，需要检查“/etc/pam.d/su”配置文件的“auth sufficient pam_rootok.so”字段是否被注释掉，若被注释，将“auth sufficient pam_rootok.so”前面"#"号删除，保存退出。

执行uname -r命令查看操作系统内核版本：

• 如果内核版本在“二进制安装”安装方式对应的版本范围内，则可以直接安装NPU驱动固件。
• 如果内核版本为“源码编译安装”安装方式对应的版本则需要先参见安装驱动源码编译所需依赖安装驱动源码编译所需的依赖，再安装NPU驱动固件。

# 若操作系统为Ubuntu，安装驱动前还需安装如下依赖
apt-get install -y net-tools pciutils
# 安装NPU驱动 
./Ascend-hdk-310p-npu-driver_24.1.rc1_linux-aarch64.run --full --install-for-all
# 查看驱动加载是否成功，回显芯片信息表示加载成功
npu-smi info
# 安装NPU固件
./Ascend-hdk-310p-npu-firmware_7.1.0.6.220.run --full
# 重启OS
reboot

升级MCU

# 查询NPU ID （卡的设备编号）
npu-smi info -l
# 升级MCU
npu-smi upgrade -t mcu -i NPU ID -f Ascend-hdk-310p-mcu_23.2.4.hpm
# 使新版本生效
npu-smi upgrade -a mcu -i NPU ID
# 在生效新版本之后，等待30s，查询MCU版本号，确保升级成功
npu-smi upgrade -b mcu -i NPU ID

物理机安装

1. 安装依赖。
   安装依赖以Ubuntu 20.04为例，其他操作系统安装依赖方法请参见安装依赖。

   # 安装OS依赖
   apt-get install -y gcc g++ make cmake zlib1g zlib1g-dev openssl libsqlite3-dev libssl-dev libffi-dev unzip pciutils net-tools libblas-dev gfortran libblas3 libopenblas-dev
   
   # 安装Python3依赖
   apt-get install -y python3-pip
   pip3 install --upgrade pip
   pip3 install attrs cython numpy decorator sympy cffi pyyaml pathlib2 psutil protobuf scipy requests absl-py

2. 安装CANN。

   # 在/home目录下执行如下命令安装Toolkit
   ./Ascend-cann-toolkit_8.0.RC1_linux-aarch64.run --install --install-for-all --quiet
   
   # 执行如下命令配置环境变量。若需要设置环境变量永久生效，可在~/.bashrc文件最后一行后面添加以下命令，执行source ~/.bashrc命令
   source /usr/local/Ascend/ascend-toolkit/set_env.sh
   
   # 二进制算子包依赖CANN软件包Toolkit，执行安装时，当前环境需已安装配套版本的Toolkit，并使用同一用户安装
   ./Ascend-cann-kernels-310p_8.0.RC1_linux.run --install --install-for-all --quiet

3. （可选）运行样例。

   软件安装完成后，可以运行样例验证环境是否可用。

   获取模型文件和权重文件：

   • ResNet-50网络的模型文件（*.prototxt）：单击Link下载该文件。
   • ResNet-50网络的权重文件（*.caffemodel）：单击Link下载该文件。

   # 在服务器任意目录下获取sample仓代码（以/home目录为例）
   apt-get install git
   git config --global http.sslVerify "false"
   git clone https://gitee.com/ascend/samples.git
   
   # 进入“样例目录”，下文中的“样例目录”均指“samples/cplusplus/level2_simple_inference/1_classification/resnet50_imagenet_classification”目录
   cd samples/cplusplus/level2_simple_inference/1_classification/resnet50_imagenet_classification
   
   # 获取ResNet-50原始模型
   pip3 install Pillow
   mkdir -p caffe_model
   
   # 将获取的模型文件和权重文件上传至创建的“caffe_model”目录
   
   # 在“样例目录”下执行如下命令，将ResNet-50原始模型转换为适配昇腾AI处理器的离线模型（*.om文件）
   atc --model=caffe_model/resnet50.prototxt --weight=caffe_model/resnet50.caffemodel --framework=0 --output=model/resnet50 --soc_version=Ascend310P3 --input_format=NCHW --input_fp16_nodes=data --output_type=FP32 --out_nodes=prob:0
   
   # 在“样例目录/data”目录下准备样例图片，如果data目录不存在，可在“样例目录”下执行mkdir -p data命令创建。
   cd data
   wget https://obs-9be7.obs.cn-east-2.myhuaweicloud.com/models/aclsample/dog1_1024_683.jpg --no-check-certificate
   wget https://obs-9be7.obs.cn-east-2.myhuaweicloud.com/models/aclsample/dog2_1024_683.jpg --no-check-certificate
   python3 ../script/transferPic.py
   
   # 编译运行
   # 在“样例目录”下执行如下命令配置环境变量
   export DDK_PATH=/usr/local/Ascend/ascend-toolkit/latest
   export NPU_HOST_LIB=$DDK_PATH/runtime/lib64/stub
   
   # 在“样例目录”下执行如下命令编译可执行文件。
   mkdir -p build/intermediates/host
   cd build/intermediates/host
   cmake ../../../src -DCMAKE_CXX_COMPILER=g++ -DCMAKE_SKIP_RPATH=TRUE
   make
   
   # 在“样例目录/out”目录下，执行如下命令运行编译的文件
   ./main

容器安装

• 从AscendHub拉取容器镜像，请确保安装环境能够连接网络。
• 请确保宿主机已安装Docker（可执行docker version查询）。若未安装，请参见部署Docker安装。

1. 单击推理容器镜像链接，进入昇腾镜像仓库。
2. 获取镜像。
   1. 登录AscendHub。如图1所示。
      图1 登录AscendHub
      
   2. 选择“镜像版本”页签，下载对应版本的容器镜像，单击“立即下载”。如图2所示。
      图2 下载容器镜像
      
   3. 弹出“镜像下载须知”弹窗，阅读并同意后，单击“立即下载”。如图3所示。
      图3 镜像下载须知
      
   4. 根据弹出的下载页面提示，复制获取权限命令，在宿主机上执行命令。
      图4 镜像下载
      
   5. 复制下载镜像命令，然后在宿主机执行命令拉取镜像。
      如果在下载镜像时，配置登录AscendHub权限回显类似以下报错，可按照以下方法解决。

      Error response from daemon: Get https://ascendhub.huawei.com/v2/: x509: certificate signed by unknown authority

      执行vi /etc/docker/daemon.json命令，在文件“insecure-registries”参数中加入AscendHub网址，如下加粗内容所示。

      {
              "registry-mirrors": ["http://docker.mirrors.ustc.edu.cn"],
              "insecure-registries": ["docker.mirrors.ustc.edu.cn", "ascendhub-registry.rnd.huawei.com", "registry.docker-cn.com", "ustc-edu-cn.mirror.aliyuncs.com","ascendhub.huawei.com"],
              "experimental" : true
      }

      添加内容后，执行以下命令重启Docker。

      systemctl daemon-reload 
      systemctl restart docker

3. 选择“镜像概述”页签，根据概述中的操作步骤启动容器。