UADK Engine环境配置指南同步与异步模式深度优化【免费下载链接】uadk_engine项目地址: https://gitcode.com/openeuler/uadk_engine前往项目官网免费下载https://ar.openeuler.org/ar/UADK Engine是一个专为ARM架构优化的OpenSSL硬件加速引擎它通过利用华为鲲鹏处理器的硬件加速能力显著提升加密运算性能。本文将为您提供完整的UADK Engine环境配置指南并深入探讨同步与异步模式的优化策略帮助您充分发挥硬件加速潜力。什么是UADK EngineUADK Engine是OpenSSL的一个高性能硬件加速引擎专门为华为鲲鹏处理器设计。它通过调用底层的UADKUnified Acceleration Driver Kit库将加密运算任务卸载到硬件加速器实现比纯软件实现更高的性能表现。核心优势硬件加速利用鲲鹏处理器的加密硬件单元高性能相比软件实现性能提升可达数倍多算法支持支持RSA、DH、ECC、CIPHER、DIGEST等多种加密算法灵活配置支持同步和异步两种工作模式环境准备与依赖安装在开始配置UADK Engine之前需要确保系统满足以下基本要求系统要求CPU架构aarch64ARM64操作系统支持openEuler、CentOS等Linux发行版依赖库libnuma、zlib、OpenSSL 1.1.1f安装依赖包# 安装必要的开发工具和依赖库 sudo yum install -y gcc make autoconf automake libtool libnuma-devel zlib-devel安装OpenSSL 1.1.1f# 下载并编译OpenSSL git clone https://github.com/openssl/openssl.git cd openssl git checkout -b OpenSSL_1_1_1f OpenSSL_1_1_1f ./config -Wl,-rpath/usr/local/lib make sudo make install安装UADK库# 获取UADK源码并编译 git clone https://github.com/Linaro/uadk.git cd uadk ./cleanup.sh ./autogen.sh ./conf.sh make sudo make installUADK Engine安装与配置获取并编译UADK Engine# 克隆UADK Engine仓库 git clone https://gitcode.com/openeuler/uadk_engine cd uadk_engine # 配置编译选项 autoreconf -i ./configure --libdir/usr/local/lib/engines-1.1/ --enable-kae make sudo make install提示--enable-kae选项用于启用KAEKunpeng Acceleration Engine支持适用于非SVA版本。验证安装安装完成后可以通过以下命令验证UADK Engine是否成功加载# 查看OpenSSL支持的引擎 openssl engine -t -c # 运行测试脚本 ./test/sanity_test.sh同步模式与异步模式详解UADK Engine支持两种工作模式理解它们的区别对于优化性能至关重要。同步模式Synchronous Mode工作原理 在同步模式下应用程序调用加密函数后会阻塞等待直到硬件完成计算并返回结果。这种模式简单直接适合简单的加密任务。特点调用简单编程模型直观适用于单任务或低并发场景资源利用率相对较低环境变量配置示例# 在NUMA节点0上配置2个同步队列 export WD_RSA_CTX_NUMsync:20 export WD_DH_CTX_NUMsync:20⚡异步模式Asynchronous Mode工作原理 异步模式下应用程序提交加密任务后立即返回不等待任务完成。硬件在后台处理任务完成后通过回调或轮询机制通知应用程序。核心优势高并发支持同时处理多个加密任务高吞吐量充分利用硬件并行处理能力低延迟减少等待时间提高整体系统响应速度实现机制 异步模式通过src/uadk_async.c中的异步任务队列和事件通知机制实现。关键数据结构包括async_poll_queue异步轮询队列管理待处理任务async_op异步操作描述符跟踪任务状态事件驱动模型使用eventfd和信号量进行任务同步环境变量配置示例# 在NUMA节点0上配置4个异步队列 export WD_RSA_CTX_NUMasync:40 export WD_DH_CTX_NUMasync:40混合模式配置与优化在实际应用中通常需要根据业务场景配置同步和异步混合模式以达到最佳性能。混合模式配置示例# 混合配置同步和异步队列并存 export WD_RSA_CTX_NUMsync:20,async:40 export WD_DH_CTX_NUMsync:20,async:40 export WD_CIPHER_CTX_NUMsync:22,async:42 export WD_DIGEST_CTX_NUMsync:22,async:42 export WD_ECC_CTX_NUMsync:20,async:40配置说明sync:20在NUMA节点0上分配2个同步队列async:40在NUMA节点0上分配4个异步队列数字前的符号指定NUMA节点IDNUMA感知优化在多NUMA系统中合理配置队列与CPU核心的亲和性可以显著提升性能# 针对双NUMA节点系统的优化配置 export WD_RSA_CTX_NUMsync:10,async:20,sync:11,async:21 export WD_CIPHER_CTX_NUMsync:20,async:40,sync:21,async:41OpenSSL配置文件优化openssl.cnf配置为了启用UADK Engine的环境变量功能需要在OpenSSL配置文件中添加相应设置# 在openssl.cnf文件开头添加以下内容 openssl_cnf openssl_def [openssl_def] engines engine_section [engine_section] uadk_engine uadk_section [uadk_section] UADK_CMD_ENABLE_RSA_ENV 1 UADK_CMD_ENABLE_DH_ENV 1 UADK_CMD_ENABLE_CIPHER_ENV 1 UADK_CMD_ENABLE_DIGEST_ENV 1 UADK_CMD_ENABLE_ECC_ENV 1配置说明数值1表示启用对应算法的环境变量功能数值0表示禁用环境变量功能默认情况下openssl.cnf文件位于/usr/local/ssl/路径下持久化配置为了方便使用可以将环境变量配置添加到shell配置文件中# 编辑~/.bashrc文件 echo export WD_RSA_CTX_NUMsync:20,async:40 ~/.bashrc echo export WD_DH_CTX_NUMsync:20,async:40 ~/.bashrc echo export WD_CIPHER_CTX_NUMsync:22,async:42 ~/.bashrc echo export WD_DIGEST_CTX_NUMsync:22,async:42 ~/.bashrc echo export WD_ECC_CTX_NUMsync:20,async:40 ~/.bashrc # 使配置生效 source ~/.bashrc性能调优建议1. 队列数量优化经验法则同步队列通常配置为CPU核心数的1/4到1/2异步队列可以配置为CPU核心数的1-2倍监控调整通过系统监控工具观察队列使用率动态调整2. 任务类型匹配计算密集型任务适合使用异步模式充分利用硬件并行能力I/O密集型任务同步模式可能更合适避免任务调度开销混合负载采用同步异步混合配置根据任务特性分发3. 内存优化UADK Engine在src/uadk_utils.c中实现了内存拷贝优化// 大内存块拷贝优化 void *uadk_memcpy(void *dstpp, const void *srcpp, size_t len) { if (len UADK_MEM_IMPROVE_THRESHOLD) // 1024字节阈值 return memcpy_large(dstpp, srcpp, len); else return memcpy(dstpp, srcpp, len); }优化建议对于大于1KB的数据块使用优化的内存拷贝函数合理设置缓冲区大小减少内存碎片常见问题排查问题1找不到libnuma库错误信息cannot find -lnuma解决方案sudo yum install -y numactl-devel # 或 sudo apt-get install -y libnuma-dev问题2缺少zlib头文件错误信息fatal error: zlib.h: No such file or directory解决方案sudo yum install -y zlib-devel # 或 sudo apt-get install -y zlib1g-dev问题3环境变量不生效排查步骤检查openssl.cnf配置文件路径是否正确确认环境变量是否已导出使用env | grep WD_验证UADK Engine是否成功加载到OpenSSL中实战应用示例示例1RSA加密性能测试# 使用UADK Engine进行RSA加密测试 openssl speed -engine uadk_engine rsa2048 # 对比软件实现性能 openssl speed rsa2048示例2AES-GCM加密测试# 测试AES-GCM加密性能 openssl speed -engine uadk_engine -evp aes-256-gcm示例3自定义队列配置测试# 临时设置环境变量进行测试 export WD_CIPHER_CTX_NUMsync:40,async:80 openssl speed -engine uadk_engine -evp aes-256-cbc监控与调试性能监控工具perf工具监控CPU使用率和缓存命中率numastat监控NUMA内存访问情况自定义日志通过修改src/e_uadk.c添加调试信息调试技巧// 在代码中添加调试信息 #define UADK_DEBUG 1 #ifdef UADK_DEBUG fprintf(stderr, UADK Engine: %s queue configured\n, alg_name); #endif总结与最佳实践最佳实践总结环境配置确保所有依赖库正确安装使用正确的OpenSSL版本1.1.1f合理配置NUMA绑定模式选择高并发场景优先使用异步模式简单任务使用同步模式混合负载采用混合配置性能优化根据CPU核心数调整队列数量监控系统资源使用情况定期进行性能测试和调优故障排查保持环境变量配置的一致性使用测试脚本验证功能查看系统日志获取详细错误信息性能预期根据实际测试数据UADK Engine在鲲鹏处理器上可以提供RSA加解密性能提升3-5倍AES加解密性能提升2-4倍SHA256哈希性能提升2-3倍ECC运算性能提升4-6倍通过合理的环境配置和模式优化UADK Engine能够充分发挥华为鲲鹏处理器的硬件加速能力为您的加密应用提供卓越的性能表现。记住最佳配置取决于具体的应用场景和硬件环境建议在实际部署前进行充分的性能测试和调优。【免费下载链接】uadk_engine项目地址: https://gitcode.com/openeuler/uadk_engine创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考