KAE Initialization Failure

Symptom

An error is reported or no acceleration effect is achieved when KAE is used to accelerate OpenSSL.

Key Process and Cause Analysis

• Check whether the accelerator drivers are loaded successfully.
• Check whether the KAE soft link is created successfully.
• Check whether the environment variable of the OpenSSL engine library path has been configured.

Conclusion and Solution

1. Check that the accelerator drivers are loaded successfully. Check whether uacce.ko, qm.ko, sgl.ko, hisi_sec2.ko, hisi_hpre.ko, hisi_rde.ko, and hisi_zip.ko are loaded.

   1	lsmod | grep uacce

   If the following information is displayed, the loading is successful. If any module is missing, check whether an exception occurred during the corresponding installation process. If yes, reinstall the module.

   1	uacce 262144 2 hisi_hpre,hisi_qm,hisi_sec2,hisi_rde,hisi_zip

2. Check that the KAE library exists in the software installation directory (/usr/lib64 for RPM installation and /usr/local/lib for source code installation) and OpenSSL installation directory, and that the correct soft link is established.
   1. Check whether KAE is correctly installed and whether a soft link is established.
      • For OpenSSL 1.1.1x

        1	ll /usr/local/lib/engines-1.1/ | grep kae

      • For OpenSSL 3.0.x

        1	ll /usr/local/lib/engines-3.0/ | grep kae

      If the installation is correct, information similar to the following is displayed:

      1 2 3

      lrwxrwxrwx. 1 root root 22 Nov 12 02:33 kae.so -> kae.so.1.0.1 lrwxrwxrwx. 1 root root 22 Nov 12 02:33 kae.so.0 -> kae.so.1.0.1 -rwxr-xr-x. 1 root root 112632 May 25 2019 kae.so.1.0.1

   2. Check whether WD is correctly installed and whether a soft link is established.

      1	ll /usr/lib64/ | grep libwd

      If the installation is correct, information similar to the following is displayed:

      1 2 3

      lrwxrwxrwx. 1 root root 14 Nov 12 02:33 libwd.so -> libwd.so.1.0.1 lrwxrwxrwx. 1 root root 14 Nov 12 02:33 libwd.so.0 -> libwd.so.1.0.1 -rwxr-xr-x. 1 root root 137120 May 25 2019 libwd.so.1.0.1

3. Check whether the path to the OpenSSL engine library is set by running the export command.

   1	echo $OPENSSL_ENGINES

   • For OpenSSL 1.1.1x

     1	export OPENSSL_ENGINES=/usr/local/lib/engines-1.1

   • For OpenSSL 3.0.x

     1	export OPENSSL_ENGINES=/usr/local/lib/engines-3.0