文档首页 > > 加解密库> 开发指南(KAE加解密)> 安装、升级和卸载> 安装加速引擎软件> 通过deb包安装加速引擎软件

通过deb包安装加速引擎软件

分享
更新时间:2020/12/12 GMT+08:00

前提条件

  • 请在指定版本的操作系统上通过deb包进行安装,若无法安装请按源码方式进行安装。
  • dpkg工具能正常使用。
  • OpenSSL 1.1.1a或以上版本已正确安装,具体请参见安装OpenSSL

安装步骤

hisi_hpre,hisi_sec2,hisi_rde,hisi_zip驱动软件包依赖于uacce软件包;libkae,libkaezip引擎软件包依赖libwd软件包。

  • 如果仅加速RSA和DH算法建议只需要安装uacce、hisi_hpre 、libwd 、libkae软件包。
  • 如果仅加速AES/MD5/SM3/SM4国密算法建议只需要安装uacce、hisi_sec2 、libwd 、libkae软件包。
  • 如果仅加速zlib库的压缩算法建议只需要安装uacce、hisi_zip 、libwd、libkaezip软件包。

各软件包提供算法功能请参考3.1.1-表 加速器软件包安装方式

  1. 使用SSH远程登录工具,将加速引擎软件包拷贝到自定义路径下。
  2. 使用SSH远程登录工具,以root帐号进入Linux操作系统命令行界面
  3. 执行dpkg -i命令安装加速驱动软件包,例如可以通过dpkg -i *.deb安装所有加速引擎软件包。

    1
    [root@localhost home]# dpkg -i *.deb 
    

  4. (可选)如果已经按3安装deb软件,请跳过该步骤。如果需要单独安装软件包,请参考以下安装uacce-1.3.1软件包示例进行安装。

    1
    2
    [root@localhost home]# dpkg -i uacce-1.3.1-1.ubuntu18.04.arm64.deb 
    uacce modules installed
    

    依次安装hisi_hpre,hisi_sec2,hisi_rde,hisi_zip驱动软件包和libwd,libkae,libkaezip引擎软件包。安装libkae或者libkaezip引擎软件包时需要先安装libwd软件包。

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

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    [root@localhost deb]# dpkg -L uacce 
    /.
    /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
    [root@localhost deb]# dpkg -L hisi-sec2 hisi-hpre hisi-rde hisi-zip 
    /. 
    /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_sec2.ko 
    /etc 
    /etc/modprobe.d 
    /etc/modprobe.d/hisi_sec2.conf 
     
    /. 
    /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_hpre.ko 
    /etc 
    /etc/modprobe.d 
    /etc/modprobe.d/hisi_hpre.conf 
     
    /. 
    /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_rde.ko 
    /etc 
    /etc/modprobe.d 
    /etc/modprobe.d/hisi_rde.conf 
     
    /. 
    /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 
    [root@localhost deb]# ls -al /lib/modules/`uname -r`/extra  
    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 49080 Apr 15 09:15 hisi_hpre.ko 
    -rw-r--r-- 1 root root 85728 Apr 15 09:15 hisi_qm.ko 
    -rw-r--r-- 1 root root 59720 Apr 15 09:15 hisi_rde.ko 
    -rw-r--r-- 1 root root 65536 Apr 15 09:15 hisi_sec2.ko 
    -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 
    [root@localhost deb]# ls -al /etc/modprobe.d/   
    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   45 Apr 15 09:15 hisi_hpre.conf
    -rw-r--r--  1 root root   44 Apr 15 09:15 hisi_rde.conf
    -rw-r--r--  1 root root   61 Apr 15 09:15 hisi_sec2.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
    

  6. 重启系统或通过命令行手动依次加载加速器驱动到内核,并查看是否加载成功。

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    [root@localhost deb]# lsmod | grep uacce 
    [root@localhost deb]# modprobe uacce 
    [root@localhost deb]# modprobe hisi_sec2 #加载hisi_sec2驱动时将根据/etc/modprobe.d/hisi_sec2.conf 下的配置文件加载到内核 
    [root@localhost deb]# modprobe hisi_hpre #加载hisi_hpre驱动时将根据/etc/modprobe.d/hisi_hpre.conf 下的配置文件加载到内核 
    [root@localhost deb]# modprobe hisi_rde  #加载hisi_rde驱动时将根据/etc/modprobe.d/hisi_rde.conf 下的配置文件加载到内核 
    [root@localhost deb]# modprobe hisi_zip  #加载hisi_zip驱动时将根据/etc/modprobe.d/hisi_zip.conf 下的配置文件加载到内核 
    [root@localhost deb]# lsmod | grep uacce 
    uacce                  28672  1 hisi_qm 
    [root@localhost deb]# lsmod | grep hisi_qm
    hisi_qm               65536  4 hisi_sec2,hisi_zip,hisi_hpre,hisi_rde
    uacce                  28672  1 hisi_qm 
    

    加速器引擎代码包含内核驱动、用户态驱动、KAE引擎和zlib库四个模块。其中内核驱动与用户态驱动为必选项,KAE引擎与zlib库按实际需求选择安装。

安装后检查

  1. 使用dpkg -s查看加速引擎软件包。

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    [root@localhost root]# dpkg -s uacce hisi-sec2 hisi-hpre hisi-zip hisi-rde 
    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-sec2
    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 SEC Accelerator Driver.
    URL: https://support.huawei.com
     
    Package: hisi-hpre
    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 HPRE Accelerator Driver.
    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
     
    Package: hisi-rde
    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 RDE Accelerator Driver.
    URL: https://support.huawei.com 
    

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

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    [root@localhost deb]# ls -al /sys/class/uacce/ 
    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_hpre-0 -> ../../devices/pci0000:78/0000:78:00.0/0000:79:00.0/uacce/hisi_hpre-0
    lrwxrwxrwx  1 root root 0 Apr    15 17:42 hisi_hpre-1 -> ../../devices/pci0000:b8/0000:b8:00.0/0000:b9:00.0/uacce/hisi_hpre-1
    lrwxrwxrwx  1 root root 0 Apr    15 17:42 hisi_rde-4 -> ../../devices/pci0000:78/0000:78:01.0/uacce/hisi_rde-4
    lrwxrwxrwx  1 root root 0 Apr    15 17:42 hisi_rde-5 -> ../../devices/pci0000:b8/0000:b8:01.0/uacce/hisi_rde-5
    lrwxrwxrwx  1 root root 0 Apr    15 17:42 hisi_sec2-2 -> ../../devices/pci0000:74/0000:74:01.0/0000:76:00.0/uacce/hisi_sec2-2
    lrwxrwxrwx  1 root root 0 Apr    15 17:42 hisi_sec2-3 -> ../../devices/pci0000:b4/0000:b4:01.0/0000:b6:00.0/uacce/hisi_sec2-3
    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. 通过OpenSSL命令验证加速器是否生效,以验证RSA性能为例,命令如下:

    1
    2
    3
    4
    5
    6
    7
    8
    [root@localhost deb]# cd /usr/local/bin/ 
    [root@localhost bin]# ./openssl speed rsa2048 
                         sign    verify    sign/s verify/s 
    rsa 2048 bits 0.001381s 0.000035s    724.1  28601.0 
    [root@localhost bin]# ./openssl speed -engine kae rsa2048 
    engine "kae" set. 
                      sign    verify    sign/s verify/s 
    rsa 2048 bits 0.000175s 0.000021s   5730.1  46591.8 
    

    通过RSA性能命令可以看到指定kae引擎之后,RSA的性能得到明显提升。另外,除上述方法,在跑RSA性能命令过程中,可以在新的终端上同时查看hpre设备的硬件队列资源情况如下:

    1
    2
    3
    [root@localhost ~]# cat /sys/class/uacce/hisi_hpre-*/attrs/available_instances 
    256 
    255  #从256变为255,说明RSA算消耗了HRPE加速器一个硬件单元队列,说明加速器引擎已生效
    

  4. (可选)查看zlib库加速引擎是否生效,用户如果没有安装hisi_zip软件可以忽略该步骤。通过ldd命令查看zlib加速库是否链接到libwd和libkaezip,如果有返回如下信息,说明zlib加速库安装成功。同样的,用户的进程也可以通过ldd 命令查看是否使用libwd和libkaezip。

    1
    2
    3
    4
    5
    6
    7
    [root@localhost /]# ldd /usr/local/kaezip/lib/libz.so.1.2.11 
             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) 
     [root@localhost /]#
    

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问