带内IPMI设置SOL波特率命令失败问题分析与解决方案

问题描述

在使用ipmitool通过带内方式设置SOL（Serial Over LAN）的非易失性波特率（non-volatile-bit-rate）时，命令执行失败，提示错误信息：

• Error setting SOL parameter 'non-volatile-bit-rate' to '115.2': Invalid command on LUN
• Error setting SOL parameter 'set-in-progress' to 'set-in-progress': Invalid data field in request

尽管参数值（如115.2、9.6）属于合法范围，但始终无法成功配置。

环境信息

• 操作系统：未知（通过localhost及shell提示符推测为类Linux系统）
• 软件版本：OpenUBMC 2509（基于日志内容推断）
• 硬件配置：未明确说明
• 通信方式：带内IPMI（In-band IPMI）

重现步骤

1. 执行 ipmitool sol set non-volatile-bit-rate 115.2 或带通道号的变体。
2. 系统返回错误：Invalid command on LUN 或 Invalid data field in request。
3. 尝试多种语法变体（带引号、加通道号等），均失败。

示例命令：

ipmitool sol set non-volatile-bit-rate 115.2
ipmitool sol set non-volatile-bit-rate 115.2 1
ipmitool sol set set-in-progress set-in-progress

错误分析

1. 错误码解析

根据知识库中文件 ipmi_fault_locating.md 的定义：

其中：

• Invalid data field in request 对应完成码 0xCC，表示参数格式或取值不合法。
• Invalid command on LUN 对应 0xCD，表示当前LUN（逻辑单元号）不支持该命令。

这表明 BMC 固件可能未正确注册或实现该 IPMI 命令在当前 LUN 上的处理逻辑。

2. 带内与带外执行差异

知识库指出：

带内和带外的重试机制不一样，带内只会重试两次。（来源：ipmi_fault_locating.md）

此外，带内 IPMI 请求由 ipmi_core 模块处理，而带外请求由 rmcpd 处理。二者对命令的支持程度可能存在差异。

结论：某些 SOL 配置命令（尤其是涉及持久化设置的）可能仅在带外模式下被完全支持，带内路径未完整透传或实现。

解决方案与建议

方案一：改用带外IPMI执行命令

SOL 相关配置通常应在带外管理模式下进行，因为 SOL 功能本身是远程管理的一部分。

操作建议：

# 使用LAN Plus接口通过带外通信
ipmitool -I lanplus -H <BMC_IP> -U <username> -P <password> \
         sol set non-volatile-bit-rate 115.2

提示：BMC默认IPMI端口为 623，协议为UDP。

方案二：检查IPMI命令是否注册并启用

查看 IPMI 命令定义文件

确认 /mds/IPMI.json 或类似路径中是否定义了 Set SOL Configuration Parameters 命令（NetFn: 0x30, Cmd: 0x11）。

示例结构（来自知识库）：

{
  "NetFn": "0x30",
  "Cmd": "0x11",
  "Privilege": "Admin",
  "Request": {
    "data": ["channel", "parameter_selector", "parameter_data"]
  }
}

验证命令权限

检查 ipmi.json 文件中相关命令的 privilege 字段是否设置为 Admin，且当前用户具备管理员权限。

方案三：手动设置串口方向与参数（适用于底层控制）

根据日志文件 serial_mgmt.lua 的内容，在 BMC 系统中可通过 Lua 脚本控制 UART 映射：

-- 示例：设置 UART5 连接到 Port5
Setting uart 5 interconnect with port 5

若硬件直连串口（如连接到 CPLD），需确保：

• CPLD 正确路由 SOL 到 BMC 或 Host CPU；
• 无跳线帽阻止串口切换（参考 SOL FAQ）；

方案四：使用专用CLI命令替代

部分平台提供专有命令设置SOL超时或波特率。

例如：

ipmcset -t sol -d timeout -v 30

虽然该命令不直接设置波特率，但说明存在专有配置接口。

查阅平台文档以确认是否提供类似：

ipmcset sol bitrate 115200

已尝试的无效方法总结

推荐排查流程

graph TD
    A[开始] --> B{是带内还是带外?}
    B -->|带内| C[切换为带外模式]
    B -->|带外| D[继续]
    C --> D
    D --> E[确认用户权限为Admin]
    E --> F[检查ipmi.json是否有NetFn=0x30,Cmd=0x11]
    F --> G[执行ipmitool -I lanplus ... sol set ...]
    G --> H{成功?}
    H -->|是| I[问题解决]
    H -->|否| J[检查rmcpd或ipmi_core日志]
    J --> K[确认CPLD串口路由是否正确]
    K --> L[联系开发确认命令实现]

参考资料摘要

1. SOL 是基于 IPMI 的远程串口功能，依赖于带外管理通道。
2. ipmitool 在带内环境下可能受限于 kernel 接口（如 /dev/ipmi0）的功能完整性。
3. 根据 IPMI/CLI SOL常见问题指南，SOL 连接失败常见于：
   • 用户权限不足（需 Administrator 权限）；
   • 串口方向未正确设置；
   • BMC 与 CPLD 之间路由异常。

最终建议

强烈建议使用带外IPMI方式设置SOL配置参数，包括波特率、权限等级、超时等。

# 推荐命令格式
ipmitool -I lanplus -H <BMC_IP> -U Administrator -P <password> \
         sol set non-volatile-bit-rate 115.2
ipmitool -I lanplus -H <BMC_IP> -U Administrator -P <password> \
         sol set volatile-bit-rate 115.2
ipmitool -I lanplus -H <BMC_IP> -U Administrator -P <password> \
         sol set privilege-level operator

成功标志：无报错输出，且下次激活 SOL 时自动应用新波特率。

如仍失败，请收集以下信息进行进一步分析：

• BMC 系统日志（特别是 ipmi_core 和 rmcpd 模块输出）；
• ipmi.json 文件中关于 NetFn: 0x30, Cmd: 0x11 的定义；
• 使用 ipmitool raw 0x30 0x10 查询当前 SOL 配置状态；
• 确认 Channel Access 是否允许 Administrator 修改 SOL 参数。

如有更多日志或配置文件，可进一步深入定位。

相关链接：

1. IPMI sol命令阻塞
2. 咨询1711 UBMC是否支持作为IPMB主设备
3. 串口波特率问题
4. qemu启动之后，ssh可以登入，但是web和ipmi无法访问
5. IPMI/CLI SOL常见问题指南 | 文档中心 | openUBMC