【已评审】IpmbEth 资源协作接口新增实例、活动平面及诊断信息查询能力

背景

IPMB over Ethernet 通道支持同一 IPMI 通道下配置多个实例,并支持在 SMM1、SMM2 两个通信平面之间进行活动端口选择。
本次在已有资源协作接口 bmc.kepler.Managers.IpmbEth 中新增 Instance、ActivePortId 两个属性用于区分 IPMBEth 实例、查询当前活动通信平面。

关联 ISSUE

暂无 ISSUE。

整体方案

  • 在已有资源路径 /bmc/kepler/Managers/${ManagerId}/IpmbEth/${Id} 上复用接口 bmc.kepler.Managers.IpmbEth,不新增资源路径和接口。
  • 新增属性 Instance,用于标识 IPMBEth 通道实例。
  • 新增属性 ActivePortId,由 IPMBEth 管理服务实时更新,用于表示当前活动通信平面:1 表示 SMM1 平面,2 表示 SMM2 平面。

评审点

  • 评审点1:在已有资源协作接口 bmc.kepler.Managers.IpmbEth 中新增属性 Instance、ActivePortId。

详细描述

评审点1:新增资源树协作接口属性

  • 场景:新增资源树协作接口属性,用于标识 IPMBEth 通道实例及承载当前活动通信平面。
  • path:/bmc/kepler/Managers/${ManagerId}/IpmbEth/${Id}(已有)
  • interface:bmc.kepler.Managers.IpmbEth(已有)
  • 变化类型:新增属性
  • 新增属性:
属性名称 签名 只读 变化通知 属性描述 访问权限 属性来源 持久化类型 易变属性
Instance y true false IPMBEth 通道实例号 ReadOnly CSR 无需持久化 false
ActivePortId y true true IPMBEth 当前活动通信平面,默认值为 1;1 表示 SMM1 平面,2 表示 SMM2 平面,仅取值 1 或 2 ReadOnly app实时更新 无需持久化 true

评审结论

已线下审视,同意在已有资源路径 /bmc/kepler/Managers/${ManagerId}/IpmbEth/${Id} 的资源协作接口 bmc.kepler.Managers.IpmbEth 中新增只读属性 Instance 和 ActivePortId,用于标识 IPMBEth 通道实例及对外呈现当前活动通信平面。

其中:

  • Instance 的类型为 U8,D-Bus 签名为 y,用于标识 IPMBEth 通道实例号。该属性来源于 CSR 配置,仅支持读取,访问权限为 ReadOnly,不发送属性变化通知,无需持久化,非易变属性。
  • ActivePortId 的类型为 U8,D-Bus 签名为 y,用于表示 IPMBEth 当前活动通信平面。默认值为 1,取值范围为 1 或 2:1 表示 SMM1 平面,2 表示 SMM2 平面,不定义 0 或其他取值。