Installation Using the Repacked Driver Package

If Pigz has not been installed, use the software manager to install it. For example:

• Ubuntu

  apt install pigz

• CentOS

  yum install pigz

Build a driver package that meets the requirements of the target OS version, kernel version, and GCC version.

The .run installation packages of the Atlas 300I inference card (model 3000) are host installation packages. You need to download and decompress them on a host OS. The following describes how to install the packages on a host. For details about how to install the packages in a container, see Installation in a Container.

This section uses the A300-3000-npu-driver-repack.run package as an example to describe how to install the .run driver package. Replace the package name with the actual one.

Procedure

For initial installation, install the driver and then firmware; for overwrite installation or upgrade, install the firmware and then driver. For details about how to install the firmware, see Installing the Firmware (*.run).

To ensure that the driver version, firmware version, and MCU version match each other, upgrade the MCU. For details, see "Upgrading the MCU" in the Atlas 300I Inference Card NPU Driver and Firmware Upgrade Guide (Models 3000, 3010).

1. Upload the driver package built in Repacking the Driver Package to any directory (for example, /opt) in Linux.
2. Use PuTTY to log in to the OS CLI of the server where the Atlas 300I inference card (model 3000) is located. For details, see Logging In to the CLI Using PuTTY over a Network Port.
3. Run the following command to switch to the root user:

   su - root

4. Run the following command to go to the directory where the software package is stored, for example, /opt:

   cd /opt

5. Run the following command to check the consistency and integrity of the .run installation package:

   ./A300-3000-npu-driver-repack.run --check

   If the following information is displayed, the driver package verification is successful:

   Verifying archive integrity...  100%   SHA256 checksums are OK. All good.

   The SHA256 encryption mode is used for software package verification. If "./A300-3000-npu-driver-repack.run does not contain an embedded MD5 checksum" and "./A300-3000-npu-driver-repack.run does not contain a CRC checksum" are displayed during the verification, the MD5 and CRC encryption modes are not used and can be ignored.

6. Run the installation command.
   • If you specify an installation path, for example, /test/HiAI/,

     run the ./A300-3000-npu-driver-repack.run --full --install-path= /test/HiAI/ command to complete the installation.

   • If the installation path is not specified, run the ./A300-3000-npu-driver-repack.run --full command.
     • During the driver installation, the dynamic library libdcmi.so and header file dcmi_interface_api.h are copied to the /usr/local/dcmi/ directory.
     • For details about how to resolve problems that may occur during the installation of the .run installation package, see FAQs.
     • If the created running user is not HwHiAiUser, you need to specify a running user (specified by the --install-username=username --install-usergroup=usergroup parameter) when installing the driver package.
     • If an installation path is specified during the driver installation:
       • In the scenario where the specified path does not exist, a directory is automatically created during the installation. If there are multiple levels of directories, the directory is automatically created only when the last level of directory does not exist.
       • In the scenario where the specified path exists:
         • If the owner of all levels of directories in the path is the root user, ensure that the permission on all levels of directories is at least 755.
         • If the owner of a level-1 directory in the path is not the root user, change the owner to the root user and ensure that the permission on all levels of directories is 755.
     • Default installation path: /usr/local/Ascend

     • Installation log path: /var/log/ascend_seclog/ascend_install.log
     • Path where the installation path, installation command, and user information of the software package after installation are stored: /etc/ascend_install.info
     • If you install the driver using an NPU 20.0.X or NPU 20.1.X driver package as a non-HwHiAiUser user, uninstall it, and then reinstall it as the HwHiAiUser user, error message "/home/HwHiAiUser: Permission denied" may be reported. In this case, ignore the error.
     • If an NPU 20.2.X or later software package is used for installation, the system logs on the device are transmitted to the host using the msnpureport tool for viewing. For details about the export operation and the storage path of the exported logs, see "msnpureport Instructions" in the Ascend 310 Black Box Log Reference.

       In a container, system logs on the device cannot be viewed and cannot be exported using the msnpureport tool.

7. If the system displays a message indicating that the installation is successful, the driver is successfully installed. Determine whether to restart the system based on the displayed information. If the system needs to be restarted, perform the following operations. Otherwise, skip this step.
   1. After the installation is complete, run the reboot command on the host OS to reboot the host or power off and then power on the host.
   2. After the host is rebooted, the driver and services are automatically installed. The Ascend 310 automatically enters the OS.

8. Run the npu-smi info command to check whether the driver is successfully loaded.
   If information similar to the following is displayed, the driver is successfully loaded. Otherwise, the installation fails. Contact Huawei technical support.

   +------------------------------------------------------------------------------+
   | npu-smi 20.0.1                       Version: 1.73.5.10.050                  |
   +-------------------+-----------------+----------------------------------------+
   | NPU     Name      | Health          | Power(W)          Temp(C)              |
   | Chip    Device    | Bus-Id          | AICore(%)         Memory-Usage(MB)     |
   +===================+=================+========================================+
   | 2049    310       | OK              | 12.8              50                   |
   | 0       0         | 0000:85:00.0    | 0                 2621 / 8192          |
   +-------------------+-----------------+----------------------------------------+
   | 2049    310       | OK              | 12.8              51                   |
   | 1       1         | 0000:86:00.0    | 0                 2621 / 8192          |
   +-------------------+-----------------+----------------------------------------+
   | 2049    310       | OK              | 12.8              52                   |
   | 2       2         | 0000:87:00.0    | 0                 2621 / 8192          |
   +-------------------+-----------------+----------------------------------------+
   | 2049    310       | OK              | 12.8              55                   |
   | 3       3         | 0000:88:00.0    | 0                 2621 / 8192          |
   +===================+=================+========================================+

   In the command output, the field following npu-smi indicates the npu-smi tool version, and the field following Version: indicates the driver version.

Follow-up Procedure

If an NPU 20.2.X or later package is used for installation, skip this step. If an NPU 20.0.X or NPU 20.1.X software package is used for installation, the ADA enables the listening port 22118 by default. To ensure system security, disable this port in a commercial environment.

1. /usr/local/Ascend/driver is the default installation path for installing the driver (add-ons is installed with the driver) as the root user. The following uses this path as an example to describe the operation procedure. Replace it with the actual path.

2. When you install the OS as the root user, the HwHiAiUser user is the default process running user in the OS. The following uses the HwHiAiUser user as an example to describe the operation procedure.

1. Run the su - HwHiAiUser command to switch to the running user, log in to the OS, and open the /home/HwHiAiUser/ide_daemon/ide_daemon.cfg file.

   • If the value of SOCK_SWITCH is 0, the ADA port is disabled.

   • If the value of SOCK_SWITCH is 1, the ADA port is enabled. You need to manually change the value of SOCK_SWITCH to 0.

   Run the wq! command to save the settings and exit.

2. Switch to the /usr/local/Ascend/driver/tools directory and run the following commands in sequence to set environment variables and restart the ada process or run the reboot command to restart the OS.

   1. Set the environment variable.

      export LD_LIBRARY_PATH=/usr/local/Ascend/add-ons:$LD_LIBRARY_PATH

   2. Query the ID of the ada process.

      ps -ef | grep ada

   3. Stop the ada process.

      kill -9 ada process ID

   4. Start the ada process.

      If the message "ada is exist, don't start again" is displayed when you run the following command, the system has automatically started the ada process.

      /usr/local/Ascend/driver/tools/ada