Upgrading the KAE Software - Kunpeng Acceleration Engine. Developer Guide. Issue 13 Date HUAWEI

3.3.1 Upgrading the KAE Software Using RPM Packages

NO TE

If the KAE installed using the source code does not involve upgrade operations, skip this section.

Scenarios

Run the rpm -Uvh command to upgrade the KAE software.

Procedure

Step 1 Download the latest KAE software package.

Step 2 Use SSH to log in to the Linux CLI as the root user.

Step 3 In the directory where the software package is stored, upgrade the accelerator driver package and engine library package.

rpm -Uvh *.rpm

The following command output is displayed:

Preparing... ################################# [100%]

checking installed modules uacce modules start to install Updating / installing...

1:uacce-1.2.1-1.centos7.6 ################################# [ 7%]

uacce modules installed

2:libwd-1.2.1-1.centos7.6 ################################# [ 14%]

3:libkae-1.2.1-1.centos7.6 ################################# [ 21%]

checking installed modules hisi_hpre modules start to install

4:hisi_hpre-1.2.1-1.centos7.6 ################################# [ 29%]

hisi_hpre modules installed checking installed modules hisi_rde modules start to install

5:hisi_rde-1.2.1-1.centos7.6 ################################# [ 36%]

hisi_rde modules installed checking installed modules hisi_sec2 modules start to install

6:hisi_sec2-1.2.1-1.centos7.6 ################################# [ 43%]

hisi_sec2 modules installed checking installed modules hisi_zip modules start to install

7:hisi_zip-1.2.1-1.centos7.6 ################################# [ 50%]

hisi_zip modules installed Cleaning up / removing...

8:libkae-1.2.0-1.centos7.6 ################################# [ 57%]

Step 4 Restart the system or manually uninstall the driver of the old version using the CLI, and then load the driver of the new version. Check whether the driver is successfully loaded.

1. Uninstall the old driver.

a. Query the drivers that have been loaded to the kernel.

lsmod | grep uacce

The following command output is displayed:

uacce 262144 5 hisi_zip,hisi_rde,hisi_hpre,hisi_sec2,hisi_qm

b. Uninstall the drivers of the old version in sequence.

rmmod hisi_hpre

c. Run the following command again. If no result is displayed, the old version is uninstalled successfully.

lsmod | grep uacce

2. Load the new drivers.

a. Load the uacce driver.

modprobe uacce

b. Load the hisi_sec2 driver to the kernel based on the configuration file in /etc/modprobe.d/hisi_sec2.conf.

modprobe hisi_sec2

c. Load the hisi_hpre driver to the kernel based on the configuration file in /etc/modprobe.d/hisi_hpre.conf.

modprobe hisi_hpre

d. Load the hisi_rde driver to the kernel based on the configuration file in /etc/modprobe.d/hisi_rde.conf.

modprobe hisi_rde

e. Load the hisi_zip driver to the kernel based on the configuration file in /etc/modprobe.d/hisi_zip.conf.

modprobe hisi_zip

f. Query the loaded drivers.

lsmod | grep uacce

If the following information is displayed, the loading is successful.

uacce 36864 3 hisi_sec2,hisi_qm,hisi_hpre,hisi_rde,hisi_zip

Step 5 Run the rpm -qa | grep command to check the software version after the upgrade.

rpm -qa uacce hisi_sec2 hisi_hpre hisi_zip hisi_rde

If the version number after the upgrade is displayed, the upgrade is successful.

hisi_rde-1.2.1-1.centos7.6.aarch64 hisi_sec2-1.2.1-1.centos7.6.aarch64 uacce-1.2.1-1.centos7.6.aarch64 hisi_hpre-1.2.1-1.centos7.6.aarch64 hisi_zip-1.2.1-1.centos7.6.aarch64

----End

3.3.2 Upgrading the KAE Software Using DEB Packages

Scenarios

Use DEB packages to upgrade the KAE software.

Procedure

Step 1 Download the latest KAE software package.

Step 2 Use SSH to log in to the Linux CLI as the root user.

Step 3 Uninstall the KAE software package.

NO TE

Due to the dependency relationships, the hisi_hpre, hisi_sec2, hisi_rde, and hisi_zip driver packages must be uninstalled before the uacce driver package is uninstalled. The libkae engine package must be uninstalled before the libwd driver package is uninstalled.

dpkg -r hisi-sec2

Step 4 In the directory where the software package is stored, reinstall the accelerator driver package and engine library package.

dpkg -i *.deb

Step 5 Restart the system or manually uninstall the driver of the old version using the CLI, and then load the driver of the new version. Check whether the driver is successfully loaded.

1. Uninstall the old driver.

a. Query the drivers that have been loaded to the kernel.

lsmod | grep uacce

The following command output is displayed:

uacce 262144 5 hisi_zip,hisi_rde,hisi_hpre,hisi_sec2,hisi_qm

b. Uninstall the drivers of the old version in sequence.

rmmod hisi_hpre rmmod hisi_sec2 rmmod hisi_rde rmmod hisi_zip

rmmod hisi_qm rmmod uacce

c. Run the following command again. If no result is displayed, the old version is uninstalled successfully.

lsmod | grep uacce

2. Load the new drivers.

a. Load the uacce driver.

modprobe uacce

b. Load the hisi_sec2 driver to the kernel based on the configuration file in /etc/modprobe.d/hisi_sec2.conf.

modprobe hisi_sec2

c. Load the hisi_hpre driver to the kernel based on the configuration file in /etc/modprobe.d/hisi_hpre.conf.

modprobe hisi_hpre

d. Load the hisi_rde driver to the kernel based on the configuration file in /etc/modprobe.d/hisi_rde.conf.

modprobe hisi_rde

e. Load the hisi_zip driver to the kernel based on the configuration file in /etc/modprobe.d/hisi_zip.conf.

modprobe hisi_zip

f. Query the loaded drivers.

lsmod | grep uacce

If the following information is displayed, the loading is successful.

uacce 36864 3 hisi_sec2,hisi_qm,hisi_hpre,hisi_rde,hisi_zip

Step 6 Run the dpkg -s command to check the software version after the upgrade.

dpkg -s uacce hisi-sec2 hisi-hpre hisi-zip hisi-rde

If the version number after the upgrade is displayed, the upgrade is successful.

Package: uacce

Status: install ok installed Priority: optional Section: utils Installed-Size: 512

Maintainer: HiSilicon Tech. Co., Ltd.