PowerAPI部署实战：从编译到运行的完整流程

PowerAPI部署实战：从编译到运行的完整流程

【免费下载链接】powerapiIncluding a power API SO and the Power API Service.项目地址: https://gitcode.com/openeuler/powerapi

前往项目官网免费下载：https://ar.openeuler.org/ar/

想要在openEuler系统上高效管理电源功耗吗？PowerAPI是您的终极解决方案！本文将为您提供从源码编译到服务运行的完整部署指南，帮助您快速掌握这款强大的电源管理API工具。

PowerAPI是一个功能强大的电源管理API工具，它提供了完整的电源API SO库和PowerAPI服务，让开发者能够轻松监控和控制系统功耗。无论您是系统管理员还是应用开发者，掌握PowerAPI的部署流程都是提升系统能效的关键一步。

📦 环境准备与源码获取

在开始部署之前，您需要确保系统满足以下基本要求：

• 操作系统：openEuler系统（推荐最新稳定版本）
• 编译工具：gcc、cmake、make等基础开发工具
• 依赖库：标准C库和系统开发包

首先，从官方仓库克隆PowerAPI源码：

git clone https://gitcode.com/openeuler/powerapi cd powerapi

🔧 编译PowerAPI：三种模式详解

PowerAPI提供了灵活的编译选项，满足不同场景的需求。让我们详细了解build.sh脚本的三种主要编译模式：

1. 标准编译模式

这是最常用的编译方式，生成完整的客户端和服务端组件：

./build.sh

此命令会编译所有组件，包括：

• 客户端库：libpwrapi.so动态库
• 服务端程序：pwrapis守护进程
• 演示程序：pwrapic_demo示例应用

2. 仅编译客户端模式

如果您只需要客户端库，可以使用：

./build.sh client

3. 仅编译服务端模式

如果只需服务端组件：

./build.sh server

4. 高级编译选项

PowerAPI还支持特殊编译模式：

• release模式：优化编译选项，适合生产环境
• asan模式：启用地址消毒器，用于调试内存问题
• export模式：导出编译数据库，便于IDE集成

🏗️ PowerAPI架构解析

上图展示了PowerAPI的整体架构设计。系统采用客户端-服务端模式：

• 客户端层：提供pwrapic/inc/powerapi.h等头文件定义的API接口
• 服务端层：pwrapis服务进程，负责实际的电源管理操作
• 通信层：通过Unix域套接字实现高效通信

🚀 一键安装与服务配置

编译完成后，使用install.sh脚本进行安装：

sudo ./install.sh

这个脚本会执行以下操作：

1. 安装编译产物到系统目录
2. 配置systemd服务pwrapis/pwrapis.service
3. 启用并启动PowerAPI服务

服务配置文件详解

PowerAPI服务的配置文件位于pwrapis/conf/pwrapis_config.ini，主要包含以下配置项：

[log] file_size=10 # 日志文件大小（MB） log_level=1 # 日志级别：0-debug, 1-info, 2-warning, 3-error log_path=/var/log/pwrapis # 日志存储路径 [server] sock_file=/etc/sysconfig/pwrapis/pwrserver.sock # 通信套接字路径 [client] admin=root # 管理员用户（可观察和配置系统） observer= # 观察者用户（仅可观察系统）

🎯 快速启动与验证

手动启动服务

如果您想手动测试服务，可以使用以下命令：

./release/pwrapis/pwrapis pwrapis/conf/pwrapis_config.ini &

运行演示程序

验证PowerAPI功能是否正常：

./release/pwrapi_demo/pwrapic_demo

演示程序会测试各种电源管理功能，包括：

• CPU频率调节
• 系统功耗监控
• 内存带宽管理
• 磁盘电源状态控制

🔍 API使用示例

让我们通过pwrapic/test/demo_main.c中的代码，了解如何使用PowerAPI：

基本使用流程

1. 初始化连接

TEST_PWR_SetServerInfo(); // 设置服务器信息 TEST_PWR_SetClientSockPath(); // 设置客户端套接字路径 TEST_PWR_Register(); // 注册客户端

2. 获取系统功耗信息

TEST_SYS_GetRtPowerInfo(); // 获取实时功耗信息

3. CPU电源管理

TEST_PWR_CPU_GetInfo(); // 获取CPU信息 TEST_PWR_CPU_GetUsage(); // 获取CPU使用率 TEST_PWR_CPU_SetFreq(); // 设置CPU频率

4. HBM电源管理

TEST_PWR_HBM_GetSysState(); // 获取HBM系统状态 TEST_PWR_HBM_SetAllPwrState(); // 设置HBM电源状态

🛠️ 常见问题排查

1. 编译失败

• 问题：缺少依赖包
• 解决：安装必要的开发工具包

sudo yum install gcc cmake make

2. 服务启动失败

• 问题：权限不足
• 解决：确保以root权限运行，或检查配置文件权限

3. 客户端连接失败

• 问题：服务未启动或套接字路径错误
• 解决：检查服务状态和pwrapis/conf/pwrapis_config.ini中的sock_file配置

4. 功能测试失败

• 问题：硬件不支持某些功能
• 解决：查看系统日志，确认硬件兼容性

📊 监控与维护

服务状态检查

systemctl status pwrapis

查看服务日志

journalctl -u pwrapis -f

配置文件位置

• 服务配置：pwrapis/conf/pwrapis_config.ini
• 服务文件：pwrapis/pwrapis.service
• 客户端头文件：pwrapic/inc/powerapi.h

🎉 总结与最佳实践

通过本文的完整指南，您已经掌握了PowerAPI的部署全流程。以下是几个最佳实践建议：

1. 生产环境部署：使用./build.sh release模式编译，获得最优性能
2. 权限管理：合理配置[client]段的admin和observer用户
3. 日志管理：根据需求调整日志级别和文件大小
4. 定期更新：关注项目更新，及时获取新功能和修复

PowerAPI为openEuler系统提供了强大的电源管理能力，无论是服务器能效优化还是移动设备功耗控制，都能发挥重要作用。现在就开始您的电源管理之旅吧！

💡小贴士：建议先在测试环境中验证所有功能，再部署到生产环境。完整的API文档和更多示例可以在项目文档中找到。

【免费下载链接】powerapiIncluding a power API SO and the Power API Service.项目地址: https://gitcode.com/openeuler/powerapi