移动网OMC北向接口技术规范 大数据量配置管理接口分析V300.docx
- 文档编号:9258565
- 上传时间:2023-05-17
- 格式:DOCX
- 页数:43
- 大小:401.42KB
移动网OMC北向接口技术规范 大数据量配置管理接口分析V300.docx
《移动网OMC北向接口技术规范 大数据量配置管理接口分析V300.docx》由会员分享,可在线阅读,更多相关《移动网OMC北向接口技术规范 大数据量配置管理接口分析V300.docx(43页珍藏版)》请在冰点文库上搜索。
移动网OMC北向接口技术规范大数据量配置管理接口分析V300
中国移动通信企业标准
QB-╳-╳╳╳-╳╳╳╳
中国移动通信集团公司发布
20××-××-××实施
20××-××-××发布
移动通信网网络管理接口技术规范
--大数据量配置管理接口分析
NetworkManagementInterfaceSpecificationforMobileCommunicationNetwork
--BulkConfigurationManagementInterfaceAnalysis
版本号:
3.0.0
1目录
目录I
前言III
移动通信网网络管理接口技术规范--大数据量配置管理接口分析1
1范围1
2规范性引用文件1
3术语、定义和缩略语1
3.1缩略语1
4大数据量配置管理接口分析1
4.1管理对象类图1
4.2管理对象类分析3
4.2.1SimpleUploadBulkCMIRP类3
4.2.1.1SimpleUploadBulkCMIRP类描述3
4.2.1.2操作3
4.2.1.3通知3
4.2.2ControlledUploadBulkCMIRP类3
4.2.2.1ControlledUploadBulkCMIRP类描述3
4.2.2.2操作3
4.2.2.3通知4
4.2.3BulkCMControlledUpload&Provisioning类4
4.2.3.1BulkCMControlledUpload&Provisioning类描述4
4.2.3.2操作4
4.2.3.3通知4
4.2.4操作描述4
4.2.4.1开启会话startSession(M)4
4.2.4.2结束会话endSession(M)5
4.2.4.3中断会话操作abortSessionOperation(M)6
4.2.4.4获取会话标识getSessionIds(M)6
4.2.4.5获取会话状态getSessionStatus(M)7
4.2.4.6获取会话日志getSessionLog(M)7
4.2.4.7上载upload(M)8
4.2.4.8下载download(M)9
4.2.4.9验证validate(M)10
4.2.4.10预激活preactivate(O)11
4.2.4.11激活activate(M)12
4.2.4.12回卷fallback(M)13
4.2.5通知描述14
4.2.5.1会话状态改变通知notifySessionStateChanged(M)14
4.2.5.2获取会话日志结束通知notifyGetSessionLogEnded(M)15
4.3状态机16
4.3.1子状态机17
4.3.1.1上载阶段(UploadPhase)18
4.3.1.2下载阶段(DownloadPhase)19
4.3.1.3验证阶段(ValidationPhase)19
4.3.1.4预激活阶段(PreactivationPhase)20
4.3.1.5激活阶段(ActivationPhase)21
4.3.1.6回卷阶段(FallbackPhase)22
4.4配置数据文件22
4.4.1配置数据管理动作-子操作23
4.4.1.1大数据量配置管理创建对象子操作(bulkCmCreateMo)(M)23
4.4.1.2大数据量配置管理删除对象子操作(bulkCmDeleteMo)(M)23
4.4.1.3大数据量配置管理修改对象属性值子操作(bulkCmChangeMo)(M)23
4.4.2配置数据文件中子操作的排序规则24
4.4.2.1下载文件24
4.4.2.2上载文件24
5参考文献25
6修订历史25
2前言
本规范是《移动通信网网络管理接口技术规范》系列标准中的第三项的子项。
该系列标准预计分为三部分:
基本原则、厂商网元管理系统北向接口部分和直连网元部分,其中,每一部分又包含若干项,其结构及名称预计如下:
1)移动通信网网络管理接口技术规范-基本原则
2)移动通信网网络管理接口技术规范-功能需求
3)移动通信网网络管理接口技术规范-分析
4)移动通信网网络管理接口技术规范-资源模型
5)移动通信网网络管理接口技术规范-CORBA设计
6)移动通信网网络管理接口技术规范-文件格式
7)移动通信网网络管理接口技术规范-DN和Filter的约定
8)移动通信网网络管理接口技术规范-补充说明文件
9)移动通信网网络管理接口技术规范-接口性能指标
10)移动通信网网络管理接口技术规范-直连网元
本规范为《移动通信网网络管理接口技术规范大数据量配置管理接口分析》,是参考国际电信联盟-电信标准部(ITU-T)的相关建议、3GPP相关建议以及对象管理组织OMG的有关规范,并依据中国移动通信集团公司的移动通信网网络管理需求编制而成的。
本规范由中国移动通信集团公司网络部提出并归口
本规范起草单位:
中国移动通信集团公司网络部,北京邮电大学
本规范主要起草人:
李冶文、王烨、徐海东、魏丽红
姚羿志、芮兰兰、李文璟
本规范解释单位:
中国移动通信集团公司网络部
本规范由中国移动通信集团公司XXX号文发布
移动通信网网络管理接口技术规范
--大数据量配置管理接口分析
范围
本规范规定了移动通信网网络管理接口中与网络技术无关的大数据量配置管理部分的管理接口分析。
是对《移动通信网网络管理接口技术规范大数据量配置管理接口功能需求》的细化分析。
本规范适用于对移动通信网网络管理接口的规划和设计。
规范性引用文件
下列文件中的条款通过本规范的引用而成为本规范的条款。
凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本规范,然而,鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件,其最新版本适用于本规范。
《移动通信网网络管理接口技术规范基本原则》
《移动通信网网络管理接口技术规范大数据量配置管理接口功能需求》
《移动通信网网络管理接口技术规范公共管理接口分析》
术语、定义和缩略语
21.1 缩略语
下列缩略语适用于本规范。
CORBA
公共对象请求代理体系结构
CommonObjectRequestBrokerArchitecture
IRP
集成参考点
IntegratedReferencePoint
NMS
网络管理系统
NetworkManagementSystem
NE
网元
NetworkElement
QoS
服务质量
QualityofService
大数据量配置管理接口分析
21.2 管理对象类图
在大数据量管理中,定义了管理对象类BulkCMIRP对象,用来完成大数据量的配置管理功能。
对象类图如下所示,其中GenericIRP和ManagedGenericIRP对象在《移动通信网网络管理接口技术规范公共管理接口分析》中定义。
大数据量配置管理有三种功能提供方式:
简单上行大数据量配置管理,可控上行大数据量配置管理,可控上行和下行大数据量配置管理。
网管系统可根据实际需要进行选择,具体选择哪一种方式不在本规范定义范围内。
图1 简单上行大数据量配置管理对象类图
图2 可控上行大数据量配置管理对象类图
图3 可控上行和下行大数据量配置管理对象类图
21.3 管理对象类分析
21.3.1 SimpleUploadBulkCMIRP类
21.3.1.1 SimpleUploadBulkCMIRP类描述
SimpleUploadBulkCMIRP对象是用于简单上行大数据量配置管理的控制对象,完成对大数据量配置管理数据和资产管理数据的简单上行管理。
简单上行不需要建立显性的会话来控制Manager上载资源数据。
21.3.1.2 操作
BulkCMPassive:
上载upload(M)
21.3.1.3 通知
BulkCMNotification_1:
会话状态改变通知notifySessionStateChanged(M)
21.3.2 ControlledUploadBulkCMIRP类
21.3.2.1 ControlledUploadBulkCMIRP类描述
ControlledUploadBulkCMIRP对象是用于可控上行大数据量配置管理的控制对象,完成对大数据量配置管理数据和资产管理数据的可控上行管理。
可控上行要求建立显性的会话来控制Manager上载资源信息。
21.3.2.2 操作
BulkCMPassive:
上载upload(M)
BulkCMSession:
开启会话startSession(M)
结束会话endSession(M)
中断会话操作abortSessionOperation(M)
获取会话标识getSessionIds(M)
获取会话状态getSessionStatus(M)
获取会话日志getSessionLog(M)
21.3.2.3 通知
BulkCMNotification_1:
会话状态改变通知notifySessionStateChanged(M)
BulkCMNotification_2:
获取会话日志结束通知notifyGetSessionLogEnded(M)
21.3.3 BulkCMControlledUpload&Provisioning类
21.3.3.1 BulkCMControlledUpload&Provisioning类描述
BulkCMControlledUpload&Provisioning对象是用于可控上行和下行大数据量配置管理的控制对象,完成对大数据量配置管理数据和资产管理数据的可控上行和下行管理。
可控上行和下行要求建立显性的会话来控制Manager上载和指配资源信息。
21.3.3.2 操作
BulkCMPassive:
上载upload(M)
BulkCMSession:
开启会话startSession(M)
结束会话endSession(M)
中断会话操作abortSessionOperation(M)
获取会话标识getSessionIds(M)
获取会话状态getSessionStatus(M)
获取会话日志getSessionLog(M)
BulkCMActive:
下载download(M)
验证validate(M)
预激活preactivate(O)
回卷fallback(M)
21.3.3.3 通知
BulkCMNotification_1:
会话状态改变通知notifySessionStateChanged(M)
BulkCMNotification_2:
获取会话日志结束通知notifyGetSessionLogEnded(M)
21.3.4 操作描述
21.3.4.1 开启会话startSession(M)
行为
“Manager调用该操作来开启一个会话状态机,在Agent中初始化与该会话相关的临时资源。
”
输入参数
sessionId
——“参数sessionId标识了这个新的会话。
”
输出参数
无
前提条件
命题1:
“sessionId当前不在使用中。
”
后继条件
如果Agent成功开启会话,并准备好处理与此会话关联的其他操作,会话状态为IDLE,则result=“success”。
如果操作失败,则result=“failure”
返回值
result
——“返回值result标识操作的成功与否。
”
异常
如果输入参数不合法,则应扔出异常:
“InvalidParameter”;
如果前提条件命题1不成立,则应扔出异常:
“SessionIdInUseException”;
如果达到了允许的最大的会话数,则应扔出异常:
“MaxSessionReachedException”;
如果返回其他原因的异常,则应扔出异常:
“StartSessionException”。
21.3.4.2 结束会话endSession(M)
行为
“Manager调用该操作来结束一个会话状态机,在Agent中删除与该会话相关的文件(如BulkCM文件、会话日志文件),并释放系统中相关的资源。
如果之前调用过“预激活”操作,结束会话将释放分配给该“预激活”的所有内部本地资源。
如果会话状态为“正在进行(in_progress)”,(如正在上载,正在下载和正在激活),结束会话将被拒绝。
”
输入参数
sessionId
——“参数sessionId标识了这个指定的要结束的会话”
输出参数
无
前提条件
命题1:
“该会话已经开启,并且不处在“正在进行(in_progress)”的状态。
”
后继条件
如果操作成功,该会话结束,该sessionId不再处于使用中,则result=“success”。
如果操作失败,则result=“failure”
返回值
result
——“返回值result标识操作的成功与否。
”
异常
如果输入参数不合法,则应扔出异常:
“InvalidParameter”;
如果sessionId未知,则应扔出异常:
“UnknownSessionIdException”;
如果前提条件命题1不成立,则应扔出异常:
“NotValidInCurrentStateException”;
如果返回其他原因的异常,则应扔出异常:
“EndSessionException”。
21.3.4.3 中断会话操作abortSessionOperation(M)
行为
“Manager调用该操作请求Agent中断一个当前活跃的异步操作,中断将使会话状态机退出当前的状态,进入另一个新的状态。
”
输入参数
sessionId
——“参数sessionId标识了这个指定的要中断操作的会话。
”
输出参数
无
前提条件
命题1:
“该会话已经开启,并且处于“正在进行(in_progress)”的状态。
”
后继条件
如果操作成功,状态的迁移见4.3节,则result=“success”。
如果操作失败,则result=“failure”
返回值
result
——“返回值result标识操作的成功与否。
”
异常
如果输入参数不合法,则应扔出异常:
“InvalidParameter”;
如果sessionId未知,则应扔出异常:
“UnknownSessionIdException”;
如果前提条件命题1不成立,则应扔出异常:
“NotValidInCurrentStateException”;
如果返回其他原因的异常,则应扔出异常:
“EndSessionException”。
21.3.4.4 获取会话标识getSessionIds(M)
行为
“Manager调用该操作向Agent获取当前已开启会话的sessionId的列表。
”
输入参数
无
输出参数
sessionIdList
——“参数sessionIdList定义了Agent当前已开启会话的sessionId的列表。
”
前提条件
无
后继条件
如果操作成功,则result=“success”
如果操作失败,则result=“failure”
返回值
result
——“返回值result标识操作的成功与否。
”
异常
如果输入参数不合法,则应扔出异常:
“InvalidParameter”;
如果返回其他原因的异常,则应扔出异常:
“GetSessionIdsException”。
21.3.4.5 获取会话状态getSessionStatus(M)
行为
“Manager调用该操作向Agent获取当前的会话状态。
该操作可以在任何会话状态下调用,并且不改变当前的会话状态。
”
输入参数
sessionId
——“参数sessionId标识了这个指定的会话。
”
输出参数
sessionState
——“参数sessionState定义了当前的会话状态。
”
前提条件
命题1:
“该会话已成功开启,并且没有被结束。
”
后继条件
无
返回值
result
——“返回值result标识操作的成功与否。
”
异常
如果输入参数不合法,则应扔出异常:
“InvalidParameter”;
如果sessionId未知,则应扔出异常:
“UnknownSessionIdException”;
如果返回其他原因的异常,则应扔出异常:
“GetSessionStatusException”。
21.3.4.6 获取会话日志getSessionLog(M)
行为
“Manager调用该操作向Agent获取指定会话的与配置数据文件操作关联的活动结果的日志。
该操作可以在任何会话状态下调用,并且不改变当前的会话状态。
”
输入参数
sessionId
——“参数sessionId标识了这个指定的会话。
”
logFileReference
——“参数logFileReference定义了Manager中要存放结果的地址和文件名。
”
contentType
——“参数contentType定义了要获取的文件内容,可以为:
(a)包含错误信息在内完整日志;
(b)仅包含错误信息。
”
输出参数
无
前提条件
命题1:
“该会话已成功开启,并且没有被结束。
”
后继条件
如果操作成功,且Agent将要开始向Manager中指定的地址和文件中写日志的内容,则result=“success”。
如果操作失败,则result=“failure”
返回值
result
——“返回值result标识操作的成功与否。
”
异常
如果输入参数不合法,则应扔出异常:
“InvalidParameter”;
如果sessionId未知,则应扔出异常:
“UnknownSessionIdException”;
如果URL的格式不合法,则应扔出异常:
“IllegalURLFormatException”;
如果返回其他原因的异常,则应扔出异常:
“GetSessionLogException”。
21.3.4.7 上载upload(M)
行为
“Manager调用该操作请求Agent创建一个包含配置数据的文件并将这个文件传送到指定的全局唯一的数据文件引用。
”
输入参数
sessionId
——“参数sessionId标识了这个与配置数据文件上载相关联的会话。
”
uploadDataFileReference
——“参数uploadDataFileReference定义了一个全局唯一的文件引用,这个文件引用标识了配置数据文件将要上载和存储的位置。
”
baseObjectInstance
——“参数baseObjectInstance是基对象实例标识符,定义了开始搜索的管理对象。
”
scope
——“参数scope定义了搜索的包含层次。
”
搜索将从baseObjectInstance指定的基对象开始,将要执行的搜索层次可以是:
1)仅为基对象本身
2)基对象的第n层从属对象
3)基对象以及到其第n层(包括第n层)的所有从属对象
4)基对象及其所有的从属对象
filter
——“参数filter定义了参数scope所选择对象的一个过滤条件。
如果filter为空,将包含scope所定义的所有对象,一个过滤条件包括一个或几个联合使用逻辑运算AND,OR和NOT的命题。
每个命题是关于“属性是否存在,属性值比较(大于X,小于Y)和对象类”的逻辑表达式。
”
输出参数
无
前提条件
可控上行或可控上行和下行:
命题1:
“会话已经显性地(explicitly)成功开启并且当前会话状态为IDLE或UPLOAD_FAILED,准备好处理该会话的第一个操作或者重复这个操作。
”
简单上行:
命题1:
“sessionId当前不在使用中,隐性地(implicitly)开启会话,准备好处理该会话的第一个操作或者重复这个操作。
”
后继条件
如果操作成功,状态为“正在上载(UPLOAD_IN_PROGRESS)”,Agent已经成功开始了所需配置数据的上载,则result=“success”。
如果操作失败,则result=“failure”
返回值
result
——“返回值result标识操作的成功与否。
”
异常
如果输入参数不合法,则应扔出异常:
“InvalidParameter”;
如果sessionId未知,则应扔出异常:
“UnknownSessionIdException”;
如果达到了允许的最大的会话数,则应扔出异常:
“MaxSessionReachedException”;
如果前提条件命题1不成立,则应扔出异常:
“NotValidInCurrentStateException”;
如果对一个文件引用,同时进行多个上载操作,则应扔出异常:
“ConcurrencyException”;
如果DN的格式不合法,则应扔出异常:
“IllegalDNFormatException”;
如果filter的格式不合法,则应扔出异常:
“IllegalFilterFormatException”;
如果scope的格式不合法,则应扔出异常:
“IllegalScopeTypeException”;
如果scope的级别不合法,则应扔出异常:
“IllegalScopeLevelException”;
如果URL的格式不合法,则应扔出异常:
“IllegalURLFormatException”;
如果返回其他原因的异常,则应扔出异常:
“UploadException”。
21.3.4.8 下载download(M)
行为
“Manager调用该操作请求Agent来下载并管理一个包含配置数据的文件。
Agent从指定的全局唯一的数据文件引用中获取这个配置数据文件。
”
在下载过程中Agent应该检查下载的配置数据文件的Schema一致性,确保没有错误发生;在下载过程中Agent不需要检查已经下载的配置数据的语义错误。
输入参数
sessionId
——“参数sessionId标识了这个与配置数据文件下载相关联的会话。
”
downloadDataFileReference
——“参数downloadDataFileReference定义了数据可以取到并下载的一个全局唯一的文件引用”
输出参数
无
前提条件
命题1:
“该会话处于闲置(IDLE)状态,该会话已成功开启,并且准备好处理该会话的第一个操作或者重复这个
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 移动网OMC北向接口技术规范 大数据量配置管理接口分析V300 移动 OMC 接口 技术规范 数据量 配置管理 分析 V300