已开启
[需求]: 支持BMC主从的SSU模组带外管理 #446
changdexing创建于 7月21日
openUBMC-robot
7月21日 评论：
7月21日 评论：
7月21日 将 WeberChen 设为负责人
7月21日 添加了label：sig/sig-component-drivers
openUBMC-robot
7月21日 评论：
7月21日 评论：
欢迎来到 openUBMC 社区
Hey @changxingOpenUBMC , 感谢你对社区的贡献.
机器人使用手册
有关指令的使用，可以点击 说明文档 或 论坛 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。
联系指引
有疑问可以联系 SIG: sig-component-drivers ,
维护者是： @dongyushan, @net_swift_wangchen, @sam_h1973, @u012924942, @weixin_37569011, @xiaoxinglxs ,
优秀贡献者是： @changxingOpenUBMC, @chenshengfan, @leessential, @net_swift_tianwen, @xiapengc1, @yelvsub .
7月21日 关联了看板：openUBMC 26.09 需求看板
7月21日 修改了issue 的描述
openUBMC-robot
7月21日 评论：
7月21日 评论：
Issue 工作流介绍
社区的需求和缺陷的工作流状态处于纳管中。
| 类型 | 上个状态 | 下个状态 | 评论命令 | 谁可以操作 |
|---|---|---|---|---|
| 需求 | 待办的 | 已接纳 | /todo2accepted | SIG组: sig-release-management (maintainer) |
| 需求 | 已接纳 | 开发中 | /accepted2developing | 仓库成员角色: Maintainer, Committer, Contributor, Owner |
| 需求 | 开发中 | 转测中 | /developing2testing | 仓库成员角色: Maintainer, Committer, Contributor, Owner |
| 需求 | 转测中 | 待验收 | /testing2UAT | 仓库成员角色: Maintainer, Committer, Contributor, Owner |
| 需求 | 待验收 | 已完成 | /UAT2done | SIG组: sig-QA (maintainer,committer) |
| 需求 | 待办的 | 已挂起 | /todo2suspended | SIG组: sig-release-management (maintainer) |
| 需求 | 已挂起 | 已接纳 | /suspended2accepted | SIG组: sig-release-management (maintainer) |
| 需求 | 待办的 | 已拒绝 | /todo2rejected | SIG组: sig-release-management (maintainer) |
| 需求 | 已拒绝 | 已接纳 | /rejected2accepted | SIG组: sig-release-management (maintainer) |
7月25日 issue状态由 待办的 改变为 已接纳
chenkuilin
8月20日 评论：
8月20日 评论：
/accepted2developing
8月20日 issue状态由 已接纳 改变为 开发中
27 天前 关联了pull request：docs: 新增SSU模组主从管理详细设计说明书
26 天前 关联了pull request：fix: SSU主从开关按system_id各查询一遍并缓存至定位灯/健康灯业务对象
23 天前 关联了看板：openUBMC 26.12需求看板
23 天前 移除了看板：openUBMC 26.09 需求看板
16 天前 修改标题为 “[需求]: 支持BMC主从的SSU模组带外管理”，原标题为“[需求]: 支持BMC主从的ASU模组带外管理”
16 天前 修改了issue 的描述
16 天前 修改了issue 的描述
感谢您为社区贡献新需求！请按照以下提示提供详细信息，以便我们更好地理解并跟进。
版本分支
openUBMC main
需求属性
所属版本
openUBMC 26.09
工作量
NA
是否需要编码
是
是否免测试
否
周边依赖
NA
需求来源
NA
需求描述
简要说明
SSU模组带外管理支持BMC主从角色控制，通过CSR配置是否开启该功能。开启后，SSU模组带外访问需获取当前BMC的主从状态，仅主BMC允许执行SSU模组带外访问，从BMC不允许带外访问，仅创建SSU模组管理对象，保障主从BMC场景下SSU模组管理不冲突
系统用户
开发人员、测试人员、运维人员
前置条件
BMC运行正常
主成功场景
（1）BMC启动后加载CSR配置，读取BMC主从SSU模组带外管理功能开关；
（2）判断CSR是否配置该功能：
1、功能未开启：BMC不区分主从，直接执行SSU模组带外访问（兼容无主从场景）
2、功能开启：获取当前BMC的主从状态，根据主从状态执行SSU模组带外管理：
-主BMC：允许SSU模组带外访问、NVMe-MI通信通道建立、配置同步、状态监控、固件升级、告警管理等流程；
-从BMC：不允许SSU模组带外访问，仅创建SSU模组管理对象（SSUCard、UBPort、GEPort、SSUDrive对象存在但无带外数据交互），不主动访问SSU模组硬件；
（3）主BMC正常执行SSU模组带外管理全流程；
（4）监听BMC的主从状态，满足主从切换场景的带外访问控制；
扩展场景（含异常场景）
1、BMC主从状态获取失败默认按照从状态执行；
2、原主BMC切换为从BMC后，停止SSU模组带外访问，仅保留SSU模组管理对象；
3、原从BMC切换为主BMC后，恢复SSU模组带外访问，重新建立通信通道，执行配置同步和状态监控；
4、切换过程中SSU模组管理对象不丢失，记录切换日志；
约束
功能开启后，仅主BMC允许SSU模组带外访问，从BMC不允许SSU模组带外访问
非功能需求
（1）可靠性要求：主从切换过程中SSU模组管理对象始终存在，不丢失管理能力
（2）可维护性要求：主从SSU模组带外管理功能通过CSR配置开关，日志记录功能开关、主从状态及主从切换等关键信息；
（3）可测试性要求：1、CSR可配置主从功能开关；2、接口可查询主从状态；3、可模拟主从切换；
（4）性能要求：NA
（5）兼容性要求(和以前版本及周边配套)：CSR配置默认关闭BMC主从SSU模组带外管理功能；
（6）安全要求：NA
（7）韧性要求：NA