通过DEB包安装KAE

前提条件

• 请先下载指定操作系统相对应的DEB包，下载路径为：https://gitee.com/kunpengcompute/KAE/releases。
• dpkg工具能正常使用。

安装步骤

hisi_zip驱动软件包依赖于uacce软件包，libkaezip引擎软件包依赖libwd软件包。

如果仅加速zlib库的压缩算法建议只需要安装uacce、hisi_zip、libwd、libkaezip软件包。

各软件包提供算法功能请参见安装简介。

1. 使用SSH远程登录工具，以root账号进入Linux操作系统命令行界面。
2. 将KAE DEB软件包拷贝到自定义路径下。
3. 安装加速驱动软件包。
   • 方式一：通过dpkg -i *.deb安装所有KAE DEB软件包。

     1	dpkg -i *.deb

   • 方式二：如果需要单独安装软件包，请参考以下安装uacce-1.3.1软件包示例进行安装。

     1 2	dpkg -i uacce-1.3.1-1.ubuntu18.04.arm64.deb uacce modules installed

     依次安装hisi_zip驱动软件包和libwd，libkaezip引擎软件包。安装libkaezip引擎软件包时需要先安装libwd软件包。

4. 查看DEB软件是否已正常安装到系统内。
   1. 查看uacce是否已安装。

      1	dpkg -L uacce

      回显结果如下。

      1 2 3 4 5 6 7

      /. /lib /lib/modules /lib/modules/4.15.0-70-generic /lib/modules/4.15.0-70-generic/extra /lib/modules/4.15.0-70-generic/extra/uacce.ko /lib/modules/4.15.0-70-generic/extra/hisi_qm.ko

   2. 查看hisi-zip是否已安装。

      1	dpkg -L hisi-zip

      回显结果如下。

      1 2 3 4 5 6 7 8 9

      /. /lib /lib/modules /lib/modules/4.15.0-70-generic /lib/modules/4.15.0-70-generic/extra /lib/modules/4.15.0-70-generic/extra/hisi_zip.ko /etc /etc/modprobe.d /etc/modprobe.d/hisi_zip.conf

   3. 查看安装目录下是否生成对应模块。

      1	ls -al /lib/modules/`uname -r`/extra

      回显结果如下。

      1 2 3 4 5

      total 348 drwxr-xr-x 2 root root 4096 Apr 15 17:12 . drwxr-xr-x 6 root root 4096 Apr 15 17:12 .. -rw-r--r-- 1 root root 42600 Apr 15 09:15 hisi_zip.ko -rw-r--r-- 1 root root 40408 Apr 15 09:15 uacce.ko

   4. 在“/etc/modprobe.d/”目录下查看是否生成对应的配置文件。

      1	ls -al /etc/modprobe.d/

      回显结果如下。

      1 2 3 4 5 6 7 8 9 10 11

      total 52 drwxr-xr-x 2 root root 4096 Apr 15 17:12 . drwxr-xr-x 94 root root 4096 Apr 15 09:15 .. -rw-r--r-- 1 root root 325 Jan 28 2018 blacklist-ath_pci.conf -rw-r--r-- 1 root root 1667 Nov 13 2018 blacklist.conf -rw-r--r-- 1 root root 210 Jan 28 2018 blacklist-firewire.conf -rw-r--r-- 1 root root 697 Jan 28 2018 blacklist-framebuffer.conf -rw-r--r-- 1 root root 583 Jan 28 2018 blacklist-rare-network.conf -rw-r--r-- 1 root root 44 Apr 15 09:15 hisi_zip.conf -rw-r--r-- 1 root root 347 Jan 28 2018 iwlwifi.conf -rw-r--r-- 1 root root 379 Jul 2 2018 mdadm.conf

5. 加载加速器驱动到内核。
   • 方式一：重启系统加载。
   • 方式二：通过命令行手动依次加载，并查看是否加载成功。
     1. 查询已载入内核的驱动模块。

        1	lsmod | grep uacce

        若没有任何回显内容则执行5.b~5.c将相应的模块加载到内核。

     2. 加载uacce驱动。

        1	modprobe uacce

     3. 加载hisi_zip驱动，将根据“/etc/modprobe.d/hisi_zip.conf”下的配置文件加载到内核。

        1	modprobe hisi_zip

     4. 再次查询已载入内核的驱动模块。

        1 2	lsmod | grep uacce lsmod | grep hisi_qm

        两次查询分别显示如下信息则表示加载成功。

        1	uacce 28672 1 hisi_qm

        1 2	hisi_qm 65536 4 hisi_zip uacce 28672 1 hisi_qm

安装后检查

1. 查看KAE DEB软件包。

   1	dpkg -s uacce hisi-zip

   查询结果如下显示。

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

   Package: uacce Status: install ok installed Priority: optional Section: utils Installed-Size: 512 Maintainer: HiSilicon Tech. Co., Ltd. Architecture: arm64 Version: 1.3.1 Description: This package contains the Unified/User-space-access-intended Accelerator Framework. URL: https://support.huawei.com Package: hisi-zip Status: install ok installed Priority: optional Section: utils Installed-Size: 512 Maintainer: HiSilicon Tech. Co., Ltd. Architecture: arm64 Version: 1.3.1 Description: This package contains the Huawei Hisilicon ZIP Accelerator Driver. URL: https://support.huawei.com

2. 查看“/sys/”目录下对应的加速器设备。

   1	ls -al /sys/class/uacce/

   查询结果如下显示。

   1 2 3 4 5

   total 0 drwxr-xr-x 2 root root 0 Apr 15 17:42 . drwxr-xr-x 65 root root 0 Apr 15 16:49 .. lrwxrwxrwx 1 root root 0 Apr 15 17:42 hisi_zip-6 -> ../../devices/pci0000:74/0000:74:00.0/0000:75:00.0/uacce/hisi_zip-6 lrwxrwxrwx 1 root root 0 Apr 15 17:42 hisi_zip-7 -> ../../devices/pci0000:b4/0000:b4:00.0/0000:b5:00.0/uacce/hisi_zip-7

3. 查看zlib库加速引擎是否生效。
   通过ldd命令查看zlib加速库是否链接到libwd和libkaezip。

   1	ldd /usr/local/kaezip/lib/libz.so.1.2.11

   如果显示如下返回信息，说明zlib加速库安装成功。同样的，用户目标进程也可以通过ldd命令查看是否使用libwd和libkaezip。

   1 2 3 4 5

   linux-vdso.so.1 => (0x0000ffff80280000) libc.so.6 => /lib64/libc.so.6 (0x0000ffff80080000) libwd.so.1 => /lib64/libwd.so.1 (0x0000ffff80040000) /lib/ld-linux-aarch64.so.1 (0x0000ffff80290000) libkaezip.so => /usr/local/kaezip/lib/libkaezip.so (0x0000ffff80830000)