长期支持版本

    社区创新版本

      使用KAE加速引擎

      简介

      KAE加速引擎为openEuler的一个软件加速库,搭载在Kunpeng 920处理器上联合提供硬件加速引擎功能,包含了对称加密、非对称加密和数字签名,用于加速SSL/TLS应用,可以显著降低处理器消耗,提高处理器效率。此外,用户通过OpenSSL标准接口可实现业务快速迁移。

      KAE加速引擎支持以下算法:

      • 摘要算法SM3,支持异步模式。
      • 对称加密算法SM4,支持异步模式,支持CTR/XTS/CBC模式。
      • 对称加密算法AES,支持异步模式,支持ECB/CTR/XTS/CBC模式。
      • 非对称算法RSA,支持异步模式,支持 Key Sizes 1024/2048/3072/4096。
      • 密钥协商算法DH,支持异步模式,支持 Key Sizes 768/1024/1536/2048/3072/4096。

      应用场景

      KAE加速引擎主要有以下应用场景,如表1所示。

      表 1 应用场景

      场景

      数据

      大数据

      流数据

      数据加密

      块数据

      智能安防

      视频流数据

      Web服务

      握手连接

      安装、升级和卸载

      安装加速器软件包

      安装前准备

      环境要求
      • TaiShan 200服务器,开启加速引擎功能

      说明:

      • CPU:Kunpeng 920
      • 操作系统:openEuler-23.03-aarch64-dvd.iso
      KAE加速引擎软件说明

      表 2 加速引擎的rpm软件包

      软件包名称

      软件包说明

      kae_driver-版本号-1.OS类型.aarch64.rpm

      加速器驱动,包含内容:uacce.ko、hisi_qm.ko、hisi_sec2.ko、hisi_hpre.ko内核模块

      支持:SM3/SM4/AES/RSA/DH算法

      libwd-版本号-1.OS类型.aarch64.rpm

      包含内容:libwd.so动态链接库

      提供接口给KAE引擎

      libkae-版本号-1.OS类型.aarch64.rpm

      依赖:libwd rpm包

      包含内容:libkae.so动态库

      支持:SM3/SM4/AES/RSA/DH等算法

      安装加速器软件包

      前提条件
      • 已在本地安装远程SSH登录工具。

      • 已安装openEuler操作系统。

      • RPM工具能正常使用。

      • 已安装OpenSSL 1.1.1a或以上版本。

        使用如下命令查询OpenSSL的版本号:

        • openssl version
      安装步骤
      1. 以root帐号登录openEuler OS命令行界面。

      2. 新建目录用于存放加速器引擎软件包。

      3. 使用SSH远程登录工具,将所有加速引擎软件包拷贝到已建好的目录下。

      4. 在存放加速引擎软件包目录下,使用rpm -ivh命令安装加速器引擎软件包。

        说明:
        由于libkae包的安装依赖libwd包,所以libwd的安装必须先于libkae。

        rpm -ivh uacce*.rpm hisi*.rpm libwd-*.rpm libkae*.rpm
        
        Verifying...                          ################################# [100%]
        Preparing...                          ################################# [100%]
        checking installed modules
        uacce modules start to install
        Updating / installing...
           1:uacce-1.2.10-4.oe1               ################################# [ 14%]
        uacce modules installed
           2:libwd-1.2.10-3.oe1               ################################# [ 29%]
           3:libkae-1.2.10-3.oe1              ################################# [ 43%]
        checking installed modules
        hisi_hpre modules start to install
           4:hisi_hpre-1.2.10-4.oe1           ################################# [ 57%]
        hisi_hpre modules installed
        checking installed modules
        hisi_rde modules start to install
           5:hisi_rde-1.2.10-4.oe1            ################################# [ 71%]
        hisi_rde modules installed
        checking installed modules
        hisi_sec2 modules start to install
           6:hisi_sec2-1.2.10-4.oe1           ################################# [ 86%]
        hisi_sec2 modules installed
        checking installed modules
        hisi_zip modules start to install
           7:hisi_zip-1.2.10-4.oe1            ################################# [100%]
        hisi_zip modules installed
        
      5. 使用rpm -qa命令,查看加速器软件包是否已正常安装到系统内。使用rpm -ql命令,查看软件包的文件是否正确。示例如下:

        rpm -qa|grep -E "hisi|uacce|libwd|libkae"
        
        hisi_rde-1.2.10-4.oe1.aarch64
        hisi_sec2-1.2.10-4.oe1.aarch64
        libkae-1.2.10-3.oe1.aarch64
        hisi_hpre-1.2.10-4.oe1.aarch64
        uacce-1.2.10-4.oe1.aarch64
        libwd-1.2.10-3.oe1.aarch64
        hisi_zip-1.2.10-4.oe1.aarch64
        
        rpm -ql uacce hisi* libwd* libkae
        
        /lib/modules/4.19.90-2003.4.0.0036.oe1.aarch64/extra/hisi_qm.ko
        /lib/modules/4.19.90-2003.4.0.0036.oe1.aarch64/extra/uacce.ko
        /etc/modprobe.d/hisi_hpre.conf
        /lib/modules/4.19.90-2003.4.0.0036.oe1.aarch64/extra/hisi_hpre.ko
        /etc/modprobe.d/hisi_rde.conf
        /lib/modules/4.19.90-2003.4.0.0036.oe1.aarch64/extra/hisi_rde.ko
        /etc/modprobe.d/hisi_sec2.conf
        /lib/modules/4.19.90-2003.4.0.0036.oe1.aarch64/extra/hisi_sec2.ko
        /etc/modprobe.d/hisi_zip.conf
        /lib/modules/4.19.90-2003.4.0.0036.oe1.aarch64/extra/hisi_zip.ko
        /usr/include/warpdrive/config.h
        /usr/include/warpdrive/include/uacce.h
        /usr/include/warpdrive/smm.h
        /usr/include/warpdrive/wd.h
        /usr/include/warpdrive/wd_bmm.h
        /usr/include/warpdrive/wd_cipher.h
        /usr/include/warpdrive/wd_comp.h
        /usr/include/warpdrive/wd_dh.h
        /usr/include/warpdrive/wd_digest.h
        /usr/include/warpdrive/wd_rsa.h
        /usr/lib64/libwd.so.1.2.10
        /usr/local/lib/engines-1.1/libkae.so.1.2.10
        
      6. 重启系统或通过命令行手动依次加载加速器引擎驱动到内核,并查看是否加载成功。

        # modprobe uacce 
        # lsmod | grep uacce 
        # modprobe hisi_qm
        # lsmod | grep hisi_qm 
        # modprobe hisi_sec2 #加载hisi_sec2驱动时将根据/etc/modprobe.d/hisi_sec2.conf 下的配置文件加载到内核
        # modprobe hisi_hpre #加载hisi_hpre驱动时将根据/etc/modprobe.d/hisi_hpre.conf 下的配置文件加载到内核
        
      设置环境变量

      通过以下命令导出环境变量:如果用户指定安装路径,则下面/usr/local应根据实际安装路径进行修改。

      export OPENSSL_ENGINES=/usr/local/lib/engines-1.1
      
      安装后检查

      执行rpm -qa命令查看加速器引擎软件包是否安装成功。

      打印信息中包含“ 软件包名-版本号- ”表示该软件包安装成功。示例如下:

      rpm -qa|grep -E "hisi|uacce|libwd|libkae"
      
      hisi_rde-1.2.10-4.oe1.aarch64
      hisi_sec2-1.2.10-4.oe1.aarch64
      libkae-1.2.10-3.oe1.aarch64
      hisi_hpre-1.2.10-4.oe1.aarch64
      uacce-1.2.10-4.oe1.aarch64
      libwd-1.2.10-3.oe1.aarch64
      hisi_zip-1.2.10-4.oe1.aarch64
      

      安装后操作

      OpenSSL加速器引擎测试

      用户可以通过以下命令测试部分加速器功能。

      • 使用OpenSSL的软件算法测试RSA性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -elapsed rsa2048
        ...
                         sign    verify    sign/s verify/s
        rsa 2048 bits 0.001384s 0.000035s   724.1  28365.8.
        
      • 使用KAE引擎测试RSA性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -elapsed -engine kae rsa2048
        ....
                         sign    verify    sign/s verify/s
        rsa 2048 bits 0.000355s 0.000022s   2819.0  45478.4
        

      说明:
      使用KAE引擎加速后签名性能从724.1 sign/s提升到2819 sign/s。

      • 使用OpenSSL的软件算法测试异步RSA性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -elapsed -async_jobs 36 rsa2048 
        ....
                          sign    verify    sign/s verify/s
        rsa 2048 bits 0.001318s 0.000032s    735.7  28555
        
      • 使用KAE引擎的测试异步RSA性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -engine kae -elapsed -async_jobs 36 rsa2048 
        .... 
                          sign    verify    sign/s verify/s
        rsa 2048 bits 0.000018s 0.000009s  54384.1 105317.0
        

      说明:
      使用KAE引擎加速后异步RSA签名性能从735.7 sign/s提升到 54384.1 sign/s。

      • 使用OpenSSL的软件算法测试SM4 CBC模式性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -elapsed -evp sm4-cbc
        You have chosen to measure elapsed time instead of user CPU time.
        ....
        Doing sm4-cbc for 3s on 10240 size blocks: 2196 sm4-cbc's in 3.00s  ....
        type          51200 bytes 102400 bytes1048576 bytes2097152 bytes4194304 bytes8388608 bytes
        sm4-cbc          82312.53k    85196.80k    85284.18k    85000.85k    85284.18k    85261.26k
        
      • 使用KAE引擎的测试SM4 CBC模式性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -elapsed -engine kae -evp sm4-cbc
        engine "kae" set. 
        You have chosen to measure elapsed time instead of user CPU time.
        ...
        Doing sm4-cbc for 3s on 1048576 size blocks: 11409 sm4-cbc's in 3.00s
        ...
        type          51200 bytes 102400 bytes1048576 bytes2097152 bytes4194304 bytes8388608 bytes
        sm4-cbc         383317.33k   389427.20k   395313.15k   392954.73k   394264.58k   394264.58k
        

      说明:
      使用KAE加速后SM4 CBC模式在输入数据块大小为8M时,从82312.53k/s提升到383317.33k/s。

      • 使用OpenSSL的软件算法测试SM3模式性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -elapsed -evp sm3
        You have chosen to measure elapsed time instead of user CPU time.
        Doing sm3 for 3s on 102400 size blocks: 1536 sm3's in 3.00s
        ....
        type          51200 bytes 102400 bytes1048576 bytes2097152 bytes4194304 bytes8388608 bytes
        sm3              50568.53k    52428.80k    52428.80k    52428.80k    52428.80k    52428.80k
        
      • 使用KAE引擎测试SM3模式性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -elapsed -engine kae -evp sm3
        engine "kae" set.
        You have chosen to measure elapsed time instead of user CPU time.
        Doing sm3 for 3s on 102400 size blocks: 19540 sm3's in 3.00s
        ....
        type            51200 bytes  102400 bytes  1048576 bytes 2097152 bytes 4194304 bytes 8388608 bytes
        sm3             648243.20k   666965.33k   677030.57k   678778.20k   676681.05k   668292.44k
        

      说明:
      使用KAE加速后SM3算法在输入数据块大小为8M时,从52428.80 k/s提升到668292.44k/s。

      • 使用OpenSSL软件算法测试AES算法CBC模式异步性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -elapsed -evp aes-128-cbc -async_jobs 4
        You have chosen to measure elapsed time instead of user CPU time.
        Doing aes-128-cbc for 3s on 51200 size blocks: 65773 aes-128-cbc's in 3.00s
        Doing aes-128-cbc for 3s on 102400 size blocks: 32910 aes-128-cbc's in 3.00s
        ....
        type          51200 bytes 102400 bytes1048576 bytes2097152 bytes4194304 bytes8388608 bytes
        aes-128-cbc    1122525.87k  1123328.00k  1120578.22k  1121277.27k  1119879.17k  1115684.86k
        
      • 使用KAE引擎测试AES算法CBC模式异步性能。

        linux-rmw4:/usr/local/bin # ./openssl speed -elapsed -evp aes-128-cbc -async_jobs 4 -engine kae
        engine "kae" set.
        You have chosen to measure elapsed time instead of user CPU time.
        Doing aes-128-cbc for 3s on 51200 size blocks: 219553 aes-128-cbc's in 3.00s
        Doing aes-128-cbc for 3s on 102400 size blocks: 117093 aes-128-cbc's in 3.00s
        ....
        type          51200 bytes 102400 bytes1048576 bytes2097152 bytes4194304 bytes8388608 bytes
        aes-128-cbc    3747037.87k  3996774.40k  1189085.18k  1196774.74k  1196979.11k  1199570.94k
        

      说明:

      • AES仅支持数据长度为256KB及以下场景的异步使用。
      • 使用KAE加速后AES算法在输入数据块为100K大小时,从1123328.00k/s提升到3996774.40 k/s 。

      升级加速器软件包

      使用场景

      当需要更新加速器软件版本时可以使用rpm -Uvh方式进行升级。

      操作步骤

      1. 从openEuler社区下载最新版本的加速引擎软件包。

      2. 使用SSH远程登录工具,以root帐号进入Linux操作系统命令行界面。

      3. 将下载下来的最新版本的软件包都放在某个路径下。

      4. 在存放软件包的路径下使用rpm -Uvh 命令升级加速器驱动包及引擎库包。示例如下:

        命令和信息回显如下所示。

      5. 使用rpm -qa 命令查询是否升级成功。确认查询到的版本是最新的升级后版本。

      6. 重启系统或通过命令行手动卸载旧版本驱动,然后加载新版本驱动,并查看是否加载成功。

        卸载旧驱动
        # lsmod | grep uacce 
        uacce                 262144  3 hisi_hpre,hisi_sec2,hisi_qm 
        # 
        # rmmod hisi_hpre 
        # rmmod hisi_sec2 
        # rmmod hisi_qm 
        # rmmod uacce 
        # lsmod | grep uacce 
        # 
        加载新驱动# modprobe uacce 
        # modprobe hisi_qm# modprobe hisi_sec2 #加载hisi_sec2驱动时将根据/etc/modprobe.d/hisi_sec2.conf 下的配置文件加载到内核
        # modprobe hisi_hpre  #加载hisi_hpre驱动时将根据/etc/modprobe.d/hisi_hpre.conf 下的配置文件加载到内核
        # lsmod | grep uacce 
        uacce                36864  3 hisi_sec2,hisi_qm,hisi_hpre
        

      卸载加速器软件包

      使用场景

      用户不再使用加速引擎软件,或进行新版本加速引擎软件的安装。

      操作步骤

      1. 使用SSH远程登录工具,以root帐号进入Linux操作系统命令行界面。

      2. 重启系统或通过命令行手动将已加载到内核的驱动卸载掉,并查看是否卸载成功。

        # lsmod | grep uacce 
        uacce                36864  3 hisi_sec2,hisi_qm,hisi_hpre 
        # rmmod hisi_hpre 
        # rmmod hisi_sec2  
        # rmmod hisi_qm 
        # rmmod uacce 
        # lsmod | grep uacce 
        #
        
      3. 通过rpm -e 命令卸载加速引擎软件包。示例如下:

        说明:
        由于存在依赖关系,卸载libwd前须先卸载libkae引擎软件包。

      4. 使用rpm -qa |grep 软件包名命令查询是否卸载成功。

      日志查询

      加速器引擎涉及日志信息如表3所示。

      表 3 日志信息

      目录

      文件名

      文件内容说明

      /var/log/

      kae.log

      OpenSSL引擎日志默认打印等级为error级别,如需要设置日志级别按照如下操作:

      1. export KAE_CONF_ENV=/var/log/
      2. 在/var/log/下创建文件kae.cnf
      3. 在kae.cnf 文件中设置如下:

        [LogSection]

        debug_level=error #取值内容none/error/info/warning/debug

      说明:

      正常情况下不建议开启info或debug级别日志,否则会导致加速器性能的下降。

      /var/log/

      messages/syslog

      • 内核日志路径为/var/log/messages。
      说明:

      或通过dmesg > /var/log/dmesg.log日志收集内核相关日志,包含驱动及内核态日志。

      加速引擎的应用

      说明:
      如果用户未购买引擎许可证,建议用户不要通过kae引擎调用相应算法,否则可能会影响openssl加密算法的性能。

      KAE引擎使用示例代码

      #include <stdio.h> 
      
      #include <stdlib.h> 
      
      /* OpenSSL headers */ 
      
      #include <openssl/bio.h> 
      
      #include <openssl/ssl.h> 
      
      #include <openssl/err.h> 
      
      #include <openssl/engine.h> 
      
      int main(int argc, char **argv) 
      
      { 
      
          /* Initializing OpenSSL */ 
      
          SSL_load_error_strings(); 
      
          ERR_load_BIO_strings(); 
      
          OpenSSL_add_all_algorithms(); 
      
          /*You can use ENGINE_by_id Function to get the handle of the Huawei Accelerator Engine*/ 
      
          ENGINE *e = ENGINE_by_id("kae"); 
      
          /*使能加速器异步功能,可选配置,设置为“0”表示不使能,设置为“1”表示使能,默认使能异步功能*/ 
      
          ENGINE_ctrl_cmd_string(e, "KAE_CMD_ENABLE_ASYNC", "1", 0) ;
      
          ENGINE_init(e); 
      
      
          RSA *rsa = RSA_new_method(e);#指定引擎用于RSA加解密 
      
          /*The user code*/ 
      
          …… 
      
      ; 
      
          ENGINE_free(e); 
      
      ; 
      
      }
      

      通过OpenSSL配置文件openssl.cnf使用KAE引擎

      新建openssl.cnf 需要添加如下配置信息:

      openssl_conf=openssl_def 
      [openssl_def] 
      engines=engine_section 
      [engine_section] 
      kae=kae_section 
      [kae_section] 
      engine_id=kae 
      dynamic_path=/usr/local/lib/engines-1.1/kae.so 
      KAE_CMD_ENABLE_ASYNC=1    # 0,表示不使能异步功能,1表示使能异步功能,默认使能 
      default_algorithms=ALL 
      init=1
      

      导出OPENSSL_CONF环境变量:

      export OPENSSL_CONF=/home/app/openssl.cnf  #该路径为openssl.cnf存放路径
      

      使用OpenSSL配置文件示例如下:

      #include <stdio.h>  
      
      #include <stdlib.h>  
      
      /* OpenSSL headers */  
      
      #include <openssl/bio.h>  
      
      #include <openssl/ssl.h>  
      
      #include <openssl/err.h>  
      
      #include <openssl/engine.h>  
      
      int main(int argc, char **argv)  
      
      {  
      
          /* Initializing OpenSSL */  
      
          SSL_load_error_strings();  
      
          ERR_load_BIO_strings();  
      
      #Load openssl configure 
      
      OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CONFIG, NULL);    OpenSSL_add_all_algorithms();  
      
          /*You can use ENGINE_by_id Function to get the handle of the Huawei Accelerator Engine*/  
      
          ENGINE *e = ENGINE_by_id("kae"); 
      
          /*The user code*/  
      
          ……  
      
      ;  
      
          ENGINE_free(e);  
      
      ;
      }
      

      故障处理

      初始化失败

      故障现象

      加速器引擎没有完全加载成功。

      处理步骤

      1. 检查加速器驱动是否加载成功,运行lsmod 命令查看uacce.ko、qm.ko 、sgl.ko 、hisi_sec2.ko 、hisi_hpre.ko 、hisi_zip.ko、 hisi_rde.ko是否在位。

        # lsmod | grep uacce
        uacce                  262144  2 hisi_hpre,hisi_qm,hisi_sec2,hisi_zip,hisi_rde
        
      2. 检查/usr/lib64(RPM方式安装时目录)或者/usr/local/lib(源码方式安装时目录)和OpenSSL安装目录是否有加速器引擎库,且建立正确的软链接。

         [root@localhost home]# ll /usr/local/lib/engines-1.1/ |grep kae 
        #查询kae是否正确安装并建立软链接,如果有正确安装显示如下内容
        # ll /usr/local/lib/engines-1.1/ |grep kae
        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
        [[root@localhost home]#
         [root@localhost home]# ll /usr/lib64/ | grep libwd  
         #查询libwd是否正确安装并建立软链接,如果有正确安装显示如下内容
        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
        [root@localhost home]#
        
      3. 检查OpenSSL引擎库的路径是否能通过export命令进行导出。

        # echo $OPENSSL_ENGINES 
        # export OPENSSL_ENGINES=/usr/local/lib/engines-1.1
        #  echo $OPENSSL_ENGINES
        /usr/local/lib/engines-1.1
        

      安装完加速器引擎之后,查找不到加速器设备

      故障现象

      安装完加速器引擎之后,查找不到加速器设备。

      解决方法

      1. 检查虚拟文件系统下是否有相应设备。正常情况下有如下相应的加速器设备。

        # ls -al /sys/class/uacce/
        total 0
        lrwxrwxrwx. 1 root root 0 Nov 14 03:45 hisi_hpre-2 -> ../../devices/pci0000:78/0000:78:00.0/0000:79:00.0/uacce/hisi_hpre-2
        lrwxrwxrwx. 1 root root 0 Nov 14 03:45 hisi_hpre-3 -> ../../devices/pci0000:b8/0000:b8:00.0/0000:b9:00.0/uacce/hisi_hpre-3
        lrwxrwxrwx. 1 root root 0 Nov 17 22:09 hisi_rde-4 -> ../../devices/pci0000:78/0000:78:01.0/uacce/hisi_rde-4
        lrwxrwxrwx. 1 root root 0 Nov 17 22:09 hisi_rde-5 -> ../../devices/pci0000:b8/0000:b8:01.0/uacce/hisi_rde-5
        lrwxrwxrwx. 1 root root 0 Nov 14 08:39 hisi_sec-0 -> ../../devices/pci0000:74/0000:74:01.0/0000:76:00.0/uacce/hisi_sec-0
        lrwxrwxrwx. 1 root root 0 Nov 14 08:39 hisi_sec-1 -> ../../devices/pci0000:b4/0000:b4:01.0/0000:b6:00.0/uacce/hisi_sec-1
        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
        
      2. 若要使用hpre设备但是在1中未查询到,请按初始化失败排查加速器软件是否已正确安装。

      3. 2已确认加速器软件正确安装,请通过lspci命令排查物理设备是否存在。

        # lspci | grep HPRE
        79:00.0 Network and computing encryption device: Huawei Technologies Co., Ltd. HiSilicon HPRE Engine (rev 21)
        b9:00.0 Network and computing encryption device: Huawei Technologies Co., Ltd. HiSilicon HPRE Engine (rev 21)
        ## lspci | grep SEC
        76:00.0 Network and computing encryption device: Huawei Technologies Co., Ltd. HiSilicon SEC Engine (rev 21)
        b6:00.0 Network and computing encryption device: Huawei Technologies Co., Ltd. HiSilicon SEC Engine (rev 21)
        ## lspci | grep RDE
        78:01.0 RAID bus controller: Huawei Technologies Co., Ltd. HiSilicon RDE Engine (rev 21)
        b8:01.0 RAID bus controller: Huawei Technologies Co., Ltd. HiSilicon RDE Engine (rev 21)
        ## lspci | grep ZIP
        75:00.0 Processing accelerators: Huawei Technologies Co., Ltd. HiSilicon ZIP Engine (rev 21)
        b5:00.0 Processing accelerators: Huawei Technologies Co., Ltd. HiSilicon ZIP Engine (rev 21)
        #
        
      4. 3未查询到相应的物理设备,请确认以下,不分先后:

        • 确认是否已导入加速器许可证,若未导入,请请参考《TaiShan 机架服务器 iBMC (V500及以上) 用户指南》中“许可证管理”章节,导入加速器许可证。导入加速器许可证之后,需要掉电重启BMC,使能License。
        • 确认BMC和BIOS版本是否支持加速器特性。

      升级加速器驱动失败

      故障现象

      升级加速器驱动后,重启系统驱动版本仍为旧版本。

      可能原因

      在升级加速器驱动前,系统更新了其他驱动包,这些驱动包可能重新更新了引导文件系统initramfs,将未升级前的加速器驱动一起更新到了initramfs文件系统中。例如系统更新了网卡驱动,或者人为更新了initramfs文件系统,导致系统重启时优先从initramfs文件系统中加载加速器驱动。

      处理步骤

      升级加速器驱动版本后,通过执行dracut --force命令重新更新initramfs文件系统。

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

      小问题,全程线上修改...

      一键搞定!

      问题类型
      规范和低错类

      ● 错别字或拼写错误;标点符号使用错误;

      ● 链接错误、空单元格、格式错误;

      ● 英文中包含中文字符;

      ● 界面和描述不一致,但不影响操作;

      ● 表述不通顺,但不影响理解;

      ● 版本号不匹配:如软件包名称、界面版本号;

      易用性

      ● 关键步骤错误或缺失,无法指导用户完成任务;

      ● 缺少必要的前提条件、注意事项等;

      ● 图形、表格、文字等晦涩难懂;

      ● 逻辑不清晰,该分类、分项、分步骤的没有给出;

      正确性

      ● 技术原理、功能、规格等描述和软件不一致,存在错误;

      ● 原理图、架构图等存在错误;

      ● 命令、命令参数等错误;

      ● 代码片段错误;

      ● 命令无法完成对应功能;

      ● 界面错误,无法指导操作;

      风险提示

      ● 对重要数据或系统存在风险的操作,缺少安全提示;

      内容合规

      ● 违反法律法规,涉及政治、领土主权等敏感词;

      ● 内容侵权;

      您对文档的总体满意度

      非常不满意
      非常满意
      提交
      根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
      文档捉虫
      编组 3备份