OmniUDR
OmniUDR 实现了 Omnitouch 5G 核心的 统一数据存储 (UDR)。它通过基于服务的接口 (SBI) 向 UDM 和 PCF 暴露 Nudr_DataRepository 服务 (TS 29.504):结构化的订阅者、策略和上下文数据。
OmniUDR 不拥有订阅者数据。它是一个标准合规的 Nudr_DR 外观,位于 OmniHSS REST 配置后端 之上:每次数据存储读取在请求时被转换为一个或多个 OmniHSS REST 调用,HSS 响应在返回给消费者之前被映射到 3GPP Nudr 数据模型。OmniUDR 是唯一一个直接与 OmniHSS REST API 交互的 5G 核心网络功能。UDM(通过它,AUSF)通过调用 OmniUDR 访问订阅者数据,而不是直接调用 HSS。
由于 HSS 是记录系统,OmniUDR 几乎不持有持久状态。它唯一的本地状态是三个小的内存中 (ETS) 存储:AMF 和 SMF 注册上下文的缓存(用于决定上下文写入是创建还是更新)、持有活动 Nudr_DR subs-to-notify 订阅���数据变更订阅存储,以及持有 Nudr_DR application-data 家族(PFD、流量影响、BDT)的应用数据存储。这些都没有持久化;所有内容在重启时被清除。注册上下文缓存可以通过管理 API 刷新。
文档
- 操作指南 - 3GPP 角色、提供的数据集、SBI 端点,以及关键的读取/更新/上下文/策略程序和序列图。
- 配置参考 - 完整的运行时配置参考、HSS 后端设置、管理/OAM API 和日志记录。
- 指标 - 用于 NRF 注册、HSS 后端健康、请求计数/延迟和 BEAM VM 健康的 Prometheus 指标,以及示例 PromQL。
- 故障排除 - 常见问题及其解决方案。
架构概述
AUSF 并没有作为直接消费者出现:5G 认证数据流为 AUSF → UDM → OmniUDR → OmniHSS。OmniUDR 将 4G 风格的 HSS 订阅者记录(密钥材料、EPC/APN QoS 配置、PCRF 计费规则)动态映射到 5G Nudr 结构(认证订阅、接入与移动数据、会话管理数据、SMF 选择数据、策略数据)。
功能概述
- Nudr_DR 订阅数据:认证订阅读取和 SQN 更新 (PATCH),加上接入与移动、会话管理和 SMF 选择的配置数据 (GET),实时映射自 HSS 订阅者记录。
- Nudr_DR 上下文数据:AMF 3GPP 接入注册(镜像到 HSS 电路会话/位置和本地缓存)和 SMF 注册(仅本地 ETS 缓存),每个返回 201/204 以区分创建与更新。
- Nudr_DR 策略数据:AM 策略数据(粗略的
subscCats)和 SM 策略数据(每个 S-NSSAI/DNN 的smPolicySnssaiData),源自 HSS EPC/PCRF 配置,供 PCF 使用。 - Nudr_DR 数据变更订阅:消费者注册
subs-to-notify订阅,命名被监控的资源 URI 和通知回��� URI,存储在内存中的订阅存储中;当被监控的数据发生变化时,OmniUDR 向订阅者发出 DataChangeNotify 通知(添加/替换/移除)(根据 TS 29.504 的通知订阅)。 - Nudr_DR 应用数据:针对
application-data家族(pfds、influenceData、bdtData)的通用 CRUD(获取集合/获取/放置/删除),由本地内存 (ETS) 存储支持;不由 HSS 支持,并且在重启时不持久化。 - 专有认证向量生成:一个非标准的
authentication-vectorsPOST,将 Milenage 向量生成和 SQN/重同步处理委托给 HSS,仅由 OmniUDM 消费。 - HSS 支持的无状态性:没有本地订阅者存储;读取可用性和延迟直接跟踪 HSS,通过健康指标和每个端点请求指标呈现。
- NRF 集成:自动注册和定期心跳,提供 OAM API 以进行实时配置更改、强制重新注册和上下文缓存刷新。
快速开始
主要操作设置是 OmniHSS REST 后端 URL。最小部署绑定 SBI 监听器并将 OmniUDR 指向其 NRF 和 HSS:
config :omniudr,
hss_api_base_url: "https://hss.example.net:8443",
sbi_scheme: "http",
sbi_addr: "127.0.0.22",
sbi_port: 7777,
nrf_uri: "http://127.0.0.1:7777",
mcc: "999",
mnc: "70"
完整的参数集 - 包括 PLMN 身份、指标/���跳调优、切片映射覆盖和实验测试订阅者辅助 - 在 配置参考 中有详细记录。