redfish获取BIOS设置可设置项Attributes为空

huaqi_hongyiqin · 2026 年5 月 13 日 05:53

问题描述：

使用redfish接口获取bios设置可配置项Attributes为空

“@odata.context”: “/redfish/v1/$metadata#Bios.Bios”,

"@odata.id": "/redfish/v1/Systems/1/Bios/Settings",

"@odata.type": "#Bios.v1_0_0.Bios",

"Id": "Settings",

"Name": "BIOS Configuration Pending Settings",

"AttributeRegistry": "BiosAttributeRegistry.2.6.2",

**"Attributes": null,**

"Actions": {

    "Oem": {

        "openUBMC": {

            "#Settings.Revoke": {

                "target": "/redfish/v1/Systems/1/Bios/Settings/Actions/Oem/openUBMC/Settings.Revoke"

            }

        }

    }

},

"Oem": {

    "openUBMC": {

        "EffectiveStatus": "Effective"

    }

}

初步分析：

通过busctl --user introspect bmc.kepler.bios /bmc/kepler/Systems/1/Bios bmc.kepler.Systems.Bios命令知道了Attributes配置是从文件/data/opt/setting.json获取的

.ResultFileName property s “/data/opt/result.json” emits-change
.SettingFileName property s “/data/opt/setting.json” emits-change

读取该文件/data/opt/setting.json内容为空

~ # cd /data/opt/
/data/opt # ls
SMBIOS_CONF bmc currentvalue.json pme registry.json result.json setting.json third_party
/data/opt # cat setting.json
/data/opt #

[问题求助]

/data/opt/setting.json什么情况下会为空？这个文件的内容是从什么地方获取到的？文件内容是否有个参数EquipmentModeFlag表示设置设备bios进入装备模式？

ubmc_assistant · 2026 年5 月 13 日 05:57

答案内容由AI生成，仅供参考：

总结

项目	说明
`Attributes` 为空原因	`/data/opt/setting.json` 文件内容为空，通常是因未导入过 BIOS 配置所致
文件数据来源	通过 Redfish `ImportBiosSetup` 或 Web UI 手动导入配置生成
是否应为空	不应为空；首次运行后应有默认或用户导入的配置
`EquipmentModeFlag` 存在性	无此字段；类似功能通过定制化包或配置文件实现
解决建议	执行一次合法的 BIOS 配置导入操作，确保 `setting.json` 被正确写入

推荐操作：使用标准 BIOS Registry 配置文件，通过 Redfish 接口执行一次 ImportBiosSetup，即可修复 Attributes 为空的问题。

点击此处查看详细分析解答

Redfish 获取 BIOS 设置可设置项 `Attributes` 为空问题分析

问题描述

通过 Redfish 接口 /redfish/v1/Systems/1/Bios/Settings 获取 BIOS 配置时，返回的 Attributes 字段为空（null），具体响应如下：

{
  "@odata.context": "/redfish/v1/$metadata#Bios.Bios",
  "@odata.id": "/redfish/v1/Systems/1/Bios/Settings",
  "@odata.type": "#Bios.v1_0_0.Bios",
  "Id": "Settings",
  "Name": "BIOS Configuration Pending Settings",
  "AttributeRegistry": "BiosAttributeRegistry.2.6.2",
  "Attributes": null,
  "Actions": { ... },
  "Oem": { ... }
}

根本原因分析

1. `Attributes` 字段来源

根据系统内部机制：

BIOS 的 Attributes 配置数据来源于文件 /data/opt/setting.json。
该文件由 Redfish 或 Web UI 等北向接口在导入 BIOS 配置时写入。
D-Bus 接口 bmc.kepler.Systems.Bios 中的属性 SettingFileName 明确指向此文件路径：
```
SettingFileName            property  s         "/data/opt/setting.json"      emits-change
```

2. `setting.json` 文件内容为空的原因

/data/opt/setting.json 内容为空，可能由以下几种情况导致：

（1）未进行过任何 BIOS 配置导入操作

正常流程：用户需通过 Redfish 的 ImportBiosSetup 接口或 Web UI 手动上传并导入 BIOS 配置文件。
现状：若从未执行过导入操作，则 setting.json 将保持为空或仅包含初始空对象 {}。

（2）配置导入失败或中断

导入过程中发生异常（如网络中断、权限不足、JSON 格式错误）可能导致文件写入失败或被清空。
若导入的配置不符合 BiosAttributeRegistry 定义的校验规则（如类型、范围不匹配），系统会拒绝写入并可能重置文件。

（3）系统启动初期或升级后未初始化

在 BMC 初次启动或 BIOS 固件升级后，若尚未完成完整的配置加载流程，setting.json 可能尚未生成或为空。
有日志显示系统在启动过程中会异步获取组件版本信息（start async fetch component version info），此过程可能影响配置文件的加载时机。

（4）文件被意外删除或清空

手动操作、脚本错误或系统异常可能导致该文件被覆盖或删除。

`setting.json` 文件的数据来源与生成机制

数据来源

setting.json 文件的内容来源于以下两种方式之一：

方式一：通过 Redfish 接口导入

使用 ImportBiosSetup 方法上传配置文件：

POST /redfish/v1/Systems/1/Bios/Actions/Bios.ImportBiosSetup
{
  "FileType": "Setting",
  "Content": "{...}"
}

该操作会将传入的 JSON 内容写入到 /data/opt/setting.json。
系统会依据 BiosAttributeRegistry.vX_X_X.json 文件进行合法性校验。

方式二：通过 Web UI 或 CLI 导入配置

用户在 Web 界面中修改 BIOS 设置后点击“保存配置”，后台将调用 ImportBiosSetup 实现持久化。
CLI 命令也可能封装相关接口实现批量配置导入。

关于 `EquipmentModeFlag` 参数说明

是否存在 `EquipmentModeFlag`？

从现有知识库和文档中未发现名为 EquipmentModeFlag 的标准 BIOS 属性或字段。但存在以下相关概念：

BIOS 配置中的“模式”控制

存在以下 D-Bus 方法可用于控制配置生效逻辑：

method: SetBiosConfigActiveMode(Mode)
  Mode: 0 -> 导入待生效配置，重启后生效
        1 -> 恢复默认配置 + 导入新配置

结论：虽然没有直接名为 EquipmentModeFlag 的字段，但系统具备通过定制化配置文件或特定导入策略实现“装备模式”的能力。若需要控制 BIOS 进入某种特殊模式，建议通过导入包含预定义配置的 setting.json 文件实现。

解决方案与建议

1. 检查并确认 `setting.json` 状态

# 查看文件是否存在且非空
cat /data/opt/setting.json

# 若为空，检查 currentvalue.json（当前生效配置）
cat /data/opt/currentvalue.json

2. 手动导入默认 BIOS 配置

通过 Redfish 接口或 Web UI 导入一套标准 BIOS 配置：

POST /redfish/v1/Systems/1/Bios/Actions/Bios.ImportBiosSetup
{
  "FileType": "Setting",
  "Content": "{\"ProcHyperthreading\": \"Enabled\", \"MemPatrolScrub\": \"Auto\"}"
}

此操作将填充 setting.json，后续访问 Attributes 即可返回有效值。

3. 验证 `BiosAttributeRegistry` 文件完整性

确保注册表文件存在且格式正确：

# 示例路径，实际可能为：
ls /usr/share/RedfishRegistryStore/en/BiosAttributeRegistry.2.6.2.json

# 或通过 Redfish 获取
GET /redfish/v1/RegistryStore/AttributeRegistries/en/BiosAttributeRegistry.2.6.2.json

4. 检查 BMC 启动状态与服务健康

确保 bmc.kepler.bios 服务已完全启动。
查看日志是否有 BIOS 服务初始化失败记录：
```
journalctl -u bmc-kepler-bios
```
日志中出现 start async fetch component version info 表明正在进行初始化，此时配置可能尚未加载。

5. 系统重启或重载 BIOS 服务（可选）

若上述无效，尝试重启服务或整个 BMC：

systemctl restart bmc-kepler-bios

总结

项目	说明
`Attributes` 为空原因	`/data/opt/setting.json` 文件内容为空，通常是因未导入过 BIOS 配置所致
文件数据来源	通过 Redfish `ImportBiosSetup` 或 Web UI 手动导入配置生成
是否应为空	不应为空；首次运行后应有默认或用户导入的配置
`EquipmentModeFlag` 存在性	无此字段；类似功能通过定制化包或配置文件实现
解决建议	执行一次合法的 BIOS 配置导入操作，确保 `setting.json` 被正确写入