代码仓
中
更新时间: 2026/11/16
在AtomGit上查看源码

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-SEARCHSSDP 客户端发出的搜索请求方法,用于在局域网内发现设备
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
废弃状态正常可用

属性说明 ​

属性名类型访问权限写权限描述
NotifyEnabledbreadwriteSecurityMgmt主动通告(alive)使能开关;NotifyMulticastIntervalSeconds 为 0 时禁止使能
ProtocolEnabledbreadSecurityMgmt协议使能状态(响应 M-SEARCH 的开关),由 NSM 关联控制
Typesread-服务类型,作为通告报文 NT 字段
EthernetInterfacesread-当前使用的网口名
NotifyMulticastIntervalSecondsureadwriteSecurityMgmt通告周期(秒),取值范围 0~1800,默认 600
IPv4Addrsread-IPv4 多播地址,固定 239.255.255.250
NotifyIPv6Scopesread-IPv6 多播范围(Link/Site/Organization),需通过方法设置
IPv6Addrsread-IPv6 多播地址,随 Scope 变化(FF02::C/FF05::C/FF08::C)
Portqread-服务对外体现的端口(私有),默认 1900
ListenPortqread-本地监听端口(私有),由 NSM 分配
NotifyTTLureadwriteSecurityMgmt通告报文的 TTL/Hops,取值范围 1~255,默认 2
USNsreadwrite-(私有)设备唯一服务名,UUID 格式
ProductSNsreadwrite-(私有)产品序列号
ProductNamesreadwrite-(私有)产品名称
HttpsPortureadwrite-(私有)Redfish HTTPS 端口,影响 AL 报文是否携带端口
IpVersionsreadwrite-(私有)IP 版本(IPv4/IPv6/IPv4AndIPv6),决定启停 v4/v6 线程
EthernetInterfaceObjectasread-(私有)EthernetInterfaces 对象(BusName, ObjectPath)
ChassisTypeyread-(私有)机框类型
SoftwareTypeyread-(私有)软件类型
SoftwareNamesread-(私有)软件名称
ChassisSNsread-(私有)机框序列号(刀片)
MMChassisSNsread-(私有)机框序列号(MM 板)
LocationIdyread-(私有)槽位号
LocationTypesread-(私有)槽位类型
ChassisIDqreadwriteSecurityMgmt机框 ID,默认 65535(无效值,不上报)
ProductIduread-(私有)产品 ID

方法说明 ​

SetNotifyIPv6Scope(scope)

设置 IPv6 多播范围,同时更新 IPv6Addr 并重启服务。

参数名方向类型描述取值范围
context输入a{ss}调用上下文(含 UserName/Interface/ClentAddr 等)-
scope输入sIPv6 多播范围Link / Site / Organization
scope 取值对应 IPv6 多播地址
LinkFF02::C
SiteFF05::C
OrganizationFF08::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,调试前需先加载环境:

shell
# 加载会话总线环境(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 <服务> <路径> <接口> <属性>):

shell
# 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 <服务> <路径> <接口> <属性> <签名> <值>):

shell
# 使能/关闭主动通告(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 <服务> <路径> <接口> <方法> [签名+参数]):

shell
# 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)实现:

shell
# 查看微组件对象接口定义
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 格式(普通配置):

json
{
  "ConfigData": {
    "SSDPConfig": {
      "NotifyEnabled": {"Value": true, "Import": true},
      "Interval": {"Value": 600, "Import": true},
      "NotifyTTL": {"Value": 2, "Import": true}
    }
  }
}

装备定制化导入的 JSON 格式:

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 结构。

示例代码(属性校验钩子) ​

c
/* 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;
}

验证方法 ​

  1. 使用 busctl --user get-property bmc.kepler.ssdp /bmc/kepler/Managers/1/Ssdp/0 bmc.kepler.Managers.SsdpConfig <属性> 验证属性读取。
  2. 使用 busctl --user set-property ...(或通过微组件 Import)修改配置,观察属性值、/var/log/app.log 中的操作日志与多播报文。
  3. 预期结果:合法值设置成功并触发服务重启日志,非法值返回错误码。

注意事项 ​

  • 修改 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.logssdp 组件运行日志(服务名标记为 SSDP,通过 mdb_log_set_name("SSDP") 设置)
/var/log/framework.log组件框架/生命周期相关日志
/var/log/secboxsecbox 沙箱运行日志(沙箱启动/降权/能力等)

4.2 关键日志信息 ​

日志片段日志级别含义解读建议处理动作
Restart service because %s changed to %u, object: %sINFO某属性变更导致 SSDP 服务重启正常行为,可结合属性名确认触发源
Set ssdp notify multicast interval to (%u) failedWARN通告周期设置失败(超出 0~1800 范围)检查入参是否合法
Add ipv4table failed, ret: %dWARN添加 IPv4 iptables 规则失败检查 bmc.kepler.Managers.EthernetInterfaces 服务状态
Add ipv6table failed, ret: %dWARN添加 IPv6 ip6tables 规则失败检查 bmc.kepler.Managers.EthernetInterfaces 服务状态
Call method Register failed, message: %sERROR向 NSM 注册 UDP 服务失败检查 bmc.kepler.nsm 服务是否正常
scope value invalid: %s, can be: %s, %s, %sWARNSetNotifyIPv6Scope 传入非法 scope检查 scope 入参
Get ssdp listen port %uNOTICE成功获取 NSM 分配的监听端口正常行为
recvfrom(udp) LEN:%dERROR收到长度过短的 UDP 报文可忽略,多为噪声报文
mkdir /data/persistence/ssdp failedWARN持久化目录创建失败检查文件系统/权限
subscribe dbus signal for EthGroup PropertiesChanged successfullyNOTICE成功订阅 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 时不允许使能 notifyNotifyMulticastIntervalSeconds 为 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 请求、响应报文等)。

复现问题方法 ​

  1. 前置条件设置:设备接入局域网,ssdp 服务运行正常(busctl --user tree bmc.kepler.ssdp 可见对象)。
  2. 操作步骤:使用 SSDP 客户端工具(如 smartkit 或 Python 脚本)向多播地址 239.255.255.250:1900 发送 M-SEARCH 请求(ST: ssdp:all、MX: 3、MAN: "ssdp:discover")。
  3. 预期现象:组件返回 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.02026-11-01openUBMC 社区初始版本创建