OmniHSS 配置文件管理

概述

OmniHSS 使用 配置文件 来定义订阅者的服务特性。配置文件允许您创建可重用的服务模板，这些模板可以分配给多个订阅者，从而简化配置并确保一致性。

配置文件类型

EPC 配置文件

EPC（演进分组核心）配置文件定义 LTE 订阅者的数据服务特性。

关键参数

参数	描述	典型值
`ue_ambr_dl_kbps`	下载速度限制	10,000 - 1,000,000 Kbps
`ue_ambr_ul_kbps`	上传速度限制	5,000 - 500,000 Kbps
`network_access_mode`	服务类型	"packet_only" 或 "packet_and_circuit"
`tracking_area_update_interval_seconds`	TAU 定时器	54 秒（典型）

创建 EPC 配置文件

curl -k -X POST https://hss.example.com:8443/api/epc/profile \
  -H "Content-Type: application/json" \
  -d '{
    "apn_profiles": [],
    "name": "Premium 100Mbps",
    "network_access_mode": "packet_only",
    "tracking_area_update_interval_seconds": 600,
    "ue_ambr_dl_kbps": 100000,
    "ue_ambr_ul_kbps": 50000
  }'

常见 EPC 配置文件模板

基础互联网:

下载: 10 Mbps (10,000 Kbps)
上传: 5 Mbps (5,000 Kbps)

标准:

下载: 50 Mbps (50,000 Kbps)
上传: 25 Mbps (25,000 Kbps)

高级:

下载: 100 Mbps (100,000 Kbps)
上传: 50 Mbps (50,000 Kbps)

无限制:

下载: 1 Gbps (1,000,000 Kbps)
上传: 500 Mbps (500,000 Kbps)

IMS 配置文件

IMS 配置文件定义语音服务特性，主要通过 IFC（初始过滤标准）模板实现。

IFC 模板

IFC 模板是定义 S-CSCF 呼叫路由规则的 XML 文档。

模板变量:

{{imsi}} - 订阅者 IMSI
{{msisdns}} - 电话号码列表
{{mcc}} - 本国代码
{{mnc}} - 本网络代码

创建 IMS 配置文件

curl -k -X POST https://hss.example.com:8443/api/ims/profile \
  -H "Content-Type: application/json" \
  -d '{
    "ims_profile": {
      "name": "Standard VoLTE",
      "ifc_template": "<InitialFilterCriteria>...</InitialFilterCriteria>"
    }
  }'

IFC 模板示例

<ServiceProfile>
  <PublicIdentity>
    <Identity>sip:{{imsi}}@ims.mnc{{mnc}}.mcc{{mcc}}.3gppnetwork.org</Identity>
  </PublicIdentity>
  <InitialFilterCriteria>
    <Priority>0</Priority>
    <TriggerPoint>
      <ConditionTypeCNF>0</ConditionTypeCNF>
      <SPT>
        <ConditionNegated>0</ConditionNegated>
        <Group>0</Group>
        <Method>INVITE</Method>
      </SPT>
    </TriggerPoint>
    <ApplicationServer>
      <ServerName>sip:as.ims.example.com</ServerName>
      <DefaultHandling>0</DefaultHandling>
    </ApplicationServer>
  </InitialFilterCriteria>
</ServiceProfile>

APN 配置文件

APN（接入点名称）配置文件定义数据连接的网络接入点。

APN 组件

APN 标识符

定义 APN 名称和 IP 协议支持。

常见 APN:

internet - 一般互联网接入
ims - IMS/VoLTE 信令
mms - 多媒体消息
vzwadmin - 运营商特定

IP 版本选项:

"ipv4": 仅 IPv4
"ipv6": 仅 IPv6
"ipv4v6": IPv4v6（双栈）
"ipv4_or_ipv6": IPv4 或 IPv6（网络选择）

APN QoS 配置文件

定义服务质量参数。

QCI（QoS 类标识符）值:

QCI	类型	用例	优先级
1	GBR	对话语音	最高
2	GBR	对话视频	高
4	GBR	视频流	高
5	非 GBR	IMS 信令	中
9	非 GBR	互联网（默认）	最低

创建完整 APN 配置

# 1. 创建 APN 标识符
APN_ID=$(curl -k -X POST https://hss.example.com:8443/api/apn/identifier \
  -H "Content-Type: application/json" \
  -d '{"apn": "internet", "ip_version": "ipv4v6"}' \
  | jq -r '.response.id')

# 2. 创建 APN QoS 配置文件
QOS_ID=$(curl -k -X POST https://hss.example.com:8443/api/apn/qos_profile \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Best Effort",
    "allocation_retention_priority": 8,
    "apn_ambr_dl_kbps": 50000,
    "apn_ambr_ul_kbps": 25000,
    "pre_emption_capability": false,
    "pre_emption_vulnerability": true,
    "qci": 9
  }' | jq -r '.response.id')

# 3. 创建 APN 配置文件
curl -k -X POST https://hss.example.com:8443/api/apn/profile \
  -H "Content-Type: application/json" \
  -d "{
    \"apn_identifier_id\": $APN_ID,
    \"apn_qos_profile_id\": $QOS_ID,
    \"name\": \"Internet APN\"
  }"

将 APN 分配给 EPC 配置文件

APN 通过 join_epc_profile_to_apn_profile 表与 EPC 配置文件关联。

将记录插入连接表，以将 APN 配置文件 ID 链接到 EPC 配置文件 ID。多个 APN 配置文件可以分配给一个 EPC 配置文件。

漫游配置文件

请参阅漫游控制指南中的详细文档。

配置文件分配

订阅者配置文件关系

将配置文件分配给订阅者

# 在创建订阅者时分配 EPC 和 IMS 配置文件
curl -k -X POST https://hss.example.com:8443/api/subscriber \
  -H "Content-Type: application/json" \
  -d '{
    "subscriber": {
      "imsi": "001001123456789",
      "key_set_id": 1,
      "epc_profile_id": 1,
      "ims_profile_id": 1,
      "roaming_profile_id": 1
    }
  }'

# 更新订阅者配置文件
curl -k -X PUT https://hss.example.com:8443/api/subscriber/1 \
  -H "Content-Type: application/json" \
  -d '{
    "subscriber": {
      "epc_profile_id": 2
    }
  }'

配置文件管理最佳实践

设计原则

创建标准配置文件 - 定义常见服务层级（基础��标准、高级）
重用配置文件 - 将相同配置文件分配给多个订阅者
记录变更 - 跟踪配置文件修改
生产前测试 - 首先验证配置文件与测试订阅者的兼容性

配置文件命名约定

[服务层级]-[速度]-[特性]

示例:
- "Basic-10Mbps-Internet"
- "Premium-100Mbps-VoLTE"
- "Enterprise-1Gbps-MultiAPN"

配置文件迁移

更改订阅者的配置文件时：

重要: 配置文件更改将在下次生效：

跟踪区域更新（TAU）
附加
IMS 注册（对于 IMS 配置文件更改）

故障排除配置文件问题

订阅者未获得预期速度:

检查分配的 EPC 配置文件 AMBR 值
检查 APN QoS 配置文件 AMBR 值
验证 MME/P-GW 是否正确执行 QoS
检查网络拥塞

IMS 注册失败:

验证是否分配了 IMS 配置文件
检查 IFC 模板 XML 的有效性
查看 S-CSCF 日志以��取 IFC 处理错误
确认 S-CSCF 选择配置

APN 不可用:

验证 APN 配置文件是否链接到 EPC 配置文件
检查 APN 标识符是否与网络请求匹配
查看 UE 的 PDN 连接请求

← 返回操作指南 | 下一步: 漫游控制 →

概述​

配置文件类型​

EPC 配置文件​

关键参数​

创建 EPC 配置文件​

常见 EPC 配置文件模板​

IMS 配置文件​

IFC 模板​

创建 IMS 配置文件​

IFC 模板示例​

APN 配置文件​

APN 组件​

APN 标识符​

APN QoS 配置文件​

创建完整 APN 配置​

将 APN 分配给 EPC 配置文件​

漫游配置文件​

配置文件分配​

订阅者配置文件关系​

将配置文件分配给订阅者​

配置文件管理最佳实践​

设计原则​

配置文件命名约定​

配置文件迁移​

故障排除配置文件问题​

概述