源码安装（KAE2.0）

前提条件

• 请先下载KAE2.0源码包，下载路径为：https://gitee.com/kunpengcompute/KAE/tree/kae2/，或通过命令git clone https://gitee.com/kunpengcompute/KAE.git -b kae2下载。
• 安装前的系统环境已满足安装前准备中的环境要求。
• 使用openssl version命令检查OpenSSL是否为1.1.1a及以上版本，若低于1.1.1a版本请参见安装OpenSSL安装OpenSSL。
• 使用yum install -y make kernel-devel libtool numactl-devel openssl-devel chrpath命令安装相关依赖。
• 若使用的操作系统为openEuler 22.03 LTS-SP1，请使用KAE 2.0.0版本进行安装使用。

安装步骤

1. 使用远程登录工具，以root账号进入Linux操作系统命令行界面。
2. 将KAE源码包拷贝到自定义路径下。
3. （可选）一键安装所有模块。

   代码脚本提供一键式安装命令。进入KAE源码包目录，使用sh build.sh all命令安装以上所有组件内容，若不需要压缩模块，请参见4~6分模块安装。

4. 安装内核驱动。
   1. 进入KAE源码包目录中，执行安装脚本。

      1 2	cd KAE sh build.sh driver

      加速器驱动编译生成uacce.ko、hisi_qm.ko、hisi_sec2.ko、hisi_hpre.ko、hisi_zip.ko、hisi_rde.ko，安装路径为：“/lib/modules/`uname -r`/extra”。

   2. 查看驱动是否安装成功。
      • 查看“/sys/class/uacce”目录下是否存在加速引擎文件系统。

        1	ll /sys/class/uacce/

        回显信息如下所示，表示驱动安装成功。

        1 2 3 4 5 6

        lrwxrwxrwx. 1 root root 0 Aug 22 17:14 hisi_hpre-2 -> ../../devices/pci0000:78/0000:78:00.0/0000:79:00.0/uacce/hisi_hpre-2 lrwxrwxrwx. 1 root root 0 Aug 22 17:14 hisi_hpre-3 -> ../../devices/pci0000:b8/0000:b8:00.0/0000:b9:00.0/uacce/hisi_hpre-3 lrwxrwxrwx. 1 root root 0 Aug 22 17:14 hisi_sec2-0 -> ../../devices/pci0000:74/0000:74:01.0/0000:76:00.0/uacce/hisi_sec2-0 lrwxrwxrwx. 1 root root 0 Aug 22 17:14 hisi_sec2-1 -> ../../devices/pci0000:b4/0000:b4:01.0/0000:b6:00.0/uacce/hisi_sec2-1 lrwxrwxrwx. 1 root root 0 Aug 22 17:14 hisi_zip-4 -> ../../devices/pci0000:74/0000:74:00.0/0000:75:00.0/uacce/hisi_zip-4 lrwxrwxrwx. 1 root root 0 Aug 22 17:14 hisi_zip-5 -> ../../devices/pci0000:b4/0000:b4:00.0/0000:b5:00.0/uacce/hisi_zip-5

      • 通过lsmod查看驱动安装情况来判断驱动是否安装成功。

        1	lsmod | grep uacce

        回显信息如下所示，表示驱动安装成功。

        1	uacce 32768 3 hisi_sec2,hisi_qm,hisi_zip

      

      • 重启设备安装驱动后查询不到设备文件，可能是操作系统自带加速驱动导致，可以卸载驱动后重新加载；或者在启动脚本re.local中加上重新加载驱动命令。以hisi_sec2为例。

        1 2	rmmod hisi_sec2 modprobe hisi_sec2

      • 如果sh build.sh cleanup后重新安装仍旧找不到设备文件，请确保License安装成功，若无License也会导致驱动安装失败，关于License请参见安装前准备中的“获取License”内容。
      • KAE2.0版本安装驱动会默认将加解密及解压缩驱动一起安装，若不需要可手动卸载不需要的驱动文件。
5. 安装UADK框架。
   1. 执行安装UADK框架的脚本命令。

      1	sh build.sh uadk

      UADK框架中包含了用户态驱动，用户态驱动动态库文件为libwd.so、libwd_crypto.so等。UADK默认安装路径为“/usr/include/uadk”，动态库文件在“/usr/local/lib”下。

      

      若执行安装UADK命令后失败，提示缺少头文件，则安装相关依赖包后重新执行安装命令即可。

   2. 查看UADK框架是否安装成功。

      1	ll /usr/local/lib/libwd*

      回显信息如下，表示安装成功。

      1 2 3 4 5 6 7 8 9 10 11 12

      -rwxr-xr-x. 1 root root 961 Aug 22 17:23 /usr/local/lib/libwd_comp.la lrwxrwxrwx. 1 root root 19 Aug 22 17:23 /usr/local/lib/libwd_comp.so -> libwd_comp.so.2.5.0 lrwxrwxrwx. 1 root root 19 Aug 22 17:23 /usr/local/lib/libwd_comp.so.2 -> libwd_comp.so.2.5.0 -rwxr-xr-x. 1 root root 377872 Aug 22 17:23 /usr/local/lib/libwd_comp.so.2.5.0 -rwxr-xr-x. 1 root root 973 Aug 22 17:23 /usr/local/lib/libwd_crypto.la lrwxrwxrwx. 1 root root 21 Aug 22 17:23 /usr/local/lib/libwd_crypto.so -> libwd_crypto.so.2.5.0 lrwxrwxrwx. 1 root root 21 Aug 22 17:23 /usr/local/lib/libwd_crypto.so.2 -> libwd_crypto.so.2.5.0 -rwxr-xr-x. 1 root root 715616 Aug 22 17:23 /usr/local/lib/libwd_crypto.so.2.5.0 -rwxr-xr-x. 1 root root 907 Aug 22 17:23 /usr/local/lib/libwd.la lrwxrwxrwx. 1 root root 14 Aug 22 17:23 /usr/local/lib/libwd.so -> libwd.so.2.5.0 lrwxrwxrwx. 1 root root 14 Aug 22 17:23 /usr/local/lib/libwd.so.2 -> libwd.so.2.5.0 -rwxr-xr-x. 1 root root 1342080 Aug 22 17:23 /usr/local/lib/libwd.so.2.5.0

6. 编译安装KAEOpensslEngine加速引擎。

   1	sh build.sh engine

   KAE引擎动态库文件为libkae.so。动态库文件在“/usr/local/lib/engines-1.1”下。

   查看KAE引擎是否安装成功。

   1	ll /usr/local/lib/engines-1.1

   回显信息如下，表示安装成功。

   1 2 3 4 5 6

   total 5644 -rw-r--r--. 1 root root 3846524 Aug 22 17:28 kae.a -rwxr-xr-x. 1 root root 995 Aug 22 17:28 kae.la lrwxrwxrwx. 1 root root 12 Aug 22 17:28 kae.so -> kae.so.2.0.0 lrwxrwxrwx. 1 root root 12 Aug 22 17:28 kae.so.2 -> kae.so.2.0.0 -rwxr-xr-x. 1 root root 1967736 Aug 22 17:28 kae.so.2.0.0

7. 查看KAEOpensslEngine加速引擎是否生效。

   以验证RSA性能为例，验证步骤请参见测试同步RSA性能，通过RSA性能命令可以看到指定KAE引擎之后，RSA的性能得到明显提升。

   另外，除上述方法，在执行RSA性能命令过程中，可以在新的终端上同时查看hisi_hpre设备的硬件队列资源情况如下，相同地，SM3/SM4算法可以查看hisi_sec2的硬件队列消耗情况。

   cat /sys/class/uacce/hisi_hpre-*/available_instances

   显示结果从256变为255，说明RSA算法消耗了HPRE加速器一个硬件单元队列，说明KAEOpensslEngine加速引擎已生效。