移动网OMC北向接口技术规范 大数据量配置管理接口分析(V300)

1、 移动通信网网络管理接口技术规范-大数据量配置管理接口分析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 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

2、- - - - B B u u l l k k C C o o n n f f i i g g u u r r a a t t i i o o n n 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 A A n n a a l l y y s s i i s s版本号：版本号：3.0.03.0.020-发布20-实施中国移动通信集团公司 发布中中 国国 移移 动动 通通 信信 企企 业业 标标 准准QB-QB-移动通信网网络管理接口技术规范 大数据量配置管理接口分析I目录目录.I前言 .II

3、I移动通信网网络管理接口技术规范 - 大数据量配置管理接口分析.11 范围.12 规范性引用文件.13 术语、定义和缩略语.13.1 缩略语.14 大数据量配置管理接口分析.14.1 管理对象类图.14.2 管理对象类分析.34.2.1 SimpleUploadBulkCMIRP 类.34.2.1.1 SimpleUploadBulkCMIRP 类描述.34.2.1.2 操作.34.2.1.3 通知.34.2.2 ControlledUploadBulkCMIRP 类.34.2.2.1 ControlledUploadBulkCMIRP 类描述 .34.2.2.2 操作.34.2.2.3 通知

4、.44.2.3 BulkCM Controlled Upload & Provisioning 类.44.2.3.1 BulkCM Controlled Upload & Provisioning 类描述.44.2.3.2 操作.44.2.3.3 通知.44.2.4 操作描述.44.2.4.1 开启会话 startSession（M）.44.2.4.2 结束会话 endSession（M）.54.2.4.3 中断会话操作 abortSessionOperation（M）.64.2.4.4 获取会话标识 getSessionIds（M）.64.2.4.5 获取会话状态 getSe

5、ssionStatus（M）.74.2.4.6 获取会话日志 getSessionLog（M） .74.2.4.7 上载 upload（M）.84.2.4.8 下载 download（M）.94.2.4.9 验证 validate（M） .104.2.4.10 预激活 preactivate（O）.114.2.4.11 激活 activate（M）.124.2.4.12 回卷 fallback（M）.134.2.5 通知描述.144.2.5.1 会话状态改变通知 notifySessionStateChanged（M）.14移动通信网网络管理接口技术规范 大数据量配置管理接口分析II4.2.5

6、.2 获取会话日志结束通知 notifyGetSessionLogEnded（M）.154.3 状态机.164.3.1 子状态机.174.3.1.1 上载阶段（Upload Phase） .184.3.1.2 下载阶段（Download Phase）.194.3.1.3 验证阶段（Validation Phase）.194.3.1.4 预激活阶段（Preactivation Phase）.204.3.1.5 激活阶段（Activation Phase）.214.3.1.6 回卷阶段（Fallback Phase） .224.4 配置数据文件.224.4.1 配置数据管理动作子操作.234.4.

7、1.1 大数据量配置管理创建对象子操作（bulkCmCreateMo） （M）.234.4.1.2 大数据量配置管理删除对象子操作（bulkCmDeleteMo） （M）.234.4.1.3 大数据量配置管理修改对象属性值子操作（bulkCmChangeMo） （M）.234.4.2 配置数据文件中子操作的排序规则.244.4.2.1 下载文件.244.4.2.2 上载文件.245 参考文献.256 修订历史.25移动通信网网络管理接口技术规范 大数据量配置管理接口分析III 前言本规范是移动通信网网络管理接口技术规范系列标准中的第三项的子项。该系列标准预计分为三部分：基本原则、厂商网元管理系

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

9、据量配置管理接口分析 ，是参考国际电信联盟电信标准部（ITU-T）的相关建议、3GPP 相关建议以及对象管理组织OMG 的有关规范，并依据中国移动通信集团公司的移动通信网网络管理需求编制而成的。本规范由中国移动通信集团公司网络部提出并归口本规范起草单位：中国移动通信集团公司网络部，北京邮电大学本规范主要起草人：李冶文、王烨、徐海东、魏丽红姚羿志、芮兰兰、李文璟本规范解释单位：中国移动通信集团公司网络部本规范由中国移动通信集团公司 XXX 号文发布移动通信网网络管理接口技术规范 大数据量配置管理接口分析1移动通信网网络管理接口技术规范移动通信网网络管理接口技术规范- 大数据量配置管理接口分析大数

10、据量配置管理接口分析1范围本规范规定了移动通信网网络管理接口中与网络技术无关的大数据量配置管理部分的管理接口分析。是对移动通信网网络管理接口技术规范 大数据量配置管理接口功能需求的细化分析。本规范适用于对移动通信网网络管理接口的规划和设计。2规范性引用文件下列文件中的条款通过本规范的引用而成为本规范的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本规范，然而，鼓励根据本规范达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本规范。移动通信网网络管理接口技术规范 基本原则移动通信网网络管理接口技术规范 大数据量配置管理接

11、口功能需求移动通信网网络管理接口技术规范 公共管理接口分析3术语、定义和缩略语3.1缩略语下列缩略语适用于本规范。CORBA公共对象请求代理体系结构Common Object Request Broker ArchitectureIRP集成参考点Integrated Reference PointNMS网络管理系统Network Management SystemNE网元Network ElementQoS服务质量Quality of Service4大数据量配置管理接口分析4.1管理对象类图在大数据量管理中，定义了管理对象类BulkCMIRP对象，用来完成大数据量的配置管理功能。对象类图如下

12、所示，其中GenericIRP和ManagedGenericIRP对象在移动通信网网络管理接口技术规范 公共管理接口分析中定义。大数据量配置管理有三种功能提供方式：简单上行大数据量配置管理，可控上行大数据量配置管理，可控上行和下行大数据量配置管理。网管系统可根据实际需要进行选择，具体选择哪一种方式不在本规范定义范围内。移动通信网网络管理接口技术规范 大数据量配置管理接口分析2BulkCMPassive+ upload()BulkCMIRPNotification_1+ notifySessionStateChanged()SimpleUploadBulkCMIRP图 1简单上行大数据量配置管理

13、对象类图BulkCMPassive+ upload()BulkCMSession+ startSession()+ endSession()+ getSessionIds()+ getSessionStatus()+ getSessionLog()+ abortSessionOperation()BulkCMIRPNotification_2+ notifyGetSessionLogEnded()BulkCMIRPNotification_1+ notifySessionStateChanged()ControlledUploadBulkCMIRP图 2可控上行大数据量配置管理对象类图移动通信

14、网网络管理接口技术规范 大数据量配置管理接口分析3BulkCMPassive+ upload()BulkCMSession+ startSession()+ endSession()+ getSessionIds()+ getSessionStatus()+ getSessionLog()+ abortSessionOperation()BulkCMActive+ download()+ activate()+ fallback()+ validate() + preactive()BulkCMIRPNotification_2+ notifyGetSessionLogEnded()BulkC

15、MIRPNotification_1+ notifySessionStateChanged()BulkCMIRP图 3可控上行和下行大数据量配置管理对象类图4.2管理对象类分析4.2.1SimpleUploadBulkCMIRP 类4.2.1.1SimpleUploadBulkCMIRP 类描述SimpleUploadBulkCMIRP对象是用于简单上行大数据量配置管理的控制对象，完成对大数据量配置管理数据和资产管理数据的简单上行管理。简单上行不需要建立显性的会话来控制Manager上载资源数据。4.2.1.2操作BulkCMPassive: 上载 upload（M）4.2.1.3通知Bulk

16、CMNotification_1: 会话状态改变通知 notifySessionStateChanged（M）4.2.2ControlledUploadBulkCMIRP 类4.2.2.1ControlledUploadBulkCMIRP 类描述ControlledUploadBulkCMIRP 对象是用于可控上行大数据量配置管理的控制对象，完成对大数据量配置管理数据和资产管理数据的可控上行管理。可控上行要求建立显性的会话来控制 Manager 上载资源信息。4.2.2.2操作BulkCMPassive: 上载 upload（M）BulkCMSession: 开启会话 startSession

17、（M）结束会话 endSession（M）移动通信网网络管理接口技术规范 大数据量配置管理接口分析4中断会话操作 abortSessionOperation（M）获取会话标识 getSessionIds（M）获取会话状态 getSessionStatus（M）获取会话日志 getSessionLog（M）4.2.2.3通知BulkCMNotification_1: 会话状态改变通知 notifySessionStateChanged（M）BulkCMNotification_2: 获取会话日志结束通知 notifyGetSessionLogEnded（M）4.2.3BulkCM Control

18、led Upload & Provisioning 类4.2.3.1BulkCM Controlled Upload & Provisioning 类描述BulkCM Controlled Upload & Provisioning对象是用于可控上行和下行大数据量配置管理的控制对象，完成对大数据量配置管理数据和资产管理数据的可控上行和下行管理。可控上行和下行要求建立显性的会话来控制Manager上载和指配资源信息。4.2.3.2操作BulkCMPassive: 上载upload（M）BulkCMSession: 开启会话startSession（M）结束会话endSes

19、sion（M）中断会话操作abortSessionOperation（M）获取会话标识getSessionIds（M）获取会话状态getSessionStatus（M）获取会话日志getSessionLog（M）BulkCMActive: 下载download（M）验证validate（M）预激活preactivate（O）回卷fallback（M）4.2.3.3通知BulkCMNotification_1: 会话状态改变通知notifySessionStateChanged（M）BulkCMNotification_2: 获取会话日志结束通知notifyGetSessionLogEnded（

20、M）4.2.4操作描述4.2.4.1开启会话 startSession（M）行为行为“Manager 调用该操作来开启一个会话状态机，在 Agent 中初始化与该会话相关的临时资源。”输入参数输入参数sessionId“参数 sessionId 标识了这个新的会话。 ” 输出参数输出参数移动通信网网络管理接口技术规范 大数据量配置管理接口分析5 无 前提条件前提条件 命题 1: “sessionId 当前不在使用中。 ”后继条件后继条件如果 Agent 成功开启会话，并准备好处理与此会话关联的其他操作，会话状态为 IDLE，则result=“success”。如果操作失败，则 result=“

21、failure”返回值返回值result“返回值 result 标识操作的成功与否。 ” 异常异常如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果前提条件命题 1 不成立，则应扔出异常：“SessionIdInUseException”；如果达到了允许的最大的会话数，则应扔出异常：“MaxSessionReachedException”；如果返回其他原因的异常，则应扔出异常：“StartSessionException”。4.2.4.2结束会话 endSession（M）行为行为“Manager 调用该操作来结束一个会话状态机，在 Agent 中删除与该会话相关的文

22、件（如BulkCM 文件、会话日志文件） ，并释放系统中相关的资源。如果之前调用过“预激活”操作，结束会话将释放分配给该“预激活”的所有内部本地资源。如果会话状态为“正在进行（in_progress） ” ， （如正在上载，正在下载和正在激活） ，结束会话将被拒绝。 ”输入参数输入参数sessionId“参数 sessionId 标识了这个指定的要结束的会话” 输出参数输出参数无 前提条件前提条件 命题 1: “该会话已经开启，并且不处在“正在进行（in_progress） ”的状态。 ”后继条件后继条件如果操作成功，该会话结束，该 sessionId 不再处于使用中，则 result=“su

23、ccess”。 如果操作失败，则 result=“failure”返回值返回值result“返回值 result 标识操作的成功与否。 ” 异常异常如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”；移动通信网网络管理接口技术规范 大数据量配置管理接口分析6如果前提条件命题1不成立，则应扔出异常：“NotValidInCurrentStateException”；如果返回其他原因的异常，则应扔出异常：“EndSessionException”。4.2.4.3中断会话操作 abo

24、rtSessionOperation（M）行为行为“Manager 调用该操作请求 Agent 中断一个当前活跃的异步操作，中断将使会话状态机退出当前的状态，进入另一个新的状态。 ”输入参数输入参数sessionId“参数 sessionId 标识了这个指定的要中断操作的会话。 ” 输出参数输出参数无 前提条件前提条件 命题 1: “该会话已经开启，并且处于“正在进行（in_progress） ”的状态。 ”后继条件后继条件如果操作成功，状态的迁移见 4.3 节，则 result=“success”。 如果操作失败，则 result=“failure”返回值返回值result“返回值 resu

25、lt 标识操作的成功与否。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”；如果前提条件命题1不成立，则应扔出异常：“NotValidInCurrentStateException”；如果返回其他原因的异常，则应扔出异常：“EndSessionException”。4.2.4.4获取会话标识 getSessionIds（M）行为行为“Manager 调用该操作向 Agent 获取当前已开启会话的 sessionId 的列表。 ”输入参数输入参数无 输出参数输出

26、参数sessionIdList“参数 sessionIdList 定义了 Agent 当前已开启会话的 sessionId 的列表。 ” 前提条件前提条件 无后继条件后继条件 如果操作成功，则 result=“success” 如果操作失败，则 result=“failure”移动通信网网络管理接口技术规范 大数据量配置管理接口分析7返回值返回值result“返回值 result 标识操作的成功与否。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果返回其他原因的异常，则应扔出异常：“GetSessionIdsException”。4.2.4.5获取会

27、话状态 getSessionStatus（M）行为行为“Manager 调用该操作向 Agent 获取当前的会话状态。该操作可以在任何会话状态下调用，并且不改变当前的会话状态。 ”输入参数输入参数sessionId“参数 sessionId 标识了这个指定的会话。 ” 输出参数输出参数 sessionState“参数 sessionState 定义了当前的会话状态。 ” 前提条件前提条件 命题 1: “该会话已成功开启,并且没有被结束。 ”后继条件后继条件无返回值返回值result“返回值 result 标识操作的成功与否。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidPa

28、rameter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”；如果返回其他原因的异常，则应扔出异常：“GetSessionStatusException”。4.2.4.6获取会话日志 getSessionLog（M）行为行为“Manager 调用该操作向 Agent 获取指定会话的与配置数据文件操作关联的活动结果的日志。该操作可以在任何会话状态下调用，并且不改变当前的会话状态。 ”输入参数输入参数sessionId“参数 sessionId 标识了这个指定的会话。 ”logFileReference“参数 logFileReference

29、定义了 Manager 中要存放结果的地址和文件名。 ”contentType“参数 contentType 定义了要获取的文件内容，可以为：移动通信网网络管理接口技术规范 大数据量配置管理接口分析8（a）包含错误信息在内完整日志；（b）仅包含错误信息。 ” 输出参数输出参数无 前提条件前提条件 命题 1: “该会话已成功开启,并且没有被结束。 ”后继条件后继条件如果操作成功，且 Agent 将要开始向 Manager 中指定的地址和文件中写日志的内容，则result=“success”。 如果操作失败，则 result=“failure”返回值返回值result“返回值 result 标识操

30、作的成功与否。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”；如果URL的格式不合法，则应扔出异常：“IllegalURLFormatException”；如果返回其他原因的异常，则应扔出异常：“GetSessionLogException”。4.2.4.7上载 upload（M）行为行为“Manager 调用该操作请求 Agent 创建一个包含配置数据的文件并将这个文件传送到指定的全局唯一的数据文件引用。 ”输入参数输入参数sessionId“参数 ses

31、sionId 标识了这个与配置数据文件上载相关联的会话。 ”uploadDataFileReference“参数 uploadDataFileReference 定义了一个全局唯一的文件引用，这个文件引用标识了配置数据文件将要上载和存储的位置。 ”baseObjectInstance“参数 baseObjectInstance 是基对象实例标识符，定义了开始搜索的管理对象。 ”scope“参数 scope 定义了搜索的包含层次。 ”搜索将从 baseObjectInstance 指定的基对象开始，将要执行的搜索层次可以是：1） 仅为基对象本身2） 基对象的第 n 层从属对象3） 基对象以及到其

32、第 n 层（包括第 n 层）的所有从属对象4） 基对象及其所有的从属对象filter“参数 filter 定义了参数 scope 所选择对象的一个过滤条件。如果 filter 为空，将包含scope 所定义的所有对象，一个过滤条件包括一个或几个联合使用逻辑运算 AND，OR 和移动通信网网络管理接口技术规范 大数据量配置管理接口分析9NOT 的命题。每个命题是关于“属性是否存在，属性值比较（大于 X，小于 Y）和对象类”的逻辑表达式。 ” 输出参数输出参数无 前提条件前提条件可控上行或可控上行和下行： 命题 1: “会话已经显性地（explicitly）成功开启并且当前会话状态为 IDLE 或

33、UPLOAD_FAILED，准备好处理该会话的第一个操作或者重复这个操作。 ”简单上行：命题 1: “sessionId 当前不在使用中，隐性地（implicitly）开启会话，准备好处理该会话的第一个操作或者重复这个操作。 ”后继条件后继条件如果操作成功，状态为“正在上载（UPLOAD_IN_PROGRESS） ” ，Agent 已经成功开始了所需配置数据的上载，则 result=“success”。 如果操作失败，则 result=“failure”返回值返回值result“返回值 result 标识操作的成功与否。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidPara

34、meter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”；如果达到了允许的最大的会话数，则应扔出异常：“MaxSessionReachedException”；如果前提条件命题1不成立，则应扔出异常：“NotValidInCurrentStateException”；如果对一个文件引用，同时进行多个上载操作，则应扔出异常：“ConcurrencyException”；如果DN的格式不合法，则应扔出异常：“IllegalDNFormatException”；如果filter的格式不合法，则应扔出异常：“IllegalFilterFormatE

35、xception”；如果scope的格式不合法，则应扔出异常：“IllegalScopeTypeException”；如果scope的级别不合法，则应扔出异常：“IllegalScopeLevelException”；如果URL的格式不合法，则应扔出异常：“IllegalURLFormatException”；如果返回其他原因的异常，则应扔出异常：“UploadException”。4.2.4.8下载 download（M）行为行为移动通信网网络管理接口技术规范 大数据量配置管理接口分析10“Manager 调用该操作请求 Agent 来下载并管理一个包含配置数据的文件。Agent 从指定的全

36、局唯一的数据文件引用中获取这个配置数据文件。 ”在下载过程中 Agent 应该检查下载的配置数据文件的 Schema 一致性，确保没有错误发生；在下载过程中 Agent 不需要检查已经下载的配置数据的语义错误。输入参数输入参数sessionId“参数 sessionId 标识了这个与配置数据文件下载相关联的会话。 ”downloadDataFileReference“参数 downloadDataFileReference 定义了数据可以取到并下载的一个全局唯一的文件引用” 输出参数输出参数无 前提条件前提条件 命题 1: “该会话处于闲置（IDLE）状态，该会话已成功开启，并且准备好处理该会

37、话的第一个操作或者重复这个操作。 ”后继条件后继条件如果操作成功，状态为“正在下载（UDOWNLOAD_IN_PROGRESS） ” ，Agent 已成功开始下载配置数据文件，则 result=“success”。 如果操作失败，则 result=“failure”返回值返回值result“返回值 result 标识操作的成功与否。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”；如果达到了允许的最大的会话数，则应扔出异常：“MaxSessionReached

38、Exception”；如果URL的格式不合法，则应扔出异常：“IllegalURLFormatException”；如果前提条件命题1不成立，则应扔出异常：“NotValidInCurrentStateException”；如果返回其他原因的异常，则应扔出异常：“DownloadException”。4.2.4.9验证 validate（M）行为行为“Manager 调用该操作请求 Agent 验证先前已经下载的配置数据。使用该操作可以在Manager 请求“预激活”或“激活”之前检查与先前已经下载的配置数据相关的错误。 ”在验证阶段，Agent 应该检查先前已经下载的配置数据的语法和语义错误

39、。输入参数输入参数sessionId“参数 sessionId 标识了这个与要验证的配置数据相关联的会话。 ”activationMode（O）移动通信网网络管理接口技术规范 大数据量配置管理接口分析11“参数 activationMode 定义了是否需要指定一个激活方式。取值为下面选项之一：a） least service impact：业务受影响最小b） least elapse time：最短耗用时间 输出参数输出参数无 前提条件前提条件 命题 1: “Agent 已成功开启该会话，且已经进行“下载”操作或者重复进行“下载”操作。 ”后继条件后继条件如果操作成功，状态为“正在验证（VAL

40、IDATE_IN_PROGRESS） ” ，Agent 开始验证已下载的配置数据，则 result=“success”。 如果操作失败，则 result=“failure”返回值返回值result“返回值 result 标识操作的成功与否。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”；如果前提条件命题1不成立，则应扔出异常：“NotValidInCurrentStateException”；如果对一个网元，同时进行多个验证操作，则应扔出异常：“Concur

41、rencyException”；如果激活方式不合法，则应扔出异常：“IllegalActivationModeException”；如果返回其他原因的异常，则应扔出异常：“ValidateException”。4.2.4.10预激活 preactivate（O）行为行为“Manager 调用该操作请求 Agent 预激活先前已经下载的配置数据。 ”在预激活阶段，Agent 应该检查已下载配置数据的语义的正确性，如果前面的“验证”操作没有正确执行，还必须检查语法的正确性。输入参数输入参数sessionId“参数 sessionId 标识了这个与预激活配置数据相关联的会话。 ”verificati

42、onMode“参数 verificationMode 定义了供选择的验证模式。 ”取值为下面选项之一：a） full checking：全面检查，检查应该尽可能的全面，以最大限度地确保后续的“激活”操作能成功完成。b） limited checking：限制检查，Agent 能很快完成的检查仍然执行，省略那些将会执行时间延迟很大的检查。activationMode移动通信网网络管理接口技术规范 大数据量配置管理接口分析12“参数 activationMode 定义了是否需要指定一个激活方式。取值为下面选项之一：a） least service impact：业务受影响最小b） least el

43、apse time：最短耗用时间fallbackEnabled“参数 fallbackEnabled 标识了在“预激活”之前是否初始化并允许一个“回卷”操作。 ” 输出参数输出参数无 前提条件前提条件 命题 1: “Agent 已成功开启该会话，且已经进行“下载”操作或者重复进行“下载”操作。 ”后继条件后继条件如果操作成功，状态为“正在预激活（PREACTIVATION_IN_PROGRESS） ” ，Agent 开始预激活已下载的配置数据，则 result=“success”。 如果操作失败，则 result=“failure”返回值返回值result“返回值 result 标识操作的成功

44、与否。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”；如果前提条件命题1不成立，则应扔出异常：“NotValidInCurrentStateException”；如果对一个网元，同时进行多个预激活操作，则应扔出异常：“ConcurrencyException”；如果激活方式不合法，则应扔出异常：“IllegalActivationModeException”；如果验证模式不合法，则应扔出异常：“IllegalVerificationModeException

45、”；如果返回其他原因的异常，则应扔出异常：“PreactivateException”。4.2.4.11激活 activate（M）行为行为“Manager 调用该操作请求 Agent 激活先前已经下载配置数据。 ”如果在前面的阶段没有成功执行验证操作，则在“激活”阶段要进行与“验证”和“预激活”阶段同样的检查；如果配置数据的上下文可能发生变化，还要进行重复检查。输入参数输入参数sessionId“参数 sessionId 标识了这个与要激活的配置数据相关联的会话。 ”activationMode“参数 activationMode 定义了是否需要指定一个激活方式。取值为下面选项之一：c） l

46、east service impact：业务受影响最小移动通信网网络管理接口技术规范 大数据量配置管理接口分析13d） least elapse time：最短耗用时间fallbackEnabled“参数 fallbackEnabled 标识了在“激活”之前是否初始化并允许一个“回卷”操作。 ” 输出参数输出参数无 前提条件前提条件 命题 1: “Agent 已成功开启该会话，且已经进行“下载”操作或者重复进行“下载”操作。 ”后继条件后继条件如果操作成功，且状态为“正在激活（ACTIVATE_IN_PROGRESS） ” ，Agent 开始激活已下载的配置数据，则 result=“succe

47、ss”。 如果操作失败，则 result=“failure”返回值返回值result“返回值 result 标识操作的成功与否。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”； 如果前提条件命题1不成立，则应扔出异常：“NotValidInCurrentStateException”；如果对一个网元，同时进行多个激活操作，则应扔出异常：“ConcurrencyException”；如果激活方式不合法，则应扔出异常：“IllegalActivationMode

48、Exception”；如果返回其他原因的异常，则应扔出异常：“ActivateException”。4.2.4.12回卷 fallback（M）行为行为“Manager 调用该操作请求 Agent 在先前进行的“预激活”或“激活”操作成功结束之后，采取尽力而为（best effort）的策略，恢复网络的配置数据。 ”输入参数输入参数sessionId“参数 sessionId 标识了这个与要回卷相关联的会话。 ” 输出参数输出参数无 前提条件前提条件 命题 1: “Agent 已成功开启会话，且“回卷”操作被允许，见 4.3 节。当前会话状态为：PREACTIVATION_COMPLETED

49、或 PREACTIVATION_PARTLY_REALISED 或ACTIVATION_COMPLETED 或 ACTIVATION_PARTLY_REALISED 或FALLBACK_PARTLY_REALISED 或 FALLBACK_FAILED。 ”后继条件后继条件如果操作成功，状态为“正在回卷（FALLBACK_IN_PROGRESS） ” ，Agent 开始“回卷” ，移动通信网网络管理接口技术规范 大数据量配置管理接口分析14则 result=“success”。 如果操作失败，则 result=“failure”返回值返回值result“返回值 result 标识操作的成功与否

50、。 ” 异常异常 如果输入参数不合法，则应扔出异常：“InvalidParameter”；如果sessionId未知，则应扔出异常：“UnknownSessionIdException”；如果没有与此会话相关的可以回卷的数据，则应扔出异常：“NoFallbackException”； 如果前提条件命题1不成立，则应扔出异常：“NotValidInCurrentStateException”；如果对于一个网元，同时进行多个回卷操作，则应扔出异常：“ConcurrencyException”；如果返回其他原因的异常，则应扔出异常：“FallbackException”。4.2.5通知描述4.2.5

51、.1会话状态改变通知 notifySessionStateChanged（M）Agent通知Manager一个大数据量-配置数据文件会话的状态已经改变。会话状态改变通知格式如下表所示。表 1会话状态改变通知格式移动通信网网络管理接口技术规范 大数据量配置管理接口分析15参数名称参数名称中文名称中文名称限定限定说明说明objectClass对象类名M，Y发出通知的管理对象类，即BulkCMIRP对象类。objectInstance对象实例标识符M，Y该参数对应objectClass指定类的实例。notificationId通知号O，N通知标识符，用来唯一标识通知，可进行通知的关联。eventTi

52、me事件时间M，Y指明事件发生时间，即会话状态改变的时间。systemDN系统识别名 C，Y产生通知的被管系统（即IRPAgent）标识。notificationType通知类型M，Y上报的通知的类型，即会话状态改变通知（notifySessionStateChanged）。sessionId会话标识M，N会话的标识。sourceIndicator源标识符O ，N表示引起该通知的源操作，可取值如下：a)被管资源的操作（Resource_operation）：即该通知是由于被管资源内部操作引发的。b)网管操作(Management_operation)：即该通知是由于 Manager 下发的网管

53、操作而引发的。c)未知(Unknown)：不清楚引发通知的具体原因。sessionState会话状态M，N标识了引起这个通知的会话的过渡状态，可取值（枚举）如下：1） 上载失败（Upload Failed）2） 上载完成（Upload Completed）3） 下载失败（Download Failed）4） 下载失败（Download Completed）5） 验证失败（Validation Failed）6） 验证完成（Validation Completed）7） 预激活失败（Preactivation Failed）8） 预激活部分完成（Preactivation Partly Real

54、ised）9） 预激活完成（Preactivation Completed）10）激活失败（Activation Failed）11）激活部分完成（Activation Partly Realised）12）激活完成（Activation Completed）13）回卷失败（Fallback Failed）14）回卷部分完成（Fallback Partly Realised）15）回卷完成（Fallback Completed）4.2.5.2获取会话日志结束通知 notifyGetSessionLogEnded（M）Agent通知Manager一个配置数据文件会话的“获取会话日志”操作成功结束

55、，或不成功结束。获取会话日志结束通知格式如下表所示。表 2获取会话日志结束通知格式移动通信网网络管理接口技术规范 大数据量配置管理接口分析16参数名称参数名称中文名称中文名称限定限定说明说明objectClass对象类名M，Y发出通知的管理对象类，即BulkCMIRP对象类。objectInstance对象实例标识符M，Y该参数对应objectClass指定类的实例。notificationId通知号O，N通知标识符，用来唯一标识通知，可进行通知的关联。eventTime事件时间M，Y指明事件发生时间，即会话日志结束的时间。 systemDN系统识别名 C，Y产生通知的被管系统（即IRPAge

56、nt）标识。notificationType通知类型M，Y上报的通知的类型，即获取会话日志结束通知（notifyGetSessionLogEnded）。sessionId会话标识M，N会话的标识。sourceIndicator源标识符O ，N表示引起该通知的源操作，可取值如下：d)被管资源的操作（Resource_operation）：即该通知是由于被管资源内部操作引发的。e)网管操作(Management_operation)：即该通知是由于 Manager 下发的网管操作而引发的。f)未知(Unknown)：不清楚引发通知的具体原因。sessionLogStatus会话日志状态M，N标识了

57、引起通知的事件，可取值（Boolean）如下：true：获取会话日志成功结束；false：获取会话日志不成功结束。4.3状态机一个“开启会话”操作将创建一个状态机，一个会话在“闲置阶段（IDLE_PHASE）”的初始状态为IDLE。“结束会话”将删除一个不处在“正在进行（in_progress）”状态的状态机。详细信息在子状态机中定义。下图为状态机的状态转换图。移动通信网网络管理接口技术规范 大数据量配置管理接口分析17图 4可控上行及可控上行和下行状态机Uploadsubstate machine ofUPLOAD_PHASE_SIMPLE_UPLOAD图 5简单上行状态机4.3.1子状态机

58、移动通信网网络管理接口技术规范 大数据量配置管理接口分析18下图中实线表示由于外部事件引起的状态转移，虚线表示由于内部事件引起的状态转移。external eventSTATE2STATE1STATE2STATE1internal event/decision 图 6状态转移的原因描述如果该会话处于“上载阶段”，则不能触发该会话的其他阶段的状态变化，同样如果该会话处于“上载阶段”之外的其他阶段，也不能触发该会话在“上载阶段”的状态变化。4.3.1.1上载阶段（Upload Phase）对可控上行及可控上行和下行，当Manager成功触发“上载”操作后，且原会话状态为IDLE（空闲）或UPLOA

59、D_FAILED（上载失败），该会话进入上载阶段。可控上行及可控上行和下行的上载阶段子状态机入下图所示：uploadendSessionabortSessionOperationUPLOAD_IN_PROGRESSuploadUPLOAD_FAILEDUPLOAD_COMPLETEDUPLOAD_PHASEInternal: uploadfailedInternal: uploadsuccessful图 7子状态机上载阶段 Upload Phase如果上载过程成功，则指示“上载完成（UPLOAD_COMPLETED）”状态，如果上载过程失败可以在“上载失败（UPLOAD_FAILED）”状态下

60、重试上载操作。对简单上行，当Manager成功触发“上载”操作后，Manager指定一个空闲sessionId，隐形开启会话，由空状态进入上载阶段。简单上行的上载阶段子状态机入下图所示：移动通信网网络管理接口技术规范 大数据量配置管理接口分析19Upload (Simple Upload)Internal: State ChangeNotification sentUPLOAD_IN_PROGRESSUPLOAD_FAILEDUPLOAD_COMPLETEDUPLOAD_PHASE_SIMPLE_UPLOADInternal: uploadfailedInternal: uploadsuccessful图 8子状态机简单上行上载