ssdp(Simple Service Discovery Protocol)
- ssdp协议及bmc.kepler.Managers/SSDPConfig接口实现。
- 通过ssdp协议,设备可以自动发现和加入网络中的其他设备,以便彼此之间进行通信和共享资源。
1 组件概述
1.1 组件简介
ssdp 组件是运行在 openUBMC 管理面(会话总线 user bus,服务名 bmc.kepler.ssdp)上的一个 C 语言应用组件,实现 Simple Service Discovery Protocol(SSDP,简单服务发现协议)。
组件以 D-Bus 会话总线的方式对外提供服务,通过 SSDP 协议周期性向局域网内多播 ssdp:alive 通告,并对网络中的 M-SEARCH 搜索请求进行响应,使上层管理软件(如 smartkit、Redfish 客户端等)能够自动发现并访问本机设备,进而实现设备的即插即用与自动组网。
1.2 解决什么问题
在没有 SSDP 能力时,上层管理软件需要通过手动配置 IP 才能访问目标设备,多设备、多网口场景下发现与管理成本高。
ssdp 组件解决了以下问题:
- 设备自动发现:管理软件向局域网发送 M-SEARCH 搜索请求,本机 SSDP 服务自动响应,返回设备访问地址(AL 头,指向 Redfish 入口),免去手工录入 IP。
- 主动在线通告:组件按配置周期向多播地址主动发送
ssdp:alive通告,管理软件可持续感知设备在线状态,实现自动上线/下线感知。 - IPv4/IPv6 双栈支持:默认 IPv4 多播地址
239.255.255.250:1900,IPv6 多播地址随 Scope 配置动态变化(Link/Site/Organization)。
1.3 核心功能
- 核心功能一:M-SEARCH 响应(responder)。监听 IPv4/IPv6 多播端口,对合法的 M-SEARCH 搜索请求(
ST: ssdp:all/ST: upnp:rootdevice)返回HTTP/1.1 200 OK响应,响应报文中携带设备地址(AL)、USN、产品信息等。 - 核心功能二:ssdp:alive 主动通告(notify)。按
NotifyMulticastIntervalSeconds周期向多播地址发送NOTIFY * HTTP/1.1通告报文,使管理软件持续感知设备在线。服务启动后前 5 次(约 300 秒)强制每 60 秒发送一次,不受使能开关控制。 - 核心功能三:网络协议注册与端口管理。通过
bmc.kepler.Managers.NetworkProtocol.Register接口向 NSM 注册 UDP 服务(服务名SSDP,默认端口 1900),注册成功后将 NSM 分配的监听端口写入ListenPort属性,并向bmc.kepler.Managers.EthernetInterfaces注册 iptables/ip6tables 规则放通多播流量。 - 核心功能四:配置管理与装备定制化。通过微组件接口
bmc.kepler.MicroComponent.ConfigManage(Import/Export/Recover)支持配置导入导出与装备定制化导入导出,配置项持久化到/data/persistence/ssdp/per.db。
1.4 关键术语表
| 术语 | 解释 |
|---|---|
| M-SEARCH | SSDP 客户端发出的搜索请求方法,用于在局域网内发现设备 |
| ssdp:alive / ssdp:byebye | 设备上线/下线通告,NTS(通知子类型)字段标识 |
| ST(Search Target) | 搜索目标,本组件仅响应 ssdp:all 与 upnp:rootdevice |
| MX(Maximum Wait) | M-SEARCH 请求中允许的最大响应延时(秒),非正数时忽略请求 |
| USN(Unique Service Name) | 设备唯一服务名,格式 uuid:<UUID>::urn:dmtf-org:service:redfish-rest:1 |
| AL(Alternate Location) | 设备访问地址,指向 https://<ip>[:<port>]/redfish/v1/ |
| Notify | 主动上送的通告报文(NOTIFY 方法) |
| responder / alive 线程 | SSDP 的响应线程与主动通告线程 |
1.5 外部交互边界图
组件与外部系统的交互:
- bmc.kepler.nsm(NetworkProtocol):通过
Register方法注册 UDP 服务,获取由 NSM 分配的实际监听端口(写入ListenPort)。 - bmc.kepler.Managers.EthernetInterfaces:调用
AddIptablesRule/AddIp6tablesRule放通多播地址的防火墙规则。 - bmc.kepler.bmc_network:订阅
bmc.kepler.Managers.EthernetInterfaces.EthGroup对象的属性变更(ActiveInterfaceName/Status),网口变更时重启 SSDP 服务。 - 属性代理:通过
PropertyProxy/ObjectProxy从bmc.kepler.Assembly(UUID)、bmc.kepler.Systems.FruData(产品序列号/名称/机框SN)、bmc.kepler.Managers.BMC(软件类型/名称)、bmc.kepler.Managers.NodeLocation(槽位号)、bmc.kepler.Chassis(机框类型)、bmc.kepler.Systems.Product(ProductId)等远端对象获取属性。 - 微组件:
bmc.kepler.MicroComponent.ConfigManage提供配置导入导出/恢复能力。
2 API 使用说明与示例
2.1 bmc.kepler.Managers.SsdpConfig(资源树接口)
功能说明
bmc.kepler.Managers.SsdpConfig 是组件暴露在资源树上的主接口,对象路径为 /bmc/kepler/Managers/1/Ssdp/0。通过该接口可以读取/修改 SSDP 服务的运行配置(使能开关、通告周期、TTL、IP 版本、多播地址等),并调用方法设置 IPv6 多播范围。
| 属性 | 内容 |
|---|---|
| 接口名 | bmc.kepler.Managers.SsdpConfig |
| 废弃状态 | 正常可用 |
属性说明
| 属性名 | 类型 | 访问权限 | 写权限 | 描述 |
|---|---|---|---|---|
| NotifyEnabled | b | readwrite | SecurityMgmt | 主动通告(alive)使能开关;NotifyMulticastIntervalSeconds 为 0 时禁止使能 |
| ProtocolEnabled | b | read | SecurityMgmt | 协议使能状态(响应 M-SEARCH 的开关),由 NSM 关联控制 |
| Type | s | read | - | 服务类型,作为通告报文 NT 字段 |
| EthernetInterface | s | read | - | 当前使用的网口名 |
| NotifyMulticastIntervalSeconds | u | readwrite | SecurityMgmt | 通告周期(秒),取值范围 0~1800,默认 600 |
| IPv4Addr | s | read | - | IPv4 多播地址,固定 239.255.255.250 |
| NotifyIPv6Scope | s | read | - | IPv6 多播范围(Link/Site/Organization),需通过方法设置 |
| IPv6Addr | s | read | - | IPv6 多播地址,随 Scope 变化(FF02::C/FF05::C/FF08::C) |
| Port | q | read | - | 服务对外体现的端口(私有),默认 1900 |
| ListenPort | q | read | - | 本地监听端口(私有),由 NSM 分配 |
| NotifyTTL | u | readwrite | SecurityMgmt | 通告报文的 TTL/Hops,取值范围 1~255,默认 2 |
| USN | s | readwrite | -(私有) | 设备唯一服务名,UUID 格式 |
| ProductSN | s | readwrite | -(私有) | 产品序列号 |
| ProductName | s | readwrite | -(私有) | 产品名称 |
| HttpsPort | u | readwrite | -(私有) | Redfish HTTPS 端口,影响 AL 报文是否携带端口 |
| IpVersion | s | readwrite | -(私有) | IP 版本(IPv4/IPv6/IPv4AndIPv6),决定启停 v4/v6 线程 |
| EthernetInterfaceObject | as | read | -(私有) | EthernetInterfaces 对象(BusName, ObjectPath) |
| ChassisType | y | read | -(私有) | 机框类型 |
| SoftwareType | y | read | -(私有) | 软件类型 |
| SoftwareName | s | read | -(私有) | 软件名称 |
| ChassisSN | s | read | -(私有) | 机框序列号(刀片) |
| MMChassisSN | s | read | -(私有) | 机框序列号(MM 板) |
| LocationId | y | read | -(私有) | 槽位号 |
| LocationType | s | read | -(私有) | 槽位类型 |
| ChassisID | q | readwrite | SecurityMgmt | 机框 ID,默认 65535(无效值,不上报) |
| ProductId | u | read | -(私有) | 产品 ID |
方法说明
SetNotifyIPv6Scope(scope)
设置 IPv6 多播范围,同时更新 IPv6Addr 并重启服务。
| 参数名 | 方向 | 类型 | 描述 | 取值范围 |
|---|---|---|---|---|
| context | 输入 | a{ss} | 调用上下文(含 UserName/Interface/ClentAddr 等) | - |
| scope | 输入 | s | IPv6 多播范围 | Link / Site / Organization |
| scope 取值 | 对应 IPv6 多播地址 |
|---|---|
| Link | FF02::C |
| Site | FF05::C |
| Organization | FF08::C |
返回值与异常
| 返回值 | 含义 | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | 成功 | 合法 scope 值设置成功 | 无 |
| -1 | 失败 | scope 非法;或 NotifyEnabled 使能时 NotifyMulticastIntervalSeconds 为 0 | 检查参数合法性 |
应用场景
- 管理软件在设备发现阶段向多播地址发送 M-SEARCH,组件 responder 线程响应并返回设备地址。
- 上层(Redfish/web)修改 SSDP 配置(使能、周期、TTL),使设备在指定网络范围内可被自动发现。
- 多网口/双平面组网(TCE 等)下切换网口后,组件自动重启服务并重新加入多播组。
限制条件
NotifyMulticastIntervalSeconds取值范围 0~1800,超过 1800 设置失败;对象初始化时若配置值超范围或为 0,会强制恢复为 600。NotifyMulticastIntervalSeconds设置为 0 表示关闭 notify 功能,同时会将NotifyEnabled置为 false;设置为非 0 时置为 true。NotifyMulticastIntervalSeconds为 0 时,不允许将NotifyEnabled设置为 true,否则返回错误码kepler.MulticastIntervalIsZeroSecond。NotifyTTL取值范围 1~255,其余值设置失败。SetNotifyIPv6Scope需要 SecurityMgmt 权限;scope 非法值返回失败。IPv4Addr、IPv6Addr、EthernetInterface、ProtocolEnabled等属性为只读,直接写会失败。- M-SEARCH 响应仅处理源端口大于 1024 且不等于 1900 的合法请求,且
MAN必须为"ssdp:discover"、MX必须为正数。 - 单板上最多可起 8 个 SSDP 服务(SSDP_NUM_MAX=8)。
调试示例
命令行调试
SSDP 服务运行在会话总线(user bus)上,环境文件为 /dev/shm/dbus/.dbus,调试前需先加载环境:
# 加载会话总线环境(systemd 已通过 EnvironmentFile 自动加载)
. /dev/shm/dbus/.dbus
export DBUS_SESSION_BUS_ADDRESS
# 查看资源树(服务名 bmc.kepler.ssdp)
busctl --user tree bmc.kepler.ssdp
# 查看主对象的完整接口定义
busctl --user introspect bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0
# 查看主接口属性定义
busctl --user introspect bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig读取属性(get-property <服务> <路径> <接口> <属性>):
# NotifyEnabled 为布尔类型 b
busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig NotifyEnabled
# 通告周期为 uint32 类型 u
busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig NotifyMulticastIntervalSeconds
# TTL 为 uint32 类型 u
busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig NotifyTTL
# IPv6 多播范围/地址
busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig NotifyIPv6Scope
busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig IPv6Addr
# 只读属性:IPv4Addr / EthernetInterface / ChassisID
busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig IPv4Addr
busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig EthernetInterface
busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig ChassisID设置属性(需 SecurityMgmt 权限;set-property <服务> <路径> <接口> <属性> <签名> <值>):
# 使能/关闭主动通告(b 类型)
busctl --user set-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig NotifyEnabled b true
# 设置通告周期 600 秒(u 类型,0~1800)
busctl --user set-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig NotifyMulticastIntervalSeconds u 600
# 设置 TTL 2(u 类型,1~255)
busctl --user set-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig NotifyTTL u 2
# 设置机框 ID(q 类型,uint16)
busctl --user set-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig ChassisID q 1调用方法(call <服务> <路径> <接口> <方法> [签名+参数]):
# SetNotifyIPv6Scope(context a{ss}, scope s)
# 合法 scope:Link / Site / Organization,对应 FF02::C / FF05::C / FF08::C
busctl --user call bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig SetNotifyIPv6Scope "a{ss}s" 3 "UserName" "ut" "Interface" "busctl" "ClientAddr" "localhost" "Site"说明:
SetNotifyIPv6Scope方法带bmc.kepler.annotition.Privileges=SecurityMgmt注解,需要安全管理权限的会话才能调用。- 若当前 shell 环境变量中没有
DBUS_SESSION_BUS_ADDRESS,可先执行export $(cat /dev/shm/dbus/.dbus | tr -d ';')或使用busctl --user(user bus)。
微组件接口调试
配置导入导出/恢复通过微组件接口 bmc.kepler.MicroComponent.ConfigManage(对象 /bmc/kepler/ssdp/MicroComponent)实现:
# 查看微组件对象接口定义
busctl --user introspect bmc.kepler.ssdp /bmc/kepler/ssdp/MicroComponent
# 健康检查
busctl --user call bmc.kepler.ssdp /bmc/kepler/ssdp/MicroComponent bmc.kepler.MicroComponent HealthCheck a{ss} 0
# 配置导出(type 传 'configuration',返回 JSON 字符串)
busctl --user call bmc.kepler.ssdp /bmc/kepler/ssdp/MicroComponent bmc.kepler.MicroComponent.ConfigManage Export "a{ss}s" 3 "UserName" "ut" "Interface" "busctl" "ClientAddr" "localhost" "configuration"
# 装备定制导出(type 传 'custom')
busctl --user call bmc.kepler.ssdp /bmc/kepler/ssdp/MicroComponent bmc.kepler.MicroComponent.ConfigManage Export "a{ss}s" 3 "UserName" "ut" "Interface" "busctl" "ClientAddr" "localhost" "custom"说明:
Import(context a{ss}, config_data s, type s):type为custom时执行装备定制化导入,否则执行普通配置导入。Export(context a{ss}, type s):type为custom时导出装备定制化配置,否则导出普通配置。- 微组件接口的方法签名由 libmcc 依赖的
bmc.kepler.MicroComponent/bmc.kepler.MicroComponent.ConfigManage接口定义(组件内不包含该 XML,由依赖提供)。
配置导入的 JSON 格式(普通配置):
{
"ConfigData": {
"SSDPConfig": {
"NotifyEnabled": {"Value": true, "Import": true},
"Interval": {"Value": 600, "Import": true},
"NotifyTTL": {"Value": 2, "Import": true}
}
}
}装备定制化导入的 JSON 格式:
{
"ConfigData": {
"CustomSettings": {
"BMCSet_SSDPEnable": {"Value": true, "Import": true},
"BMCSet_SSDP_NOTIFY_INTERVAL": {"Value": 600, "Import": true}
}
}
}注:
Import字段为 false 时表示不导入该配置项;任一属性导入失败返回错误(错误信息为第一个出错的属性)。
3 组件扩展案例
3.1 扩展能力概述
组件提供以下扩展能力:
- 装备定制化(设备定制):通过微组件
Import/Export(type 为custom)对 SSDP 使能开关与通告周期进行装备级定制,实现不同机型/批次差异化配置下发。 - 配置导入导出(配置备份恢复):通过微组件
Import/Export(type 为configuration)对运行配置进行备份与批量下发。 - 属性代理定制(PropertyProxy/ObjectProxy):
EthernetInterface、ProductSN、ProductName、USN、HttpsPort、IpVersion、ChassisID等属性通过资源树代理对象从远端组件取值,可随资源树定制替换数据来源。
3.2 扩展点说明
- 微组件配置导入导出(
service/micro_component_service.c):ssdp_config_import/ssdp_config_export/ssdp_recover为扩展入口。 - 装备定制化(
src/customize_config.c):ssdp_customize_import/ssdp_customize_export处理CustomSettings下的BMCSet_SSDPEnable/BMCSet_SSDP_NOTIFY_INTERVAL配置项。 - 属性钩子(
src/ssdp.c):before_*_change/after_*_change钩子对属性赋值进行校验与联动(如 interval 为 0 关闭 notify、TTL 范围校验等)。
3.3 二次开发指导
步骤一:修改属性默认值
编辑 mds/base.xml 中 bmc.kepler.Managers.SsdpConfig 对象对应属性的 <value>,如默认通告周期、默认 TTL、默认 IPv6 Scope 等。修改后需重新生成代码并重新构建。
步骤二:新增/修改配置项
在 mds/bmc.kepler.ssdp.xml 中新增属性定义(需同时维护 mds/base.xml 默认值),并在 src/ssdp.c 中挂接属性钩子;或扩展 src/customize_config.c / service/micro_component_service.c 中的导入导出 JSON 结构。
示例代码(属性校验钩子)
/* src/ssdp.c:通告周期校验钩子,仅接受 0 <= interval <= 1800 */
static gint before_notify_interval_change(const CallerContext *ctx, MdbObject *object, const MdbProperty *prop,
GVariant *value, gpointer user_data, GError **error)
{
if (object == NULL) {
*error = mcc_error_failed("set ssdp notify interval failed, object is NULL");
return -1;
}
guint32 interval = g_variant_get_uint32(value);
if (interval > SSDP_MAX_INTERVAL) { /* SSDP_MAX_INTERVAL = 1800 */
*error = mcc_error_failed("set ssdp notify interval failed, only (0 <= interval <= 1800) can be acceptted");
return -1;
}
if (interval != 0) {
SsdpConfig_set_NotifyEnabled(object, TRUE);
}
return 0;
}验证方法
- 使用
busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig <属性>验证属性读取。 - 使用
busctl --user set-property ...(或通过微组件 Import)修改配置,观察属性值、/var/log/app.log中的操作日志与多播报文。 - 预期结果:合法值设置成功并触发服务重启日志,非法值返回错误码。
注意事项
- 修改
mds/*.xml后必须使用 xml_codegen 重新生成代码(参考 manifest/dev_tools 的 README),否则新增接口不生效。 - 属性默认值修改需同步更新
mds/base.xml与相关测试用例。 - 装备定制化与配置导入共用
ConfigData结构,但键名不同(定制化用CustomSettings+BMCSet_*,普通配置用SSDPConfig)。
4 日志说明
4.1 一键日志收集
执行系统一键日志收集时,会收集本组件输出到系统日志体系的日志(组件未单独输出独立日志文件,日志统一进入 /var/log/app.log / /var/log/framework.log):
| 文件路径 | 内容说明 |
|---|---|
| /var/log/app.log | ssdp 组件运行日志(服务名标记为 SSDP,通过 mdb_log_set_name("SSDP") 设置) |
| /var/log/framework.log | 组件框架/生命周期相关日志 |
| /var/log/secbox | secbox 沙箱运行日志(沙箱启动/降权/能力等) |
4.2 关键日志信息
| 日志片段 | 日志级别 | 含义解读 | 建议处理动作 |
|---|---|---|---|
| Restart service because %s changed to %u, object: %s | INFO | 某属性变更导致 SSDP 服务重启 | 正常行为,可结合属性名确认触发源 |
| Set ssdp notify multicast interval to (%u) failed | WARN | 通告周期设置失败(超出 0~1800 范围) | 检查入参是否合法 |
| Add ipv4table failed, ret: %d | WARN | 添加 IPv4 iptables 规则失败 | 检查 bmc.kepler.Managers.EthernetInterfaces 服务状态 |
| Add ipv6table failed, ret: %d | WARN | 添加 IPv6 ip6tables 规则失败 | 检查 bmc.kepler.Managers.EthernetInterfaces 服务状态 |
| Call method Register failed, message: %s | ERROR | 向 NSM 注册 UDP 服务失败 | 检查 bmc.kepler.nsm 服务是否正常 |
| scope value invalid: %s, can be: %s, %s, %s | WARN | SetNotifyIPv6Scope 传入非法 scope | 检查 scope 入参 |
| Get ssdp listen port %u | NOTICE | 成功获取 NSM 分配的监听端口 | 正常行为 |
| recvfrom(udp) LEN:%d | ERROR | 收到长度过短的 UDP 报文 | 可忽略,多为噪声报文 |
| mkdir /data/persistence/ssdp failed | WARN | 持久化目录创建失败 | 检查文件系统/权限 |
| subscribe dbus signal for EthGroup PropertiesChanged successfully | NOTICE | 成功订阅 EthGroup 属性变更信号 | 正常行为 |
5 问题定界指南
5.1 典型问题定界
| 现象描述 | 是否为本组件问题 | 判断依据 | 关键证据收集方法 |
|---|---|---|---|
| 管理软件无法通过 SSDP 发现设备 | 可能是 | 需排查:ssdp 服务是否启动、NotifyEnabled/ProtocolEnabled 状态、NSM 端口注册、iptables 规则、网口选择 | 查看 app.log 中 SSDP 相关日志、busctl --user introspect bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0、iptables -L |
| 设备被重复发现/多个地址上报 | 可能是 | 多网口场景下每网口上报一个地址属正常;异常重复需检查 EthGroup 网口枚举 | 查看 app.log 中枚举日志、ip addr 核对网口 |
| 修改配置后未生效 | 是(多为配置校验) | 配置值超范围(interval>1800、TTL 非 1~255)会被拒绝 | 查看 app.log 中 ... failed 日志与返回错误码 |
| 组件内存持续增长 | 是 | 组件存在内存泄露风险 | 收集组件内存监控与 app.log,查看是否有异常增长 |
| 无法连接 BMC 会话总线 | 否 | 属于系统/会话总线问题 | 检查 /dev/shm/dbus/.dbus 与总线状态 |
5.2 错误码速查表
| 错误码 | 含义 | 可能原因 | 排查建议 |
|---|---|---|---|
| kepler.MulticastIntervalIsZeroSecond | 通告周期为 0 时不允许使能 notify | NotifyMulticastIntervalSeconds 为 0 时设置 NotifyEnabled=true | 先将周期设置为非 0 值(1~1800),再使能 NotifyEnabled |
说明:该错误码定义于
src/ssdp_error.c,错误域为g-kepler-error-quark,name字段为MulticastIntervalIsZeroSecond。
5.3 调试方法
开启调试日志
组件日志级别由系统统一控制(默认 INFO)。如需更详细日志(DEBUG/MASS 级别),可通过修改系统日志配置提升日志级别;组件内部使用 log_debug/log_mass 打印报文内容(M-SEARCH 请求、响应报文等)。
复现问题方法
- 前置条件设置:设备接入局域网,ssdp 服务运行正常(
busctl --user tree bmc.kepler.ssdp可见对象)。 - 操作步骤:使用 SSDP 客户端工具(如 smartkit 或 Python 脚本)向多播地址
239.255.255.250:1900发送 M-SEARCH 请求(ST: ssdp:all、MX: 3、MAN: "ssdp:discover")。 - 预期现象:组件返回
HTTP/1.1 200 OK响应,响应中包含AL: https://<ip>:<port>/redfish/v1/、USN等字段。
6 常见问题解答
Q1:SSDP 服务无法启动
- 问题描述:
busctl --user tree bmc.kepler.ssdp看不到对象。 - 一句话答案:检查服务进程与 NSM 注册。
- 根因说明:ssdp 启动依赖
bmc.kepler.nsm的 NetworkProtocol 注册,NSM 不可用时注册流程会持续重试(最长等待 180 秒)。 - 解决方案:确认
bmc.kepler.nsm服务正常,查看 app.log 中Call method Register failed日志。
Q2:修改通告周期/使能后不生效
- 问题描述:设置
NotifyMulticastIntervalSeconds或NotifyEnabled后无变化。 - 一句话答案:检查入参范围与依赖关系。
- 根因说明:周期超过 1800 会被拒绝;周期为 0 时不允许使能 NotifyEnabled(报
MulticastIntervalIsZeroSecond)。 - 解决方案:设置合法值(1~1800),先恢复周期为非 0 再使能。
Q3:设备能被发现但访问地址不对
- 问题描述:管理软件拿到设备地址但无法访问 Redfish。
- 一句话答案:核对 AL 报文中的地址与端口。
- 根因说明:AL 使用本机网口地址与
HttpsPort;若 Redfish 端口为 443 则 AL 不携带端口。 - 解决方案:确认
HttpsPort与 Redfish 实际监听端口一致,确认网络可达。
Q4:IPv6 发现不到设备
- 问题描述:IPv6 场景下设备无法被 SSDP 发现。
- 一句话答案:检查 IPv6 多播范围与网口。
- 根因说明:IPv6 多播地址由
NotifyIPv6Scope决定(默认 Site=FF05::C),且需网口存在合法 IPv6 地址(非 EM 板仅使用 link-local)。 - 解决方案:通过
SetNotifyIPv6Scope调整范围,或检查网口 IPv6 地址配置。
Q5:组件内存占用过高被 systemd 限制
- 问题描述:进程被 systemd 杀掉或内存受限。
- 一句话答案:检查
MemoryMax与沙箱内存门限。 - 根因说明:systemd 配置
MemoryHigh=240M、MemoryMax=256M,secbox 配置mem_max=204800(KB)。 - 解决方案:定位内存增长点(参考 CHANGELOG 中内存修复项),必要时调整门限。
附录A 参考资料
附录B 修订记录
| 版本 | 日期 | 修订人 | 修订内容 |
|---|---|---|---|
| v1.0 | 2026-11-01 | openUBMC 社区 | 初始版本创建 |