OMC北向接口参数输出标准-统一网络资源模型文件格式

中国移动通信企业标准QB-XX-XXX-XXXX移动通信网网络管理技术规范OMC北向接口统一网络资源模型文件格式UnifiedFormatofNetworkResourceModelFiles版本号：1.0.0（报批稿）XXXX-XX-XX发布XXXX-XX-XX实施中国移动通信集团公司 发布QB-XX-XXX-XXXX目录TOC\o"1-5"\h\z目录 II前言 m\o"CurrentDocument"范围 1\o"CurrentDocument"规范性引用文件 1术语、定义和缩略语 1\o"CurrentDocument"网络资源模型文件格式综述 1网络资源模型的采集机制 2\o"CurrentDocument"网络资源模型文件格式 2网络资源模型文件格式 3文件总体结构 3文件头部分 3网络资源模型部分 4网络资源模型的组织 4\o"CurrentDocument"对补充网络资源模型的支持 5\o"CurrentDocument"数据类型的串化和还原 6\o"CurrentDocument"总体方案 6\o"CurrentDocument"标记的数据类型串化和还原 6\o"CurrentDocument"标记值保留字符 6\o"CurrentDocument"简单数据类型 6复杂数据类型 7标记属性的数据类型串化和还原 9NRM文件标记属性 9标记属性值保留字符 10\o"CurrentDocument"网络资源模型文件组织 10\o"CurrentDocument"综述 10\o"CurrentDocument"文件的命名 10文件的压缩 12文件的更新 12\o"CurrentDocument"编制历史 12\o"CurrentDocument"附录A 统一网络资源模型文件SCHEMA（规范性附录） 13\o"CurrentDocument"附录B 网络资源模型文件示例（资料性附录） 13II

QB-XX-XXX-XXXX-LX. —1—刖 言本标准用于规范移动通信网络设备的OMC北向接口的网络资源模型文件的格式，使来自不同厂商的OMC产生的网络资源模型文件格式一致。本标准约定OMC北向接口的网络资源模型使用XML文件承载，且规定XML文件的结构以及不同类型的网络资源模型在XML中的存储方案。本标准是“移动通信网网络管理技术规范OMC北向接口统一文件格式”系列标准之一，该系列标准的结构、名称或预计的名称如下:序号标准编号[1]QB-W-XXX-2012[2]QB-W-XXX-2012标准名称《移动通信网网络管理技术规范OMC北向接口统一网络资源模型文件格式》《移动通信网网络管理技术规范OMC北向接口统一性能测量数据文件格式》本标准的附录A为标准性附录，附录B为资料性附录。本标准由中移 号文件印发。本标准由中国移动通信集团网络部提出，集团公司技术部归口。本标准起草单位：中国移动通信集团公司网络部本标准主要起草人：李健iiiQB-XX-XXX-XXXX范围本标准规定了移动通信网络的OMC北向接口网络资源模型文件的文件格式，供OM^H向接口开发人员、网络系统数据采集程序开发人员参考使用；本标准可适用于 GSM、TD-SCDMA、IMS、EPS等网络的OMC北向接口。规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。序号标准编号标准名称发布单位[1]QB-W-007-2007中国移动第三代移动通信网网络管理接口技术规范中国移动通信集团公司术语、定义和缩略语词语解释DnDistinguishedName,识别名Itf-NNorthboundInterface,北向接口IOCInformationObjectClass,信息对象类MMEMobilityManagementEntity,移动性管理实体NENetworkElement,网元NMSNetworkManagementSystem,网络管理系统NRMNetworkResourceModel,网络资源模型OMCOperation&MaintenanceCenter,操作维护中心PMPerformanceMeasurements,性能测量数据XMLExtensibleMarkupLanguage,可扩展标记语言网络资源模型文件格式综述

QB-XX-XXX-XXXX网络资源模型的采集机制图1网络资源模型改成和采集流程示意图配置管理是网络管理系统（NMS）的基本功能，NMS有效进行配置管理的前提是网络的配置信息完整、准确。按配置数据的流转过程，NMS对网络配置数据的采集可以划分为两个过程：（一）网络的配置数据同步至OMC。由于OMC与网元由同一设备厂商的提供，它们之间的接口为私有接口，OMC如何从网元同步配置数据、配置数据以何种形式存在都不属于标准化的范畴。（二）NMS从OMC上采集配置数据。OMC北向接口则通过标准化解决YNMS与源自不同设备供应商的OMC之间的互通问题，OMC北向接口的标准化涉及接口功能、接口协议以及接口信息模型的标准化，配置数据的标准化是接口信息模型标准化的内容之一。基于面向对象的分析与设计技术，网络的配置数据以IOC的形式进行标准化建模，标准化后的配置数据称为网络资源模型，并以文件的形式存储在OMC上，这样的文件称为网络资源模型文件。NMS从OMC提取网络资源模型文件，并基于网络资源模型、性能测量数据等信息，生成网络运维所需的报表。津网络资源模型文件格式注根据《中国移动第三代移动通信网网络管理接口技术规范》，网络的配置数据也可以通过基本配置管理接口获取，基本配置管理接口可能不使用文件的方式传递配置数据。但从大批量数据传递效率的角度出发，本标准均约定NRM以文件的方式传递。QB-XX-XXX-XXXX一般地，为简化NMS数据采集的复杂度，使用同一个程序采集不同厂商OMC提供的网络资源模型文件，OMC北向接口既要约定网络资源模型的内容，又要约定网络资源模型文件的格式。网络资源模型内容的规范化不是本标准的内容范畴；而网络资源模型文件通常有ASN.1与XML等多种格式。本标准约定网络资源模型统一采用XML格式的文件，且文件格式使用Schema进行约束。网络资源模型文件格式文件总体结构I I I-FileHeader[+]Hr^File , -HObjects[+]D・・8图2网络资源模型文件结构图如上图所示，网络资源模型文件总体上包括两部分：网络资源模型文件头:文件头部分主要用于存放关于网络资源模型的控制信息，以便于NMS识别、处理网络资源模型文件。网络资源对象:即具体的网络资源模型的实例，这一部分是网络资源模型文件主体。文件头部分图3网络资源模型文件头结构图QB-XX-XXX-XXXX网络资源模型文件头存放在＜FileHeader＞标记下，它下属的各个字段（XML标记）的数据类型及含义如下：InfoModelReferenced：字符串型，指示网络资源模型文件中的网络资源模型所遵循的信息模型的标准，如CMCC-ENB-NRM-V1.1.0。DnPrefix：字符串型，指示生成这个网络资源模型文件的子网的Dn前缀。SenderName：字符串型，指示生成这个网络资源模型文件的ManagementNode的Dn，即OMC。VendorName:字符串型，指示生成这个网络资源模型文件的OMC的设备供应商。DataTime：日期时间型，指示文件中的网络资源模型的时间。注意，此时间代表OMC从网络同步配置数据的时间，它与网络资源模型文件的生成时间无关。网络资源模型部分网络资源模型的组织网络资源模型的对象类实例部分是网络资源模型文件的主体，它的结构如下图ObjectTypeFlattributes"x7-0--OT舁niUserLiiljelObjectTypeFlattributes"x7-0--OT舁niUserLiiljelFieldV&luE弟-**-1^—C>1^—日attributes9n—b图4网络资源模型文件对象类实例部分的结构如上图所示，对象类实例（＜Objects＞）部分是IOC实例对象的组合，每一组网络资源模型是一个IOC相关的对象实例，包括三个字段（XML的标记）：ObjectType:指示该组网络资源模型归属的对象类FieldName：该部分指示该对象类的属性列表，每个属性分别存放在单独一个标记＜N＞中。标记N的属性i是整数，指示了当前的属性在属性名列表中的自然数序号。QB-XX-XXX-XXXXFieldValue：该部分存放各种IOC对象的属性值，每个对象实例的属性值存放在一个＜Cm＞标记中。标记＜Cm＞包括两个属性:属性Dn指示当前的对象的识别名；属性UserLabel指示当前对象的UserLabel,以方便人工查找该对象的网络资源模型。标记＜Cm＞下包含一组属性值＜V＞，其个数与FieldName部分的标记＜N＞的个数保持一致，并使用属性i进行关联，即＜Cm＞中的第i个＜V＞（或＜CV＞,参见下一节）对应于FieldName部分第ij＜N＞。当某个对象的FieldName对应的值无法取到时，在FieldValue中不应省略对应的＜V＞标记，此时标记内内容为空。对补充网络资源模型的支持补充网络资源模型是指在OMC北向接口信息模型标准的网络资源模型部分之外定义的网络资源模型。对补充网络资源模型的支持，可以使标准使用单位在现有的网络资源模型标准的基础之上，针对本地的维护需求，补充定义网络资源模型要求，并通过统一的网络资源模型文件上传，而无须另行约定网络资源模型文件格式。补充的网络资源模型也必须使用面向对象的分析与设计技术进行建模。补充网络资源模型在性能测量文件中，参照标准的网络资源模型存放。对补充网络资源模型的支持，使得OMC可以同时在一个文件中，存放符合不同版本的信息模型标准的网络资源模型成为可能。但若不同版本的网络资源模型对使用同一对象类的同一属性有不同的定义，则应使用不同的文件分别存储网络资源模型。总之，统一网络资源模型文件格式与具体的信息模型是无关的，这为OMC北向接口信息模型的版本升级过程带来便利。在通常情况下，若要支持新版本的OMC北向接口信息模型，网元、OMC以及NMS都需要升级，且升级过程可能会持续相当长的一段时间。统一网络资源模型文件可使OMC和NMS的升级独立开来：OMC升级可独立于NMS进行。尽管信息模型的版本不一致，但由于文件格式是统一的，NMS上旧版本的数据采集程序仍可以支持新版本OMC生成的网络资源模型文件的采集，新版本多出的网络资源模型被自动忽略；NMS的升级可独立于OMC进行。在OMC升级过程中，NMS也可独立进行升级，新采集程序在处理旧版本的网络资源模型文件时，可标记新版本信息模型中增量的网络资源模型为未采集到。这样，OMC与NMS的升级计划可相对独立安排，互不干扰。QB-XX-XXX-XXXX数据类型的串化和还原总体方案OMC北向接口的信息模型中使用的数据类型包括简单数据类型和复杂数据类型。简单数据类型包括整型、实型、字符型、字符串、布尔型、日期时间型。复杂数据类型又称为构造数据类型，即它是通过多个简单数据类型构造生成，如列表、结构等。简单数据类型的种类是有限的，但复杂数据类型可以根据应用需求自由定义，其数据类型理论上无法穷举。为避免文件格式与信息模型的相关性，在文件格式标准无法为每一种复杂数据类型分别约定其呈现形式，因此本文约定所有的数据类型均以字符串的形式出现，并约定了不同数据类型向字符串的转换规则。本文将各种数据类型向*乂1的标记值字符串或标记属性值字符串转换过程称为“数据类型串化过程”，并简称之为“串化"；将XML的标记值字符串或标记属性值字符串还原为原数据类型的过程称为“数据类型还原过程”，并简称之为“还原”。标记的数据类型串化和还原标记值保留字符用于标记值的保留字符包括两类，即XML保留字符和信息模型保留字符。XML保留字符是指字符’<’、’>’和’&’。如果字符型或字符串型的值中包括YXML保留字符，按*乂1的语法，在输出结果应分别使用“<八“>〃和“&〃代替（不含双引号）。信息模型保留字符是指本标准约定的，用于构造复杂数据类型的关键字符，包括字符‘{’、‘}’、‘（’、‘）’、‘，和、。如果字符型或字符串型的值中包括了上述信息模型保留室则在输出结果应分别使用字符串"'{"、"\}〃、“\（"、“\）〃、"\,"和“\\"代替（不含双引号）。简单数据类型简单数据类型串化简单数据类型串化过程分为两个步骤：步骤1：字符串转换步骤2：保留字符替换以下举例说明各种简单数据类型在步骤1转化为字符串的结果:QB-XX-XXX-XXXX表1 简单数据类型的串化数据类型示例示例输出结果补充说明整型12<V>12</V>（1）输出结果填写在标记<V>或<SV>内时，不包括表示字符串的双引号（2）格式化时可能指示了占位宽度，如12.3456可能表示为”12.3456”，此时占位符必须使用空格，而不能使用制表符。NMS解析程序应能识别并处理占位空格。（3）布尔型的结果统一转化为大写字符串。实型12.3456<V>12.3456</V>字符型C<V>C</V>布尔型True/TRUEFalse/FALSE<V>TRUE</V><V>FALSE</V>字符串型“abcde”<V>abcde</V>日期型2012年6月26日<V>2012-06-26</V>日期时间型东8区2012年5月8日17:30:00<V>2012-05-08T17:30:00+08:00</V>当简单数据类型格式化后的字符串中包含YXML保留字符或信息模型保留字符时，应进一步将各保留字符替换为其替代字符串。如100TrafficRoute的属性UserLabel取值为"Route&1"时在XML文件中应表示为：<v>Route&1</V>又如IOCManagedElement的属性ManagedBy的值为“CMCCBeiJing.XiCheng,SubNetwork=1,ManagementNode=1”时，在*乂1文件中应表示为：<V>CMCCBeiJing.XiCheng\,SubNetwork=1\,ManagementNode=1</V>简单数据类型还原与串化过程相反，简单数据类型还原过程分也两个步骤：步骤1：保留字符替代字符串还原为保留字符步骤2：字符串转简单数据类型如当从XML文件中取得IOCTrafficRoute的属性UserLabel对应的值为“CMCCBeiJing.XiCheng\,SubNetwork=1\,ManagementNode=1”时，步骤1将其变换为"CMCCBeiJing.XiCheng,SubNetwork=1,ManagementNode=1"，步骤2将该字符串转换为UserLabel的数据类型（字符串），最终UserLabel的值为“CMCCBeiJing.XiCheng,SubNetwork=1,ManagementNode=1"。复杂数据类型复杂数据类型串化复杂数据类型又称为构造数据类型，即它是通过多个简单数据类型构造生成，如集合、列表、结构等。复杂数据类型支持数据类型之间的嵌套，如结构的列表等等。QB-XX-XXX-XXXX复杂数据类型串化过程分为三个步骤：步骤1:简单数据类型字符串化，即构成复杂数据类型的各个简单数据类型转换为字符串步骤2：保留字符替换，即将串化后的字符串中的保留字符替换为其替代字符串。步骤3：复杂类型字符串构造，即将多个简单类型串化后的字符串，按照一定的规则组合成复杂类型串化字符串。枚举枚举是构造数据类型，但枚举型数值结果通常为字符串常量，因此其在XML文件中的表示形式同字符串，但枚举型的取值将统一转换为大写字符串。如ManagedElement的属性AdministrativeState（管理状态）是枚举型，其取值范围为{Locked（0），Unlocked（1），ShuttingDown⑵}。若实际取值为"Unlocked"，在XML表示为：<V>UNLOCKED</V>集合集合中的元素放置在大括号对（“{"、“}”）之内，各个元素之间使用逗号（“,”）分隔。如包含整数12、34、56、78的集合，各步骤的串化结果分别为：步骤1：string1="12",string2="34",string3="56",string4="78”步骤2：string1="12",string2="34",string3="56",string4="78”步骤3：SerializedString="{12,34,56,78}”最后整数集合在XML文件中应表示为：<V>{12；34；56；78}</V>集合中的元素不区分先后顺序。集合中的每一项应解析为何种数据类型，应以信息模型标准的定义为准。如包含字符串'12"、“34”、“56”、“78”的集合在<ML中应表示为：<V>{12,34,56,78}</V>I这与以上的整数集合的串化结果相同。列表列表的表示方式与集合相同，但集合中的原元素没有重复。如ManagedElement的属性ManagementIpAdress,其类型为字符串列表。若某网元网管IP地址为10.1.2.34和10.1.2.35,则在XML中应表示为<V>{10.1.2.34,10.1.2.35}</V>6.2.3.1.1.4结构QB-XX-XXX-XXXX一个结构包含多个字段，字段中间使用逗号(”,〃)分隔，整个结构的各个字段包括在圆括号内。如EpRpDynSluEnb的属性FarlpSubnetworkList，其数据类型为结构列表，ListofStruct{Subnetwork:string，Mask:string}，某eNodeB的S1u接口的FarIpSubnetworkList在*“1中表示如下：<V>{(10.1.1.0,255.255.255.0),(10.1.2.0,255.255.255.0)}</V>复杂数据类型还原复杂数据类型串化字符串的还原过程分为三个步骤：步骤1：将复杂数据类型串化字符串分解为多个简单数据类型串化字符串。注意，此过程中保留字符替代字符串中的任何字符不应被解析为复杂类型构造字符。步骤2：将各简单数据类型串化字符串中的保留字符替代字符串还原为保留字符步骤3：将各个字符串转化为简单数据类型，并构造原复杂数据类型设有结构列表数据类型，其数据类型描述如下：ListofStruct(Name:string;Value:string)现有该类型串化后字符串在XML中表示为<V>{(ABC\(12\),DEF\(34\)),(GHI\,56\,JKL<78>)}</V>该串化字符串还原过程如下：步骤1：string1="ABC\(12\)"，string2="DEF\(34\)"，string3="GHI\,56\,"string4="JKL<78>”步骤2：string1="ABC(12)”,string2="DEF(34)”,string3="GHI,56,"string4="JKL<78>”步骤3：构造原数据类型，其值为{(sting1,string2),(string3,string4)}标记属性的数据类型串化和还原NRM文件标记属性根据网络资源模型的文件格式约定，网络资源模型文件中含所包括的标记属性见下表QB-XX-XXX-XXXX表2 网络资源模型文件的标记属性列表标记标记属性标记属性数据类型<N>i整型<Cm>Dn字符串UserLabel字符串<V>i整型标记属性值保留字符本标准约定属性值应统一包含在双引号之内，并约定’<’、’>’、’&’、单引号（‘）和双引号⑹为XM^留字符。当标记属性的值包括上述字符时，分别使用字符串“<八"&gl八"&八"'〃和“"丁代替（不含双引号）。由于标记属性均为简单数据类型，因此标记属性无须约定信息模型保留字符，即字符‘{’、‘}’、‘（’、‘）’、‘，和、均以其原形出现。标记属性数据类型的串化和还原过程参见标记的简单数据类型串化和还原。网络资源模型文件组织综述本标准约定每个网元类型相关的各NRM文件应存储在同一个目录下，但对不同的网元类型相关的NRM文件是否分目录存储不做限制。给定一个网元类型，有两种文件组织方式：文件组织方式一：针对其信息模型规范中包括的每一个IOC，分别启用一个独立的NRM文件文件存储其实例数据。文件组织方式二：对所有的IOC启用一个NRM文件存储其实例数据。无论使用哪用文件组织方式，当某个NRM文件大小超过预设值时，可以将文件拆分为多个子文件。一般地，基于文件数、文件大小（对象实例个数）的考虑，对无线接入网网元类型优选文件组织方式一，对核心网网元类型优选文件组织方式二。文件的命名10QB-XX-XXX-XXXXNRM文件的命名规则为：<InfoModelReferenced>-[IocName]-<DataTime>[P<ii>].xml文件名中各部分的取值说明如下：•<InfoModelReferenced>：必选字段，标识NRM文件遵循的信息模型标准，其值与文件头的InfoModelReferenced字段保持一致。它可以进一步表示为：[<Organization>-]<NE-Type>-<InfoModelType>-<Version>[〈Organization〉-]:可选字段，用于标识发布信息模型标准的单位，如“CMCC-"、“3GPP-”等。当要同时启用不同来源的信息模型标准时，用此字段来区分文件。<NE_Type>：标识NRM文件适用的网元类型，如MME、ENB等。<InfoModelType>：取值为“NRM”或“PM”，对于NRM文件仅可取NRM。<Version>：标识文件遵循的信息模型的规范版本，允许在同一个目录下存放不同版本的信息模型规范的NRM文件。[IocName]：可选字段，仅当使用文件组织方式一时，应将[IocName]替换成实际的类名，类名的大小写与信息模型标准保持一致。<DataTime>：必选字段，格式为“YYYYMMDD-HHMM”，指示数据的本地时间时间戳，其值应与XML文件头中的<DateTime>保持一致（注：格式不相同，此处不用指明时区）。[P<ii>]：可选字段，当文件名指定的信息模型内容被分割存放到多个文件中时，第一部分为“P00”、第二部分为“P01”，以此类推。分割后的每包ML子文件也必须符本标准约定的文件格式要求。文件的分割可能是因为文件超过预设的大小（文件大小本标准不约定），也可能是OMC根据配置将不同的Job或不同的IOC的内容分开存储，其原因不作限制。当出现文件分割时，NMS需要采集所有子文件的数据才能保障数据完整性。例：如采用文件组织方式二，2012年2月22日网元类型乂乂£下各种IOC在18：15的配置数据文件，其文件名为：MlME-NRM-V1.1.0-20120222-1815.xmll例：如采用文件组织方式一，2012年2月23日IOCEutranCellTdd的19:00的配置数据文件，因Cell数量较多被分割成两个子文件，它们的文件名分别为：ENB-NRM-V1.1.0-EutranCellTdd-20120223-1900P00.xml11QB-XX-XXX-XXXXENB-NRM-V1.1.0-EutranCellTdd-20120223-1900P01.xml文件的压缩为了提升接口数据传输效率，缺省应将NRM文件压缩后传输。OMC应使用zip或gzip压缩格式对NRM文件进行压缩，压缩文件时不再分卷，压缩后的文件名由原XML文件名后增加相应的压缩文件后缀名构成。如在使用gzip格式压缩时，上述两个例子中压缩后的文件名分别