移动网OMC北向接口技术规范基于CORBA技术的大数据量配置管理接口设计(v3.0.0)

1、 1移动通信网网络管理接口技术规范移动通信网网络管理接口技术规范-基于基于 CORBACORBA 技术的大数据量配置技术的大数据量配置管理接口设计管理接口设计N N e e t t w w o o r r k k M M a a n n a a g g e e m m e e n n t t I I n n t t e e r r f f a a c c e e S S p p e e c c i i f f i i c c a a t t i i o o n n f f o o r r M M o o b b i i l l e e C C o o m m m m u u n n i i c

2、 c a a t t i i o o n n N N e e t t w w o o r r k k- - - - C C O O R R B B A A - - b b a a s s e e d d B B u u l l k k C C M M M M a a n n a a g g e e m m e e n n t t I I n n t t e e r r f f a a c c e e D D e e s s i i g g n n版本号：版本号：3.0.03.0.020-发布20-实施中中国国移移动动通通信信 有有限限公公司司 发发布布中中 国国 移移 动动 通通 信信 企企

3、业业 标标 准准QB-QB- I目录目录目录.I前言 .II移动通信网网络管理接口技术规范 -基于 CORBA 技术的大数据量配置管理接口设计.11 范围.12 规范性引用文件.13 术语、定义和缩略语.13.1 缩略语.14 基于 CORBA 技术大树据量配置管理接口设计 .14.1 大数据量配置管理接口映射表.14.1.1 操作和通知映射 .14.1.2 操作参数映射 .24.1.3 通知参数映射 .54.1.4 状态名称映射 .74.2 大数据量配置管理接口定义.75 参考文献.86 修订历史.8移动通信网网络管理接口技术规范 基于 CORBA 技术的大数据量配置管理接口设计II前言本规

4、范是移动通信网网络管理接口技术规范系列标准中的第五项的子项。该系列标准预计分为三部分：基本原则、厂商网元管理系统北向接口部分和直连网元部分，其中，每一部分又包含若干项，其结构及名称预计如下：1） 移动通信网网络管理接口技术规范-基本原则2） 移动通信网网络管理接口技术规范-功能需求3） 移动通信网网络管理接口技术规范-分析4） 移动通信网网络管理接口技术规范-资源模型5） 移动通信网网络管理接口技术规范-CORBA 设计6） 移动通信网网络管理接口技术规范-文件格式7） 移动通信网网络管理接口技术规范-DN 和 Filter 的约定8） 移动通信网网络管理接口技术规范-补充说明文件9） 移动通

5、信网网络管理接口技术规范-接口性能指标10）移动通信网网络管理接口技术规范-直连网元本规范为移动通信网网络管理接口技术规范 基于 CORBA 技术的大数据量配置管理接口设计 ，定义了在移动通信网网络管理中基于 CORBA 技术的管理接口定义即 IDL 定义。是参考国际电信联盟电信标准部（ITU-T）的相关建议、3GPP 相关建议以及对象管理组织 OMG 的有关规范，并依据中国移动通信有限公司的移动通信网网络管理需求编制而成的。本规范由中国移动通信有限公司网络部提出并归口本规范起草单位：中国移动通信有限公司网络部，北京邮电大学本规范主要起草人：姚羿志、芮兰兰、李文璟李冶文、王烨、徐海东、魏丽红本

6、规范解释单位：中国移动通信有限公司网络部本规范由中国移动通信有限公司 XXX 号文发布移动通信网网络管理接口技术规范 基于 CORBA 技术的大数据量配置管理接口设计1移动通信网网络管理接口技术规范移动通信网网络管理接口技术规范-基于基于 CORBA 技术的大数据量配置管理接口技术的大数据量配置管理接口设计设计1范围本标准规定了移动通信网网络管理接口中基于CORBA技术的大数据量配置管理接口设计。本标准适用于对移动通信网网络管理接口的分析，设计和开发。2规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用

7、于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。移动通信网网络管理接口技术规范 基本原则移动通信网网络管理接口技术规范 大数据量配置管理接口分析3术语、定义和缩略语3.1缩略语下列缩略语适用于本标准。IDL接口定义语言Interface Definition LanguageCORBA公共对象请求代理体系Common Object Request Broker Architecture4基于 CORBA 技术大树据量配置管理接口设计4.1大数据量配置管理接口映射表4.1.1操作和通知映射在移动通信网网络管理接口技术规

8、范 大数据量配置管理接口分析（以下简称接口分析）中定义了大数据量配置管理接口操作和通知的语义，表1给出了这些操作和通知到基于CORBA/IDL技术接口设计的映射。表 1操作/通知映射表分析阶段操作/通知设计阶段映射startSessionstart_sessionendSessionend_sessionuploaduploaddownloaddownloadactivateactivategetSessionStatusget_session_statusgetSessionIdsget_session_idsgetSessionLogget_session_logfallbackfallb

9、ackabortSessionOperationabort_session_operationgetIRPVersionget_bulk_cm_irp_versionsget_controlled_upload_bulk_cm_irp_versionsget_simple_upload_bulk_cm_irp_versionsnotifySessionStateChangedpush_structured_eventsnotifyGetSessionLogEndedpush_structured_eventspreactivatepreactivatevalidatevalidategetOp

10、erationProfileget_bulk_cm_irp_operation_profile移动通信网网络管理接口技术规范 基于 CORBA 技术的大数据量配置管理接口设计2get_controlled_upload_bulk_cm_irp_operation_profileget_simple_upload_bulk_cm_irp_operation_profilegetNotificationProfileget_bulk_cm_irp_notification_profileget_controlled_upload_bulk_cm_irp_notification_profilege

11、t_simple_upload_bulk_cm_irp_notification_profile4.1.2操作参数映射在接口分析中定义了大数据量配置管理接口操作中各个参数的语义，下面的表格逐个给出了操作中各个参数到基于CORBA/IDL技术接口设计的映射。表 2startSession 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBulkCmIRPConstDefs:SessionId session_idresult异常：StartSessionException，SessionIdInUseException，MaxSessionReachedException，M

12、anagedGenericIRPSystem:InvalidParameter表 3endSession 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBulkCmIRPConstDefs:SessionId session_idresult异常：EndSessionException，UnknownSessionIdException，NotValidInCurrentStateException，ManagedGenericIRPSystem:InvalidParameter表 4upload 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBul

13、kCmIRPConstDefs:SessionId session_id uploadDataFileReferenceBulkCmIRPConstDefs:FileDestination sink baseObjectInstanceBulkCmIRPConstDefs:DistinguishedName base_object scope, filterBulkCmIRPConstDefs:SearchControl search_control result异常：UploadException，UnknownSessionIdException，MaxSessionReachedExce

14、ption，NotValidInCurrentStateException，ConcurrencyException，IllegalDNFormatException，IllegalFilterFormatException，IllegalScopeTypeException，IllegalScopeLevelException，IllegalURLFormatException，ManagedGenericIRPSystem:InvalidParameter表 5download 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBulkCmIRPConstDefs:Ses

15、sionId session_id downloadDataFileReferenceBulkCmIRPConstDefs:FileDestination source result异常：DownloadException，UnknownSessionIdException，MaxSessionReachedException， NotValidInCurrentStateException，IllegalURLFormatException， 移动通信网网络管理接口技术规范 基于 CORBA 技术的大数据量配置管理接口设计3ManagedGenericIRPSystem:InvalidPar

16、ameter表 6activate 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBulkCmIRPConstDefs:SessionId session_id activationModeBulkCmIRPConstDefs:ActivationModeTypeOpt activation_modefallbackEnabledboolean fallback result异常：ActivateException，UnknownSessionIdException，NotValidInCurrentStateException，ConcurrencyException，

17、IllegalActivationModeException，ManagedGenericIRPSystem:ParameterNotSupported，ManagedGenericIRPSystem:InvalidParameter表 7fallback 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBulkCmIRPConstDefs:SessionId session_id result异常：FallbackException，UnknownSessionIdException，NoFallbackException，NotValidInCurrentStateEx

18、ception，ConcurrencyException，ManagedGenericIRPSystem:InvalidParameter表 8abortSessionOperation 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBulkCmIRPConstDefs:SessionId session_id result异常：AbortSessionOperationException，UnknownSessionIdException，NotValidInCurrentStateException，ManagedGenericIRPSystem:InvalidPar

19、ameter表 9getSessionIds 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdList返回参数类型BulkCmIRPConstDefs:SessionIdListresult异常：GetSessionIdsException，ManagedGenericIRPSystem:InvalidParameter表 10getSessionStatus 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBulkCmIRPConstDefs:SessionId session_id sessionState返回参数类型BulkCmIRPConstDe

20、fs:SessionState 分析中无此参数BulkCmIRPConstDefs:ErrorInformation error_informationresult异常：GetSessionStatusException，UnknownSessionIdException，ManagedGenericIRPSystem:InvalidParameter移动通信网网络管理接口技术规范 基于 CORBA 技术的大数据量配置管理接口设计4表 11getSessionLog 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBulkCmIRPConstDefs:SessionId s

21、ession_id logFileReferenceBulkCmIRPConstDefs:FileDestination sink contentTypeboolean only_error_info result异常：GetSessionLogException，UnknownSessionIdException，IllegalURLFormatException，ManagedGenericIRPSystem:InvalidParameter表 12getBulkCmIRPVersion 操作参数映射表分析阶段操作参数设计阶段操作参数映射versionNumberList返回参数类型Man

22、agedGenericIRPConstDefs:VersionNumberSetresult异常：GetBulkCmIRPVersionsException注：IRP版本合法值使用idl文件头中定义的版本信息。BulkCMIRP的idl文件头中定义了“/The IRP document version number is BulkCM IRP V1.3.0，则BulkCMIRP的版本合法值为BulkCM IRP V1.3.0，其他IRP的版本合法值取值同理；VersionNumberSet是IRP版本VersionNumber的序列。表 13validate 操作参数映射表分析阶段操作参数设计

23、阶段操作参数映射sessionIdBulkCmIRPConstDefs:SessionId session_id activationModeBulkCmIRPConstDefs:ActivationModeTypeOpt activation_moderesult异常：ValidateException，UnknownSessionIdException，NotValidInCurrentStateException，ConcurrencyException，IllegalActivationModeException，ManagedGenericIRPSystem:ParameterNot

24、Supported, ManagedGenericIRPSystem:InvalidParameter, ManagedGenericIRPSystem:OperationNotSupported表 14preactivate 操作参数映射表分析阶段操作参数设计阶段操作参数映射sessionIdBulkCmIRPConstDefs:SessionId session_id verificationModeBulkCmIRPConstDefs:VerificationModeTypeOpt verification_modeactivationModeBulkCmIRPConstDefs:Act

25、ivationModeTypeOpt activation_modefallbackEnabledboolean fallbackresult异常：PreactivateException，UnknownSessionIdException，NotValidInCurrentStateException，ConcurrencyException，IllegalActivationModeException，IllegalVerificationModeException，ManagedGenericIRPSystem:ParameterNotSupported，ManagedGenericIR

26、PSystem:InvalidParamete，ManagedGenericIRPSystem:OperationNotSupported表 15getOperationProfile 操作参数映射表移动通信网网络管理接口技术规范 基于 CORBA 技术的大数据量配置管理接口设计5 表 16getNotificationProfile 操作参数映射表 4.1.3通知参数映射在接口分析中定义了大数据量配置管理接口通知中各个参数的语义，下面的表格逐个给出了通知中各个参数到基于CORBA/IDL技术接口设计的映射。表 17notifyGetSessionLogEnded 通知参数映射表分析阶段通知参

27、数OMG CORBA结构事件参数映射说明分析阶段没有相应参数域名（domain_name）字符串，为相应IRP信息模型的版本号。notificationType类型名（type_name）上报的通知的类型，即获取日志会话结束通知取值为字符串：BulkCMIRPNotifications:NotifyGetSessionLogEnded:EVENT_TYPE。sessionLogStatus事件名（event_name）字符串：BulkCmIRPConstDefs:LogStateNotification: GET_SESSION_LOG_COMPLETED_SUCCESSFULLY 或Bulk

28、CmIRPConstDefs:LogStateNotification: GET_SESSION_LOG_COMPLETED_UNSUCCESSFULLY，如果为后者，则将会有表示错误信息的参数：名值对ERROR_INFORMATION。分析阶段没有相应参数可变事件头（variable Header）objectClass，objectInstance可过滤体域（filterable_ body_fields）的一个名值对发出通知的管理对象类和对象实例，即BulkCMIRP对象类的对象实例。notificationId保留体（remaining_ body）的一个名值对通知标识符，用来唯一标识

29、通知，可进行通知的关联。名值对的名字是一个字符串NotificationIRPConstDefs:AttributeNameValue:NOTIFICATION_ID。其值为long长整型。eventTime可过滤体域（filterable_ body_fields）的一个名值对指明事件发生时间。使用 OMG定义的UTC类型。名值对的名字是一个字符串NotificationIRPConstDefs:AttributeNameValue:EVENT_TIME。分析阶段操作参数设计阶段操作参数映射irpVersionManagedGenericIRPConstDefs:VersionNumber

30、bulk_cm_irp_versionoperationNameProfile, operationParameterProfile返回参数类型ManagedGenericIRPConstDefs:MethodListresult异常：GetBulkCMIRPOperationProfileException,ManagedGenericIRPSystem:OperationNotSupported,ManagedGenericIRPSystem:InvalidParameter分析阶段操作参数设计阶段操作参数映射irpVersionManagedGenericIRPConstDefs:Ver

31、sionNumber bulk_cm_irp_versionnotificationNameProfile, notificationParameterProfile返回参数类型ManagedGenericIRPConstDefs:MethodListresult异常：GetBulkCMIRPNotificationProfileException,ManagedGenericIRPSystem:OperationNotSupported,ManagedGenericIRPSystem:InvalidParameter移动通信网网络管理接口技术规范 基于 CORBA 技术的大数据量配置管理接口

32、设计6systemDN可过滤体域（filterable_ body_fields）的一个名值对名值对的名称为字符串NotificationIRPConstDefs:AttributeNameValue:SYSTEM_DN。名值对的值为字符串string，表示产生通知的被管系统（即IRPAgent）标识。sessionId保留体（remaining_ body）的一个名值对名值对的名为BulkCMIRPNotifications: NotifyGetSessionLogEnded:SESSION_ID，值为字符串sourceIndicator保留体（remaining_ body）的一个名值对名

33、值对的名为BulkCMIRPNotifications: NotifyGetSessionLogEnded:SOURCE_INDICATOR，值为字符串分析阶段没有相应参数保留体（remaining_ body）的一个名值对名值对的名为BulkCMIRPNotifications: NotifyGetSessionLogEnded:ERROR_INFORMATION，值为字符串表 18notifySessionStateChanged 通知参数映射表分析阶段通知参数OMG CORBA结构事件参数映射说明分析阶段没有相应参数域名（domain_name）字符串，为相应IRP信息模型的版本号。no

34、tificationType类型名（type_name）上报的通知的类型，即会话状态改变通知取值为字符串：BulkCMIRPNotifications:NotifySessionStateChange:EVENT_TYPE 。sessionState事件名（event_name）下列字符串之一：Upload_Failed Upload_Completed, Download_Failed, Download_Completed, Activation_Failed, Activation_Partly_Realised, Activation_Completed, Fallback_Faile

35、d, Fallback_Partly_Realised, Fallback_Completed,VALIDATION_FAILED,VALIDATION_COMPLETED,PREACTIVATION_FAILED,PREACTIVATION_PARTLY_REALISED,preaCTIVATION_completed如果是 XXX_FAILE 或 XXX_PARTLY_REALISED, 则将会有出现表示错误信息的参数：名值对ERROR_INFORMATION。分析阶段没有相应参数可变事件头（variable Header）objectClass，objectInstance可过滤体域（f

36、ilterable_ body_fields）的一个名值对发出通知的管理对象类和对象实例，即BulkCMIRP对象类的对象实例。notificationId保留体（remaining_ body）的一个名值对通知标识符，用来唯一标识通知，可进行通知的关联。名值对的名字是一个字符串NotificationIRPConstDefs:AttributeNameValue:NOTIFICATION_ID。移动通信网网络管理接口技术规范 基于 CORBA 技术的大数据量配置管理接口设计7其值为long长整型。eventTime可过滤体域（filterable_ body_fields）的一个名值对指明事

37、件发生时间。使用 OMG定义的UTC类型。名值对的名字是一个字符串NotificationIRPConstDefs:AttributeNameValue:EVENT_TIME。systemDN可过滤体域（filterable_ body_fields）的一个名值对名值对的名称为字符串NotificationIRPConstDefs:AttributeNameValue:SYSTEM_DN。名值对的值为字符串string，表示产生通知的被管系统（即IRPAgent）标识。sessionId保留体（remaining_ body）的一个名值对名值对的名为BulkCMIRPNotifications

38、: NotifySessionStateChange:SESSION_ID，值为字符串sourceIndicator保留体（remaining_ body）的一个名值对名值对的名为BulkCMIRPNotifications: NotifySessionStateChange:SOURCE_INDICATOR，值为字符串分析阶段没有相应参数保留体（remaining_ body）的一个名值对名值对的名为BulkCMIRPNotifications: NotifySessionStateChange:ERROR_INFORMATION，值为字符串4.1.4状态名称映射接口分析中的状态名称，在基于CORBA/IDL技术接口设计中包括两个子部分，即子阶段和子状态。下表给出了接口分析到基于CORBA/IDL技术接口设计的映射。所有没有在下表中出现的子阶段和子状态的结合都认为是非法的。分析阶段状态名称设计阶段子阶段名称设计阶段子状态名称IDLEIdlePhaseCompletedUPLOAD_FAILEDUploadPhaseFailedUPLOAD_IN_PROGRESSUploadP