RPM包安装（KAE1.0）

KAE1.0的RPM软件包包括hisi_hpre，hisi_sec2，hisi_rde，hisi_zip、libkaezip、libkae、uacce和libwd，其中uacce和libwd是必选安装项，其他软件包需要根据实际使用的模块和算法不同选择安装，也可全部安装。

前提条件

安装步骤

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

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

  1. 使用SSH远程登录工具，以root账号进入Linux操作系统命令行界面。
  2. 将KAE RPM软件包拷贝到自定义路径下。
  3. 安装加速驱动软件包。

    • 方式一：通过rpm -ivh *.rpm命令安装所有KAE RPM软件包。
      1
      rpm -ivh *.rpm
      回显结果如下。
       1
 2
 3
 4
 5
 6
 7
 8
 9
10
      Preparing...                          ################################# [100%]
checking installed modules
Updating / installing...
   1:uacce-1.0.1-1.centos7.6         ################################# [ 14%]
modules installed
   2:libwd-1.0.1-1.centos7.6         ################################# [ 29%]
   3:libkae-1.0.1-1.centos7.6        ################################# [ 43%]
checking installed modules
   7:hisi_zip-1.0.1-1.centos7.6      ################################# [100%]
modules installed
    • 方式二：依次对RPM包进行安装。以下示例为安装uacce-1.0.1软件包。
      1
      rpm -ivh uacce-1.0.1-1.centos7.6.aarch64.rpm
      回显结果如下。
      1
2
3
4
5
      Preparing...                          ################################# [100%]
checking installed modules
Updating / installing... 
1:uacce-1.0.1-1.centos7.6             ################################# [100%]
modules installed

      同理，依次安装hisi_zip驱动软件包和libwd引擎包。

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

    1. 查看uacce是否已安装。
      1
      rpm -ql uacce

      回显结果如下。

      1
2
      /lib/modules/4.14.0-115.el7a.0.1.aarch64/extra/hisi_qm.ko
/lib/modules/4.14.0-115.el7a.0.1.aarch64/extra/uacce.ko
    2. 查看hisi_zip是否已安装。
      1
      rpm -ql hisi_zip

      回显结果如下。

      1
2
      /lib/modules/4.14.0-115.el7a.0.1.aarch64/extra/hisi_zip.ko
/etc/modproe.d/hisi_zip.conf
    3. 查看安装目录下是否生成对应模块。
      1
      ls -al /lib/modules/`uname -r`/extra

      回显结果如下。

      1
2
3
4
5
      total 3672
drwxr-xr-x. 2 root root    118 Nov 17 21:56 .
drwxr-xr-x. 7 root root   4096 Nov 17 21:56 ..
-rw-r--r--. 1 root root 396784 Nov 12 17:32 hisi_zip.ko
-rw-r--r--. 1 root root 467160 Nov 12 17:32 uacce.ko
    4. 在“/etc/modprobe.d/”目录下查看是否生成对应的配置文件。
      1
      ls -al /etc/modprobe.d/

      回显结果如下。

      1
2
3
4
5
6
      total 36
drwxr-xr-x.   2 root root  140 Nov 17 21:56 .
drwxr-xr-x. 127 root root 8192 Nov 17 22:14 ..
-rw-r--r--.   1 root root  166 Oct 30  2018 firewalld-sysctls.conf
-rw-r--r--.   1 root root   43 Nov 17 21:56 hisi_zip.conf
-rw-r--r--.   1 root root  674 Jul  4  2018 tuned.conf

  5. （可选）如果是SUSE操作系统，在加载外部驱动前需要先将配置文件“/etc/modprobe.d/10-unsupported-modules.conf”中的“allow_unsupported_modules”参数值设置为“1”。
  6. 加载加速器驱动到内核。

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

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

      2. 加载uacce驱动。
        1
        modprobe uacce
      3. 加载hisi_zip驱动，将根据“/etc/modprobe.d/hisi_zip.conf”下的配置文件加载到内核。
        1
        modprobe hisi_zip
      4. 再次查询已载入内核的uacce驱动模块。
        1
        lsmod | grep uacce
        有以下加载的模块显示则表示加载成功。
        1
        uacce                36864  3 hisi_zip

安装后检查

  1. 查看KAE RPM软件包。

    1
    rpm -qa uacce hisi_zip
    显示以下格式内容说明安装成功。
    1
2
    uacce-1.0.1-1.centos7.6.aarch64
hisi_zip-1.0.1-1.centos7.6.aarch64

  2. 查看虚拟文件系统下对应的加速器设备。

    1
    ls -al /sys/class/uacce/
    回显结果如下。
    1
2
3
    total 0
lrwxrwxrwx. 1 root root 0 Nov 17 22:09 hisi_zip-6 -> ../../devices/pci0000:74/0000:74:00.0/0000:75:00.0/uacce/hisi_zip-6
lrwxrwxrwx. 1 root root 0 Nov 17 22:09 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)

父主题： 通过RPM包安装KAE