源码安装（KAE1.0）

前提条件

• 请先下载KAE1.0源码包，下载路径为：https://gitee.com/kunpengcompute/KAE/tree/kae1/
• 安装前的系统环境已满足安装前准备中的环境要求。

安装步骤

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

   在kae_driver源码目录下，进入kae_driver目录后开始安装内核驱动。

   1 2 3

   cd kae_driver/kae_driver make make install

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

   

   由于SUSE及CentOS内核目录为“/lib/modules/`uname -r`/”，驱动安装的目录为“/lib/modules/`uname -r`/extra”（`uname -r`命令获取当前运行内核信息）。如果其他操作系统不是该目录，需要修改Makefile文件中install指定的内核路径。

   install:

   “$(shell mkdir -p /lib/modules/`uname -r`/extra)”修改为“$(shell mkdir -p 内核路径/extra)”

4. 安装用户态驱动。
   在kae_driver源码目录下，进入warpdrive目录后开始安装Warpdrive驱动开发库。

   1 2 3 4 5

   cd kae_driver/warpdrive sh autogen.sh ./configure make make install

   其中，执行编译命令./configure时可以加--prefix选项用于指定加速器用户态驱动需要安装的位置，用户态驱动动态库文件为libwd.so。Warpdrive默认安装路径为“/usr/local”，动态库文件在“/usr/local/lib”下。

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_qm,hisi_zip

7. 编译安装zlib压缩库。
   1. 从zlib官网下载zlib-1.2.11.tar.gz，拷贝到“kae_zip_engine/open_source”路径下。
   2. 编译安装zlib库。

      1 2	cd kae_zip_engine sh setup.sh install

      zlib加速库安装在“/usr/local/kaezip”。

安装后检查

1. 执行cd命令，进入到“/usr/local/lib”目录或者用户自定义安装目录下。
2. 查看软连接状态。
   1. 查看libwd软连接状态。

      1	ls -al /usr/local/lib/ |grep libwd

      信息回显软连接及so存在，说明libwd安装成功。

      1 2 3

      lrwxrwxrwx. 1 root root 14 Jun 25 11:16 libwd.so -> libwd.so.1.0.1 lrwxrwxrwx. 1 root root 14 Jun 25 11:16 libwd.so.0 -> libwd.so.1.0.1 -rwxr-xr-x. 1 root root 137280 Jun 24 11:37 libwd.so.1.0.1

   2. 查看zlib库软连接状态。

      1	ll /usr/local/kaezip/lib

      信息回显软连接及so存在，说明zlib库安装成功。

      1 2 3 4

      -rw-r-r-. 1 root root 161162 Jul 10 12:54 libz.a lrwxrwxrwx. 1 root root 14 Jul 10 12:54 libz.so -> libz.so.1.2.11 lrwxrwxrwx. 1 root root 14 Jul 10 12:54 libz.so.1 -> libz.so.1.2.11 -rwxr-xr-x. 1 root root 146656 Jul 10 12:54 libz.so.1.2.11

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

   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

4. 查看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)