mfs gom sw component description b9 ed02.pdf

382
ED 02 RELEASED Evolium 3bk09622jaaapezza-ed2rl.doc 02-08-27 3BK 09622 JAAA PEZZA Y 1/2 Site VELIZY EVOLIUM SAS Originators O&M Team MFS GOM SW COMPONENT DESCRIPTION RELEASE B9 Domain : ALCATEL 900/BSS Division : PRODUCT DEFINITION Rubric : MFS Type : DETAILED SPECIFICATION AND DESIGN Distribution Codes Internal : External : ABSTRACT This document describes the software design of the GPRS Operation & Maintenance (GOM) Agent in the MFS B9 MR3. It applies to BSS release B9. Approvals Name App. D.ALBONICO L.RAPHALEN Name App.

Upload: vu-anh-tuan

Post on 14-Nov-2015

264 views

Category:

Documents


1 download

TRANSCRIPT

  • ED 02 RELEASED

    Evolium 3bk09622jaaapezza-ed2rl.doc 02-08-27

    3BK 09622 JAAA PEZZA Y 1/2

    Site

    VELIZY EVOLIUM SAS

    Originators

    O&M Team

    MFS

    GOM SW COMPONENT DESCRIPTION

    RELEASE B9

    Domain : ALCATEL 900/BSS Division : PRODUCT DEFINITION Rubric : MFS Type : DETAILED SPECIFICATION AND DESIGN Distribution Codes Internal : External :

    ABSTRACT

    This document describes the software design of the GPRS Operation & Maintenance (GOM) Agent in the MFS B9 MR3. It applies to BSS release B9.

    Approvals

    Name App.

    D.ALBONICO L.RAPHALEN

    Name App.

  • ED 02 RELEASED

    Evolium 3bk09622jaaapezza-ed2rl.doc 02-08-27

    3BK 09622 JAAA PEZZA Y 2/2

    REVIEW

    Ed. 01 04/112004 Approved with review report GOM SW COMPONENT DESCRIPTION EVOLIUM/MRD/CNS/2004-4178

    HISTORY

    Ed. 01 Proposal 01 14/10/2004

    Creation issued from 3BKA09622JAAAPEZZA

    Ed. 01 RELEASED 04/11/2004 Remarks EVOLIUM/MRD/MFS/2004-4178

    Ed. 02 Proposal 02 12/05/2005 Creation issued from 3BKA09622JAAAPEZZA

    Ed. 02 RELEASED 13/09/2005 Remarks EVOLIUM/MRD/MFS/2005-4694

    INTERNAL REFERENCED DOCUMENTS

    Not applicable.

    FOR INTERNAL USE ONLY

    Not applicable.

    END OF DOCUMENT

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 1/380

    DETAILED SPECIFICATION AND DESIGN

    TABLE OF CONTENTS

    SCOPE................................................................................................................................................. 16 1 MAIN FEATURES........................................................................................................................... 17 2 DATA MODEL ................................................................................................................................ 19

    2.1 CMPS data model............................................................................................................... 19 2.2 Alarms................................................................................................................................. 19

    3 EXTERNAL INTERFACES............................................................................................................. 20 3.1 GEM Interface..................................................................................................................... 20

    3.1.1 Interface with subscription ................................................................................................... 20 3.1.2 Interface without subscription .............................................................................................. 21

    3.2 LXPU Interface ................................................................................................................... 21 3.3 GAM interface..................................................................................................................... 21 3.4 GPM interface..................................................................................................................... 22 3.5 Administrative interface.................................................................................................... 22

    4 ARCHITECTURE............................................................................................................................ 23 4.1 Overview ............................................................................................................................. 23

    4.1.1 Communications flows and constraints ............................................................................... 24 4.1.2 GOM internal Architecture ................................................................................................... 24

    4.2 Administrative Server........................................................................................................ 25 4.2.1 Managed Objects................................................................................................................. 26 4.2.2 Operations ........................................................................................................................... 27

    4.3 Object Control Server........................................................................................................ 27 4.3.1 Reception Thread Role........................................................................................................ 28 4.3.2 LXPUn Threads Role........................................................................................................... 28

    4.3.2.1 LXPU discovery ........................................................................................................... 29 4.3.2.2 Global LXPU configuration .......................................................................................... 29 4.3.2.3 Radio massive configuration change .......................................................................... 29 4.3.2.4 Resource supervision .................................................................................................. 29 4.3.2.5 On-line LXPU configuration ......................................................................................... 30 4.3.2.6 Synchronisation after a control station switchover ...................................................... 30 4.3.2.7 Initialisation of the LXPUn thread ................................................................................ 30

    4.3.3 Alarm thread Role ................................................................................................................ 30 4.4 GOM Interactions ............................................................................................................... 31

    4.4.1 Overview .............................................................................................................................. 31 4.4.1.1 Interactions in configuration mode............................................................................... 31 4.4.1.2 Interactions in site mode.............................................................................................. 31

    4.4.2 Internal/External interaction scenario .................................................................................. 34 4.4.2.1 Interactions with LXPU ................................................................................................ 34 4.4.2.2 Interaction between GOM and GEM ........................................................................... 36 4.4.2.3 Interaction with GAM ................................................................................................... 38 4.4.2.4 Interaction with GPM ................................................................................................... 39

    4.4.3 Interactions between Admin thread and LXPUn threads .................................................... 39 4.4.4 Interactions between Reception thread and LXPUn threads .............................................. 41 4.4.5 Interaction between LXPUn Threads and Alarm Thread..................................................... 41 4.4.6 Interactions between Admin thread and Equipment thread ................................................ 41

    4.5 Internal tables..................................................................................................................... 41

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 2/380

    4.5.1 LXPU Logical Number mapping .......................................................................................... 41 4.5.2 LXPUn thread allocation ...................................................................................................... 42 4.5.3 BssRef / OamRef Table....................................................................................................... 42 4.5.4 Paging Area structures ........................................................................................................ 42

    4.5.4.1 Structure for main of a Bss and for Pilot...................................................................... 43 4.5.4.2 Structure for Main of a La ............................................................................................ 43 4.5.4.3 Structure for Main of a Ra............................................................................................ 44

    4.6 Thread priority.................................................................................................................... 44 4.6.1 Initialisation of the main thread (Admin thread) ................................................................... 45 4.6.2 Initialisation of an lxpu thread .............................................................................................. 46 4.6.3 Initialisation of Alarm thread ................................................................................................ 46

    5 SOFTWARE DESIGN..................................................................................................................... 47 5.1 Software architecture ........................................................................................................ 47

    5.1.1 O&M model .......................................................................................................................... 48 5.1.2 LXPU model......................................................................................................................... 48 5.1.3 Software layers .................................................................................................................... 49 5.1.4 Object identifier .................................................................................................................... 49

    5.2 Packages ............................................................................................................................ 50 5.2.1 Class diagram...................................................................................................................... 52

    5.2.1.1 Rebuild the MIB ........................................................................................................... 56 5.2.1.2 Process CMPS requests ............................................................................................. 57 5.2.1.3 Manage LXPU connections ......................................................................................... 57 5.2.1.4 Send LXPU messages................................................................................................. 57 5.2.1.5 Receive LXPU messages............................................................................................ 57 5.2.1.6 Send LXPU global configuration.................................................................................. 58 5.2.1.7 Radio Massive Configuration Change......................................................................... 58 5.2.1.8 Synchronise on LXPU resource states........................................................................ 58 5.2.1.9 Equipment change notifications................................................................................... 58 5.2.1.10 Alarm registration ................................................................................................ 58 5.2.1.11 Fault Report sending ........................................................................................... 58 5.2.1.12 MultiGpu management ........................................................................................ 58 5.2.1.13 Cells mapping handling ....................................................................................... 59 5.2.1.14 Multi-Interface/Multi version management .......................................................... 60

    5.2.2 OAM package ...................................................................................................................... 60 5.2.2.1 OamDmCore and OamCorePersistent........................................................................ 62 5.2.2.2 OamConstructor .......................................................................................................... 62 5.2.2.3 OamManager class...................................................................................................... 62 5.2.2.4 OamCore class ............................................................................................................ 63 5.2.2.5 OamCmpsConfig class................................................................................................ 65 5.2.2.6 OamCmpsAttribute class............................................................................................. 65 5.2.2.7 OamCmpsTranslatorSet.............................................................................................. 66 5.2.2.8 OamCmpsTranslatorDeclaratorTmpl .......................................................................... 66 5.2.2.9 OamConfirmCtx class.................................................................................................. 66 5.2.2.10 Inter Thread indication......................................................................................... 67 5.2.2.11 Admin thread encapsulation................................................................................ 68

    5.2.3 CML package....................................................................................................................... 69 5.2.3.1 Model ........................................................................................................................... 69 5.2.3.2 BssRef / OamRef Table............................................................................................. 109 5.2.3.3 Use examples ............................................................................................................ 115

    5.2.4 Main package..................................................................................................................... 120 5.2.4.1 Gom class.................................................................................................................. 120 5.2.4.2 Mode, ConfMode and Site classes............................................................................ 121 5.2.4.3 ModeBuilder and ModeBuilderTmpl classes ............................................................. 122 5.2.4.4 GomInitControler class .............................................................................................. 123

    5.2.5 Common packages............................................................................................................ 124 5.2.5.1 Interface packages .................................................................................................... 124 5.2.5.2 Global Package ......................................................................................................... 131

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 3/380

    5.2.5.3 Functional Services Packages .................................................................................. 139 5.2.6 Functional Packages ......................................................................................................... 163

    5.2.6.1 Data Element package .............................................................................................. 164 5.2.6.2 Lxpu package ............................................................................................................ 172 5.2.6.3 Packages related to functional configuration domains.............................................. 178

    6 DYNAMIC BEHAVIOUR............................................................................................................... 220 6.1 Main principles................................................................................................................. 220 6.2 GOM initialisation ............................................................................................................ 221

    6.2.1 Initialization before main entry point. ................................................................................. 223 6.2.1.1 OamXXX class building ............................................................................................. 223 6.2.1.2 Declare OamConstructor........................................................................................... 223 6.2.1.3 Declaration of OamCmpsConfigXXX......................................................................... 224

    6.2.2 CmlXXX class building....................................................................................................... 225 6.2.2.1 Functional automaton declaration ............................................................................. 225 6.2.2.2 Message generator declaration ................................................................................. 226

    6.2.3 DataElementXXX class building ........................................................................................ 227 6.2.3.1 DateElement declaration ........................................................................................... 227 6.2.3.2 DataElementFactory declaration ............................................................................... 228

    6.2.4 DownloadManagerXXX class building............................................................................... 229 6.2.5 Rebuild from DM configuration tables ............................................................................... 230 6.2.6 Connection to GEM............................................................................................................ 231 6.2.7 Connection to GAM and Alarms thread initialization ........................................................ 231 6.2.8 Communication layer initialisation ..................................................................................... 232 6.2.9 GOM start up sequences................................................................................................... 232

    6.2.9.1 In configuration mode ................................................................................................ 232 6.2.9.2 At cold start in site mode ........................................................................................... 233 6.2.9.3 At switchover in site mode......................................................................................... 234 6.2.9.4 at switchover after a migration................................................................................... 235

    6.3 GEM Object management ............................................................................................... 235 6.3.1 Processing messages from GEM ...................................................................................... 235 6.3.2 Board creation.................................................................................................................... 235 6.3.3 Board deletion.................................................................................................................... 236 6.3.4 PcmTtp equipment............................................................................................................. 237 6.3.5 PcmTtp unequipment ( not supported ) ............................................................................. 237

    6.4 Common functionnal scenarii ........................................................................................ 238 6.4.1 Mono lxpu CMPS request processing ............................................................................... 238

    6.4.1.1 Create request ........................................................................................................... 238 6.4.1.2 Set request ................................................................................................................ 241 6.4.1.3 Delete request ........................................................................................................... 243 6.4.1.4 Action request............................................................................................................ 248 6.4.1.5 Internal action management ...................................................................................... 250

    6.4.2 Multi-lxpu CMPS request processing ................................................................................ 252 6.4.2.1 Management in OamCmlAssociator.......................................................................... 252 6.4.2.2 Broadcasted set request............................................................................................ 255 6.4.2.3 Broadcasted delete request....................................................................................... 255

    6.4.3 State management............................................................................................................. 257 6.4.3.1 State management in mono lxpu environment.......................................................... 258 6.4.3.2 State management in multi lxpu environment ........................................................... 258

    6.4.4 Functional timer management ........................................................................................... 259 6.4.4.1 Arming functional timer .............................................................................................. 259 6.4.4.2 Functional timer expiry............................................................................................... 260

    6.4.5 Lxpu registration, and version mapping............................................................................. 260 6.4.5.1 Global registration...................................................................................................... 260 6.4.5.2 Partial reactivation of registration .............................................................................. 263

    6.4.6 LXPU unregistration........................................................................................................... 264 6.4.6.1 Global unregistration.................................................................................................. 264 6.4.6.2 Partial unregistration.................................................................................................. 265

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 4/380

    6.4.7 Request messages creation .............................................................................................. 266 6.4.8 Processing of confirmations configuration......................................................................... 267

    6.4.8.1 During global configuration processing ( Download or MLU )................................... 267 6.4.8.2 During on-line configuration....................................................................................... 269

    6.4.9 Invocation of Lxpu-reset. ................................................................................................... 269 6.4.9.1 Invocation from Lxpu Thread..................................................................................... 270 6.4.9.2 Invocation from Admin Thread .................................................................................. 271

    6.5 Lxpu management ........................................................................................................... 271 6.5.1 Lxpu connection................................................................................................................. 271 6.5.2 Lxpu disconnection ............................................................................................................ 271

    6.5.2.1 Generic behaviour in Cml layer ................................................................................. 272 6.5.2.2 Generic behaviour in CmlXXX classes...................................................................... 272

    6.5.3 Indication managed at lxpu level ....................................................................................... 272 6.5.4 LXPU global configuration ................................................................................................. 273 6.5.5 Massive radio configuration change .................................................................................. 277 6.5.6 Lxpu version change and propagation in functional model ............................................... 279 6.5.7 Reconnection timer expiry after a switchover.................................................................... 280 6.5.8 Synchronisation on LXPU after control station switchover................................................ 281 6.5.9 resynchronization after migration....................................................................................... 284

    6.6 Particular Processings in functional domain ............................................................... 284 6.6.1 Particular processings in Transport domain ...................................................................... 284

    6.6.1.1 Checks made on transport domain objects during CMPS operations ...................... 284 6.6.1.2 LapDLink registration and unregistration................................................................... 284 6.6.1.3 Registration/unregistration of GicGroups .................................................................. 286 6.6.1.4 ReserveGics action.................................................................................................... 288 6.6.1.5 ReserveLapDLink action ........................................................................................... 292 6.6.1.6 End of LapDLink deletion and impacts on cell management domain ....................... 293 6.6.1.7 End of GicGroup deletion and impacts on cell management domain ....................... 294

    6.6.2 Particular processing in Gb domain................................................................................... 295 6.6.2.1 Checks made on Gb domain objects during CMPS operation.................................. 295 6.6.2.2 Nse registration/unregistration................................................................................... 295 6.6.2.3 Nse deletion............................................................................................................... 297

    6.6.3 Particular processing in radio domain ............................................................................... 298 6.6.3.1 Bss related scenarii ................................................................................................... 298 6.6.3.2 Paging Area and Pilot management.......................................................................... 308 6.6.3.3 Bss reshuffle action and cell mapping in B8.............................................................. 316 6.6.3.4 Reshuffle activation after a cold-startup .................................................................... 325 6.6.3.5 Rebuild of subBss cell list after a switchover ............................................................ 325 6.6.3.6 Bss reshuffle action and cell mapping in B9.............................................................. 327 6.6.3.7 Radio domain resynchronization after a swithover.................................................... 336 6.6.3.8 SubBss last lapDLink deletion ................................................................................... 337 6.6.3.9 SubBss last GicGroup deletion.................................................................................. 338 6.6.3.10 Gsl related scenarii............................................................................................ 338 6.6.3.11 Cell related scenarii ........................................................................................... 343

    7 SINGLE SECURED GB................................................................................................................ 356 7.1 Introduction ...................................................................................................................... 356 7.2 Impact in GOM.................................................................................................................. 356 7.3 Implementation ................................................................................................................ 356 7.4 Class and methods modifications ................................................................................. 358

    7.4.1 Modifications in OamBss for Single Secured Gb. ........................................................... 358 7.4.2 Modifications in CmlNsvc to check the nsVcStateChangeIndreceived from GPU. .... 358 7.4.3 Modifications in ControlStation to enable or disable Single Secured Gb........................ 359 7.4.4 Creation of SecuredGbManager to manage the Single Secured Gb.............................. 359 7.4.5 Modifications in OamCell to change the bvcid mapping computation rule........................ 360 7.4.6 Common methods for mediation between OamBss and SecuredGbManager. ................ 361

    7.5 Sequence diagrams......................................................................................................... 363 7.5.1 Sequence diagram for gb down ...................................................................................... 363

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 5/380

    7.5.2 Sequence diagram for gb up ........................................................................................... 364 7.6 State transition diagrams................................................................................................ 365

    7.6.1 SecuredGbState description.............................................................................................. 365 7.6.2 State transition diagram for Gb down.............................................................................. 366 7.6.3 State transition diagram for Gb up .................................................................................. 366

    8 ALARMS MANAGEMENT............................................................................................................ 367 8.1.1 Object registration/unregistration in(from) RefAlarmTable ................................................ 367 8.1.2 Send alarm to GAM ........................................................................................................... 368

    9 OBJECT MAPPING ON THREADS............................................................................................. 369 10 AUTOMATONS ............................................................................................................................ 370

    10.1 LxpuManager automaton ................................................................................................ 370 10.2 DownloadManager automaton ....................................................................................... 371

    10.2.1 B8 automaton ............................................................................................................ 371 10.3 Admin thread automaton ................................................................................................ 376

    11 INTERACTIONS BETWEEN THREADS...................................................................................... 377 11.1 Messages structure ......................................................................................................... 377

    12 MESSAGES STRUCTURE BETWEEN ADMIN THREAD AND LXPUN THREADS.................. 378 12.1.1 Message between LXPUn threads and Alarm thread ............................................... 380

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 6/380

    TABLE OF FIGURES

    Figure 1: Global MFS O&M Architecture............................................................................................... 17

    Figure 2: GOM external interfaces ........................................................................................................ 23

    Figure 3: GOM architecture................................................................................................................... 25

    Figure 4: GOM interactions in configuration mode ............................................................................... 31

    Figure 5: GOM interactions in site mode............................................................................................... 34

    Figure 6: Interactions between threads on LXPU messages................................................................ 34

    Figure 7: BscVersionChange ................................................................................................................ 35

    Figure 8: Interactions between threads on GEM messages................................................................. 36

    Figure 9: Interactions with GEM to ask a LXPU reset........................................................................... 36

    Figure 10: Interactions with GEM at startup.......................................................................................... 37

    Figure 11: Interactions with GEM at startup after a switchover ............................................................ 37

    Figure 12 migration or not migration ..................................................................................................... 38

    Figure 13: Interactions with GAM to send fault reports......................................................................... 38

    Figure 14: Mapping between O&M and LXPU models ......................................................................... 47

    Figure 15: Software layers structure ..................................................................................................... 49

    Figure 16: Component diagram ............................................................................................................ 51

    Figure 17: Functional dependency........................................................................................................ 52

    Figure 18: Main classes diagram .......................................................................................................... 53

    Figure 19: OAM package ...................................................................................................................... 61

    Figure 20 : Lxpu thread to Admin thread generic indication ................................................................. 67

    Figure 21 : CmpsProxy class ................................................................................................................ 68

    Figure 22: CmlCore and CmlCmpsAttribute classes. ........................................................................... 69

    Figure 23: Cml contextes and abstract management. .......................................................................... 75

    Figure 24 CmlOperationConfirmCtx attributes...................................................................................... 75

    Figure 25 CmlOperationConfirmCtx methods....................................................................................... 76

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 7/380

    Figure 26 CmlInternalActionCtx class ................................................................................................... 78

    Figure 27 CmlInternalActionCtx methods. ............................................................................................ 79

    Figure 28: public CML interface of Message ........................................................................................ 79

    Figure 29 DataElement attributes. ........................................................................................................ 81

    Figure 30 CallBackMsg methods .......................................................................................................... 83

    Figure 31 DataElementAbstractBuilder attributes................................................................................. 84

    Figure 32 DataElementAbstractBuilder method.................................................................................... 84

    Figure 33 DataElementBuilderTmpl class parameter ........................................................................... 85

    Figure 34 DataElementBuilderTmpl method......................................................................................... 85

    Figure 35 DataElementFactory attributes. ............................................................................................ 85

    Figure 36 DataElementFactory methods. ............................................................................................. 86

    Figure 37 DataElementFactoryManager attributes ............................................................................... 86

    Figure 38 DataElementFactoryManager methods ................................................................................ 87

    Figure 39 DataElementFactoryDeclarator attribute. ............................................................................. 87

    Figure 40 DataElementFactoryDeclarator method. .............................................................................. 87

    Figure 41: CmlManager class ............................................................................................................... 88

    Figure 42: Classes managing the LXPU.............................................................................................. 92

    Figure 43 Lxpu management and domain management .................................................................... 104

    Figure 44 Indication for lxpu thread..................................................................................................... 109

    Figure 45: Align State transition diagram............................................................................................ 113

    Figure 46: Lxpu State transition diagram ............................................................................................ 115

    Figure 47: example of a SET operation on a Bearer channel............................................................. 116

    Figure 48: Example of a Bearer channel create. ................................................................................ 118

    Figure 49 GOM class attibutes............................................................................................................ 121

    Figure 50 GOM class methods. .......................................................................................................... 121

    Figure 51 Mode attributes ................................................................................................................... 122

    Figure 52 Mode methods. ................................................................................................................... 122

    Figure 53 ModeBuilder attribute.......................................................................................................... 122

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 8/380

    Figure 54 ModeBuilder methods ......................................................................................................... 123

    Figure 55 GomInitControler attributes................................................................................................. 123

    Figure 56 GomInitControler methods.................................................................................................. 124

    Figure 57 Gem interface class model ................................................................................................. 125

    Figure 58 Gam interface class model ................................................................................................. 127

    Figure 59 : Inter Thread global services model................................................................................... 132

    Figure 60: Secure table generic services model................................................................................. 134

    Figure 61: Miscellaneous services ...................................................................................................... 137

    Figure 62 To Lxpu Thread indications................................................................................................. 140

    Figure 63 Lxpu to Admin messages.................................................................................................... 141

    Figure 64 Contextes carried by indications......................................................................................... 142

    Figure 65 Download and NackCause management ........................................................................... 144

    Figure 66 Functional Automaton related model .................................................................................. 149

    Figure 67 multi-interface request messages generation model.......................................................... 152

    Figure 68 Cml interface set ................................................................................................................. 158

    Figure 69 Miscellaneous common functional classes......................................................................... 161

    Figure 70 dataElement package model .............................................................................................. 164

    Figure 71 : Lxpu package model......................................................................................................... 172

    Figure 72: OamXXX and CmlXXX classes definition.......................................................................... 178

    Figure 73 Radio domain global model ................................................................................................ 185

    Figure 74: Bss environment ( part 1 ).................................................................................................. 186

    Figure 75Bss management ( part 2 ) .................................................................................................. 187

    Figure 76 Contextes related to radio domain management................................................................ 194

    Figure 77 : Relation between PagingXXX objects .............................................................................. 199

    Figure 78 Mapper and version management ...................................................................................... 205

    Figure 79 Classes for download of radio configuration....................................................................... 217

    Figure 80 Ater/AterMux domain model ............................................................................................... 218

    Figure 81 Gb domain model................................................................................................................ 219

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 9/380

    Figure 82: GOM global behaviour ....................................................................................................... 220

    Figure 83 : Declaration of OamConstructor ........................................................................................ 223

    Figure 84 Declaration of OamCmpsConfigXXX.................................................................................. 224

    Figure 85 Functional automaton declaration....................................................................................... 225

    Figure 86 Message generator declaration. ......................................................................................... 226

    Figure 87 DataElement declaration..................................................................................................... 227

    Figure 88DataElementFactory declaration ......................................................................................... 228

    Figure 89 DownloadManager declaration ........................................................................................... 229

    Figure 90: MIB rebuild order ............................................................................................................... 230

    Figure 91: MIB rebuild (extract)........................................................................................................... 231

    Figure 92 GOM start up sequence in configuration mode .................................................................. 232

    Figure 93 GOMs cold start in site mode............................................................................................. 233

    Figure 94 GOMs start up after a switchover ...................................................................................... 234

    Figure 95 Create request in conf mode............................................................................................... 239

    Figure 96 create request with or without Lxpu in site mode. .............................................................. 240

    Figure 97 Set request in conf mode .................................................................................................... 241

    Figure 98 Set request in site mode with or without Lxpu .................................................................... 242

    Figure 99: Check modified attributes .................................................................................................. 243

    Figure 100 Asynchronous deletion in conf mode................................................................................ 244

    Figure 101 Synchronous deletion in conf mode.................................................................................. 245

    Figure 102 Asynchronous deletion in site mode ................................................................................. 246

    Figure 103 Synchronous deletion of a cell .......................................................................................... 247

    Figure 104 Synchronous action management in configuration mode ................................................ 248

    Figure 105 Asynchronous action management in configuration mode............................................... 249

    Figure 106 A synchrous action in site mode with a lxpu..................................................................... 250

    Figure 107 Oam layer to Cml layer internal action ( extract ) ............................................................. 251

    Figure 108 Cml layer to Oam layer internal action (extract ) .............................................................. 252

    Figure 109 Broadcast and parameter duplication on internal action................................................ 253

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 10/380

    Figure 110 Broadcast and parameter duplication on delete or action indication................................ 254

    Figure 111 Broadcast of set request among several CmlXXX instances ........................................... 255

    Figure 112 Broadcast of a delete request among several CmlXXX instances. .................................. 256

    Figure 113 Completion of broadcated synchronous delete request ................................................... 257

    Figure 114 mono lxpu state change management.............................................................................. 258

    Figure 115 State correlation in multi lxpu situation ............................................................................. 259

    Figure 116 process issued on functional timer expiry......................................................................... 260

    Figure 117: Registration of CmlXXX objects....................................................................................... 262

    Figure 118: Registration of CmlXXX objects (extract) ........................................................................ 263

    Figure 119: Reactivation of registration of CmlXXX objects (extract)................................................. 264

    Figure 120: LXPU unregistration......................................................................................................... 265

    Figure 121 creation of message sent towards Lxpu .......................................................................... 267

    Figure 122: Confirmation treatment .................................................................................................... 268

    Figure 123: Confirmation treatment .................................................................................................... 269

    Figure 124: Lxpu reset is invoked by Lxpu thread .............................................................................. 270

    Figure 125 Lxpu reset is invoked from Admin thread ......................................................................... 271

    Figure 126 Lxpu disconnection generic management ........................................................................ 272

    Figure 127: LXPU global configuration consecutive to a GEM notification ........................................ 274

    Figure 128: LXPU global download consecutive to a LXPU open session ........................................ 275

    Figure 129 Extract of download sequence.......................................................................................... 276

    Figure 130: Massive change ............................................................................................................... 278

    Figure 131 Propagation of a new Lxpus version................................................................................ 279

    Figure 132 Lxpu-reconnection timer expiry after a switchover ........................................................... 280

    Figure 133 Resynchronisation ( extract ) ............................................................................................ 283

    Figure 134 registration on LapDLink. .................................................................................................. 285

    Figure 135 unregistration of LapDLink................................................................................................ 286

    Figure 136 GicGroup registration........................................................................................................ 287

    Figure 137 GicGroup unregistration.................................................................................................... 288

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 11/380

    Figure 138: ReserveGics action with GicGroup creation (part 1) ....................................................... 290

    Figure 139: ReserveGics action for GicGroup creation: Lxpu message sending (part 2) .................. 290

    Figure 140: ReserveGics action with GicGroup creation: differed response sending (part 3) ........... 291

    Figure 141: ReserveLapDLink action with LapDLink creation (part 1) ............................................... 292

    Figure 142 End of LapDLink deletion.................................................................................................. 293

    Figure 143 End of GicGroup deletion.................................................................................................. 294

    Figure 144 Nse registration................................................................................................................. 296

    Figure 145 Nse unregistration............................................................................................................. 297

    Figure 146 bss creation....................................................................................................................... 298

    Figure 147 Bss download ( part 1 ) ..................................................................................................... 300

    Figure 148 Bss download ( part 2 ) ..................................................................................................... 301

    Figure 149 Bss static registration........................................................................................................ 303

    Figure 150 Bss on-line registration ..................................................................................................... 304

    Figure 151 Bss deletion first part ........................................................................................................ 305

    Figure 152 End of Bss deletion ........................................................................................................... 306

    Figure 153 Broadcast of MainPa election towards serving Lxpus...................................................... 307

    Figure 154 Gsl loss-timer management on CmlBss state change...................................................... 308

    Figure 155 Pa building with Bss.......................................................................................................... 309

    Figure 156 Pa building with cells......................................................................................................... 310

    Figure 157 Pa deletion with Bss.......................................................................................................... 311

    Figure 158 Pa deletion with cells ........................................................................................................ 311

    Figure 159 Paging Area modification .................................................................................................. 312

    Figure 160 What happens on Paging Area when a cell is mapped.................................................... 313

    Figure 161 Main lxpu for a Paging Area.............................................................................................. 315

    Figure 162 Paging Area rebuild from Mib. .......................................................................................... 316

    Figure 163 : BssReshuffle : CMPS request (part 1)............................................................................ 318

    Figure 164 : BssReshuffle, compute cells mapping : init GchXXLoad (part 2)................................... 319

    Figure 165: BssReshuffle, compute cells mapping : process GchXXLoad (part 3)............................ 320

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 12/380

    Figure 166: BssReshuffle, apply registration on cells to be mapped (part 4) ..................................... 321

    Figure 167: BssReshuffle, apply mapping on cells to be remapped (part 5)...................................... 322

    Figure 168: BssReshuffle, cell create confirmation messages handling (part 6)................................ 323

    Figure 169 : BssReshuffle, Cmps response (part 7)........................................................................... 324

    Figure 170 Reshuffle at cold-startup ................................................................................................... 325

    Figure 171 Association between cells and SubBss after a switchover............................................... 326

    Figure 172 Version management in B9............................................................................................... 328

    Figure 173 Object model used for B9 mapping and reshuffling.......................................................... 329

    Figure 174 B9 mapping....................................................................................................................... 331

    Figure 175 B9 mapping, detailed scenario ......................................................................................... 332

    Figure 176 B9 reshuffle ....................................................................................................................... 333

    Figure 177 B9 reshuffle, detailed scenario ......................................................................................... 334

    Figure 178 B9 mappig with cell shared , detailed scenario ................................................................ 335

    Figure 179 Radio domain synchronisation after a switchover ............................................................ 336

    Figure 180 subBss last lapDLink deletion........................................................................................... 337

    Figure 181 Gsl state change and new Pilot selection......................................................................... 339

    Figure 182 Global Bss reset after a Gsl State Change....................................................................... 340

    Figure 183 Lxpu disconnection on GSL not resulting from Nse deletion............................................ 341

    Figure 184 Lxpu disconnection on GSL when this one is resulting from Nse deletion....................... 342

    Figure 185 Gsl loss-timer expiry ......................................................................................................... 343

    Figure 186 : CREATE request on CELL ............................................................................................. 345

    Figure 187: Cell deletion outside reshuffling....................................................................................... 347

    Figure 188 Focus on end of cell deletion ............................................................................................ 348

    Figure 189 Cell deletion in reshuffling................................................................................................. 349

    Figure 190 Cell deletion when Gsl loss-timer is armed ...................................................................... 350

    Figure 191 Cell mapping ..................................................................................................................... 351

    Figure 192 on-line cell registration outside MLU................................................................................. 352

    Figure 193 Cell unregistration ............................................................................................................. 353

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 13/380

    Figure 194 Nsei propagation when cell is already mapped ................................................................ 354

    Figure 195 lxpu disconnection on cell and link with main lxpu for paging area selection................... 355

    Figure 196 Sequence diagram for Gb down sequence ................................................................ 363

    Figure 197 Sequence diagram for Gb up sequence..................................................................... 364

    Figure 198 Send an alarm to GAM ..................................................................................................... 368

    Figure 199: Object mapping on threads.............................................................................................. 369

    Figure 200: LXPUn thread automaton ................................................................................................ 370

    Figure 201 : B8, LXPU global configuration automaton (part 1) ......................................................... 372

    Figure 202 : B8, LXPU global configuration automaton (part 2) ......................................................... 373

    Figure 203 : B8, LXPU global configuration automaton (part 3, Bss) ................................................. 374

    Figure 204 : B8, LXPU global configuration automaton (part 5, Cell)................................................. 375

    Figure 205: Admin thread automaton.................................................................................................. 376

    Figure 206: Internal message structure .............................................................................................. 377

    Figure 207: ConfigIsReady message structure................................................................................... 378

    Figure 208 MassiveChange message structure ................................................................................. 378

    Figure 209: Lxpu Reset message structure ........................................................................................ 378

    Figure 210: Update message structure............................................................................................... 378

    Figure 211: Delete message structure................................................................................................ 379

    Figure 212: Align message structure .................................................................................................. 379

    Figure 213: Action message structure ................................................................................................ 379

    Figure 214: Cml Internal Action message structure............................................................................ 379

    Figure 215: Confirm message structure.............................................................................................. 380

    Figure 216: Oam Internal Action message structure .......................................................................... 380

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 14/380

    ED DATE CHANGE NOTE APPRAISAL AUTHORITY ORIGINATOR

    MFS GOM SW COMPONENT DESCRIPTION RELEASE B9

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 15/380

    HISTORY

    Ed. 01 Proposal 01 14/10/2004 Creation issued from 3BKA09622JAAAPEZZA

    Ed. 01 RELEASED 04/11/2004 Remarks EVOLIUM/MRD/CNS/2004-4178

    Ed. 02 Proposal 02 12/05/2005 Creation issued from 3BKA09622JAAAPEZZA

    Ed. 02 RELEASED 13/09/2005 Remarks EVOLIUM/MRD/CNS/2005-4694

    REFERENCED DOCUMENTS

    [1] GPRS Management Functional Specification

    3BK 09722 JAAA DSZZA [2] GPRS Management API

    3BK 09713 GAAA PBZZA [3] MFS Alarm Dictionary

    3BK 10204 0560 DTZZA [4] Equipment Management and Alarms API

    3BK 09639 GAAA PBZZA [5] MFS O&M MFS Telecom Interface Specification

    3BK 09638 JAAA PBZZA [6] Nectar Administration Local Agent Functional Specification

    3CM 00335 CAAA DSZZA

    RELATED DOCUMENTS

    [7] MFS O&M Architecture

    3BK 09665 JAAA EBZZA [8] GPRS NE Platform Equipment and Alarm Mngt Func Spec

    3BK 09584 JAAA DSZZA

    PREFACE

    The aim of this document is to present the design of the GOM SW component of the MFS O&M sub-system. This SW component is in charge of the GPRS telecom O&M configuration and supervision.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 16/380

    SCOPE

    This document specifies the GOM agent of the MFS for the MR3. It is part of the BSS release B9.

    This document is mainly intended to:

    The developers of the MFS.

    The GPRS O&M integration & validation team.

    The new features added in GOM are:

    starting optimization during control station switchover phase.

    additional attributes of objects at MDL interface.

    Multiple CML interface facing with GPU in B9 and GPU in B8 at the same time.

    The detailed features of the Step 1 phase are described in [1].

    The previous B8 features in GOM are still maintained:

    Multi-GPU per BSS.

    balanced dispatching of cells of overGPUs for each BSC.

    Ater interface with BSC.

    Additional features related to multi-gpu, such as main gpu election.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 17/380

    1 MAIN FEATURES

    The GPRS Operation and Maintenance (GOM) Agent on the MFS control station manages the GPRS telecom resources configuration and supervision. It manages the Bearer, Gb interface, GAter/GAterMux interface and Cell Management domains. It is mainly in relation with the TRM (Telecom Resource Manager) Agent on the LXPU. It also interacts with the administrative agents (Q3 agent and craft terminal). The roles of GOM are:

    GPRS logical configuration for the Bearer, Gb interface, GAter/GAterMux interface and cell management domains which includes the validity check, the update of the persistent data and the message sending to the LXPU.

    Supervision for these domains, i.e. the report of state change notifications to the administrative part and quality of service alarms.

    Resynchronisation on the LXPU resource states after a control station switchover.

    Global configuration of the LXPU when a LXPU asks for it, after a start, reset or switchover.

    CMPS requests processing from the administrative agents.

    several LXPU interfaces management to cope with BSS version change feature.

    GOM GEM GAM

    CraftTerminal

    1

    32

    1

    2

    4 Interface to GAM

    Interface to Admin

    Interface to XPU

    DM CFG Semi permanent configuration data

    DM RSC Dynamic resource data (states).

    GPM

    XPU board

    DMCFGMIB

    Q3 AGENT

    DMRSCMIB

    3 Interface to GEM

    4

    OMC

    5

    5 Interface with GPM

    Figure 1: Global MFS O&M Architecture

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 18/380

    GOM interacts with five components:

    The craft terminal and the Q3 Agent for administrative purpose.

    The GAM and GEM for alarm and equipment management purpose.

    The XPU for telecom resource configuration and supervision.

    GOM shares data tables with GPM. It provides a simple interface that allows GPM to retrieve information it will forward in its reports with measurements.

    The craft terminal allows to set site parameters through CMPS requests. All other interactions are performed with the Q3 agent.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 19/380

    2 DATA MODEL

    2.1 CMPS data model

    The GOM data model is described in [2].

    2.2 Alarms

    Table 1 lists the classes on which alarms are reported to the administrative agent according to [3]. The instance of these classes must be referenced to GAM at creation time.

    FRBearer

    NSVC

    PVC

    BSS

    LapDLink

    GicGroup

    Table 1: Classes supporting alarms

    Some fault reports are sent by GOM to GAM. These fault reports are defined in [3].

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 20/380

    3 EXTERNAL INTERFACES

    3.1 GEM Interface

    3.1.1 Interface with subscription

    GOM interacts with GEM to receive the notifications of creation ,deletion of the LXPU, and LXPU state changes, and the associations between the PCM-TTP and the LXPU. The interface is based on a subscription mechanism to GEM. This subscription is made at GOMs start-up in site mode.

    As GOM in B9 will be facing two kinds of interface during migration phase ( B8 and B9 ) while O&M interface is in B8, GEM must provide GOM with the interface version. This allows GOM to process the correct mapping between the O&M interface and the LXPU interface

    This interface offers five services:

    The LXPU notifications through which GEM sends the logical number of the LXPU and its CMPS Distinguished Name (DN) when a new LXPU appears. The version of LXPU interface is also transmitted.

    The PCM-TTP notifications through which GEM sends the port number, the CMPS DN and the LXPU DN when a PCM-TTP is equipped. The deletion of PCM-TTP is not notified since it only occurs when the LXPU is deleted.

    The LXPU state-change noticifation. This state must be taken into account by GOM when it maps cells on LXPU ( related to multi-GPU feature )

    Notification of Lxpu deletion.

    GEM grants connections from one or all LXPU (GpuConnectAllowed). We also use this mean to propagate the version identifier of involved lxpu.

    All those messages are sent in a CS session opened between GOM and GEM at subscription time

    Notifications are performed by the mean of messages received in GOM. The messages are the following:

    GEM_BOARD_CREATED: gives to GOM references of the LXPU.

    GEM_BOARD_DELETED: informs GOM that an LXPU has been deleted.

    GEM_BOARD_STATE_CHANGE : informs GOM that LXPU state has changed. Possible states seen by GOM are : Failed, Locked, Available, Undefined

    PCM_TTP_EQUIPPED: gives to GOM references of the PCM-TTP and PCM port number for a given LXPU.

    PCM_TTP_UNEQUIPPED: informs GOM that a PCM-TTP has been unequipped. This information is sent e.g. when the remote equipment attribute of the PCM-TTP is set to unknown. In this case, there is no telecom resource on this PCM-TTP. But this feature is not supported by GOM.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 21/380

    3.1.2 Interface without subscription

    GOM also interacts with GEM for five other purposes:

    To ask GEM to reset a given LXPU (LxpuReset) It is made upon a CS question/answer mechanism with GEM.

    To notify GEM that the radio file resynchronisation consecutive to a software version change is completed for a given LXPU (StartOperation). It is performed by the mean of a CS datagram

    To forward to GEM, notification received from a LXPU on a BSS that indicates a version change. GOM has to calculate the set of LXPU supporting the BSS before sending the message to GEM. It is done with a CS datagram.

    To synchronise Q3 agent start-up after a station switchover. GOM asks to GEM, the number of LXPUs full initialization it has to wait before allowing Q3 agent to start. This task is also made by the mean of a CS datagram.

    To detect if switchover is a consequence of a migration. GOM requests this information to GEM. This is supported by CS question/answer mechanism. According to the result internal backuped table may be cleaned ( cleaned if not in migration, kept untouched otherwise ).

    For the detailed description of this interface, refer to [4].

    3.2 LXPU Interface

    GOM interacts with TRM on the XPU. TRM reroutes the messages to the BCM, NS and RRM agents. It is the main data flow for GOM.

    Furthermore GOM deals with two different interfaces. One with a TRM in B8and one with a TRM in B9. This situation will last until all BSS will have migrated to B8. But both interfaces will remain in code.

    Interfaces and protocols are described in [5].

    3.3 GAM interface

    GOM must indicate to GAM the references of objects supporting alarms. This interface is described in [4].

    Moreover, GOM sends fault reports to GAM using the interface described in Erreur ! Source du renvoi introuvable..

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 22/380

    3.4 GPM interface

    This interface is made of three shared configuration tables ( Extension, Cell and BtsSiteManager ), used by GPM to retrieve information for measurements report building purpose.

    3.5 Administrative interface

    The administrative interface (Q3 agent and craft terminal) uses CMPS. The SET, CREATE, and ACTION operations are processed by GOM. DELETE operation uses ACTION mean to achive object deletion. Since ACTION can be defined either Synchronous or Asynchronous Action GOM allows to perform both types of deletion, depending on functional needs. Other CMPS operations such as GET, GET_WHEN, are directly managed by the NECTAR NCAC library.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 23/380

    4 ARCHITECTURE

    4.1 Overview

    GOM is a Nectar SCIM in active/standby mode. It interacts with four main entities:

    Administrative agents (Q3 agent, craft terminal, ) through a CMPS / CS interface in order to configure and supervise the telecom resources present in GOM.

    Running LXPU through XDR / CS communications in order to configure and supervise the telecom resources on the LXPU. XDR encoding is used since the control station and the LXPU have different word representation.

    GEM through CS communications in order to be notified of the equipment changes, to be authorised to accept LXPU connections, to ask LXPU reset and to notify the end of radio file resynchronisation after a software version change. This interface does not used XDR encoding since both SCIMs are on the same station.

    GAM through XDR/CS communications and shared table in order to report alarms. XDR encoding is used for alarm sending in order to keep the same interface that the one between GAM and LXPU. A shared table is used to store the relation between the reference of the object at the O&M level and the reference of the object in the telecom part.

    GPM through shared configuration tables

    Sharedtable

    AdministrativeServer

    CMPS / CS

    ObjectControlServer

    XDR/CS

    CS

    AdministrativeAgents

    LXPU

    GEM

    GAM

    XDR/CS

    GPMSharedtable

    Figure 2: GOM external interfaces

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 24/380

    4.1.1 Communications flows and constraints

    The main communication flow is the one with the LXPU. GOM must be able to download an LXPU configuration in a few seconds when the LXPU asks for a connection with GOM. Moreover, LXPU reports state change notifications that must be notified to the operator as soon as possible.

    The second flow of communication comes from the administrative agents. It is composed of administrative requests (object creation, modification or action ( deletion and real actions )). This flow has a lower priority than the previous one. Nevertheless, it may be important, i.e. several requests per second.

    The communication flow from the GEM is low since there is only notifications of new boards, board deletion , board state change, and PCM-TTP equipment and unequipment. There is at most two hundred short messages, for instance after a switchover with a maximum MFS configuration.

    The communication flow to the GAM transfers alarms. These alarms have the same priority than the state changes. They are limited to a small number of objects. The maximum number of alarm reports occur when a Bsc fails. It may reach two hundred alarms.

    There is no traffic with GPM.

    4.1.2 GOM internal Architecture

    GOM is divided in two main parts:

    The administrative server in charge of processing the requests from the CMPS interface, and managing the infomodel provided at this interface level including the MIB storage.

    The object control server in charge of the configuration and supervision of the running LXPU.

    The Administrative Server part has one main thread (Admin on Figure 3), seen by the GOM application developer. An additional hidden thread (Event Report) is used by the NCAC runtime to process the CMPS GET_WHEN requests (refer to [6] for additional details). A third thread (Equipment) receives the equipment change notifications coming from GEM. This thread is delivered with GEM and is not described any more in this document.

    The Object Control Server has :

    One main thread (Reception thread on Figure 3) to collect the open session messages arriving from the different LXPU ( session server ). It also manages a pre-allocated set of threads according to the number of running LXPU which are then assigned or re-assigned on demand.

    Indeed, there is one LXPUn thread per running LXPU, used to download configuration and to forward state change notifications.

    There is also an Alarm Thread that deals with the dynamic part of the interface with GAM.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 25/380

    CS Port

    Thread

    LXPU1

    lp3

    LXPU2

    lp4

    LXPUn

    lpn

    Reception

    lp1

    Admin

    lp0

    FAP_GOMLXP

    FAP_GOM

    FAP GOMADM

    Administrative Server

    Object Control Server

    Equipment

    lp2

    Event Report

    lp0

    FAP GOMGEM

    Alarm

    lp30

    Figure 3: GOM architecture

    The description of the role of the threads and their interactions are described in next sections.

    4.2 Administrative Server

    The Administrative Server is mainly responsible for handling CMPS encoded requests with regard to LXPU resources. The following actors may access it:

    The operator on the craft-terminal

    The Q3 agent after receiving a request from the OMC-R.

    The Administrative Server manages the GPRS logical configuration for the Bearer, Gb interface, Gater/GAterMux interface and Cell management domains. It includes the validity check, the update of the persistent data (MIB), the response sending through the CMPS interface. It also computes the set of modified attributes and which messages must be sent on LPXU interface, and sends the indications of modifications to the appropriate LXPUn thread in the Object Control Server if the latter exists. This late message can be duplicated in order to propagate it to several LXPU thread if ever configuration is splitted over several LXPUs.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 26/380

    It also propagates messages to several LXPU threads when an previous trigger on this last one implies such a behaviour. That means that dispatching of a message to several LXPU threads must be done under the control of Admin thread whatever the trigger is.

    It is also in charge of receiving the LXPU and PCM-TTP creation / deletion / state change notifications coming from GEM through the Equipment thread. On the LXPU creation notification, a global check is performed on the resources related to this LXPU. The Administrative server also indicates (if needed) to the appropriate LXPUn thread in the Object Control Server that the configuration is ready.

    The Administrative Server also receives from GEM the authorisation to accept connections from the LXPU, and notifies to GEM the end of the radio file resynchronisation, both for software version change purposes.

    Moreover, the Administrative Server registers and unregisters the instances of objects supporting alarms in the GAM shared table.

    4.2.1 Managed Objects

    The list of managed objects handled by GOM is described in [2].

    These objects are a subset of the ones seen through the Q3 interface plus additional objects needed for configuration purpose.

    All objects are mostly stored in private secured DM tables (DSIM) with a back up on the shared disks of the pilot stations. Few of them use public secured DM tables to open a static interface with GPM.

    There are two types of attributes for a managed object:

    Configuration attributes: describe the static data of an object and are exclusively updated by the Administrative Server when receiving a CREATE or SET request. They are in DM tables (configuration tables) which are back-uped on disk. Some of thoses attributes are strictly private to GOM and are used to provided persistency facility in case of switchover.

    Resource attributes: describe the dynamic states of an object. The Administrative Server does not update these attributes. They are in DM tables (resource tables) which are secured without back up ( with the only exception of NSE resource table for migration management purpose ). They are allocated at the same time the configuration attributes are on a CREATE request. They must be re-allocated by the application on a control station cold start.

    The GOM module (as any NECTAR global agent) has two functional modes:

    Configuration mode: the Administrative Server is waiting for CMPS creation request to populate DM tables. A NECTAR platform restart is necessary to switch into site mode. This mode is temporary and is used for configuration purpose only. In this phase, the root objects storing the site parameters are created.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 27/380

    Site mode: the GOM module can use all information present in its DM tables. Configuration data have been created by an explicit CMPS CREATE request in configuration mode. In this phase, the main part of the objects managed by GOM are dynamically created, updated and deleted.

    4.2.2 Operations

    Operations modify the configuration data with the CREATE, SET, , ACTION operations or just read all data (configuration and resource) with the GET operation. DELETION are performed with an ACTION operation.

    The Administrative Server uses the NECTAR NCAC library framework to perform these operations. The NCAC function nca_initialize initialises the NCA context (event report thread, data references, ) and nca_operation processes all the requests (operations and actions). Note that a GET operation does not need any specific code to be developed.

    For each attribute defined by MDL model NCAC library automatically performs defiend checks, for the CREATE, ACTION-delete and SET operations, checks are associated to each class to be modified. Those checks represents the functional checks that must be performed by GOM when it deals with the request. There is one check per operation and per class. These checks are not mandatory, since there is a suitable default behaviour. The checks on each operation are in charge of the request validity, the response processing and delivering through the CMPS interface, and the message sending to the Object Control Server.

    The GET, SET, CREATE operations are processed locally by the Administrative Server. The processing of the request continue on the Object Control Server in order to send (if necessary) the message to the LXPU. For the ACTION operation, there is no default behaviour and the code is entirely user specific, using NCAC facilities.

    Note: When an ACTION modifies a resource attribute, it is directly forwarded to handled by the Object Control Server part in order to ensure the configuration and resource data isolation.

    It is possible to defined both synchronous and asynchronous ACTION operations. In CMPS terminology asynchronous ACTIONS means that final response is given to a manager when action is performed on GPU, whereas when it is synchronous, response is given immediatly whithout taking care of the processing on the GPU. In the first case the late response must be done by the Admin thread when last confirmation is recevied from LXPU. This implies an uplink message between LXPU thread and Admin thread to change of executing thread.

    4.3 Object Control Server

    The Object Control Server (OCS) is responsible for the configuration and supervision of the LXPU resources, i.e. the telecom resources of the Bearer, Gb interface, Gater/GAterMux and Cell management domains. This includes the handling of the CS open session and abort session requests arriving from the LXPU, the sending of the configuration message to the LXPU, and the modification of the resource attributes in the DM tables (the report of notifications to the administrative agents is automatically performed by NCAC through the CMPS interface), the message sending towards Admin thread to activate this one when an asynchronous ( in CMPS terminology ) action is fullfilled on LXPU. Furthermore when configuration is splitted over several LXPUs, OCS must first correlate resource attributes before updating DM tables.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 28/380

    OCS is also in charge of the global configuration of a LXPU after a XPU start, reset or switchover. This action is performed when the LXPU contact OCS, i.e. when a CS session open request is received by OCS.OCS also handles the resynchronisation on the LXPU resources after a control station switchover.

    4.3.1 Reception Thread Role

    This thread has three main roles:

    Manage (create, reallocate) the LXPUn threads.

    Receipt the open session requests coming from all the LXPUs and dispatch them to the appropriate LXPUn thread. The dispatching is performed only if the connection has been allowed by GEM for this LXPU, otherwise the open session is refused.

    On reception of a new open session request from a LXPUn, the reception thread looks for a free LXPUn thread. If one is found, it delegates the session to this LXPUn thread. Otherwise, the maximum number of connections is reached and the open session request is refused. A session delegation is a CS service which allows rerouting the messages arriving on a given local port to an other local port. This is performed at CS level. This means that the data messages and the close or abort session messages will be sent directly to the LXPUn thread. The opening may be refused if the Lxpu has not been declared yet by GEM and if its configuration is not considered has ready ( no PCM_TTP yet declared ).

    When a LXPU fails (abort session message received by the LXPUn thread), the LXPUn thread must indicate to the Reception thread that the LXPUn thread is free and can be reused for another LXPU. Due to te fatc that NECTAR platfrom does not support SCIM defense, a LXPUn thread must not be destroyed since CS resources are associated with it during its creation, and that local port can be equipped only once. It could not be reused if the thread is destroyed.

    4.3.2 LXPUn Threads Role

    A LXPUn thread is in charge of all the processing necessary to send a configuration and to supervise a given LXPUn. Its main roles are:

    Manage the LXPU discovery (a new XPU board has been plugged, a XPU board asks for its configuration after a XPU reset or switchover).

    Download the global LXPU configuration after a LXPU initialisation.

    Process the request notifications and confirmations from the LXPU.

    Compute resource states and alarms.

    Forward message to alarm thread for alam sending

    Send one or several configuration message(s) to the LXPU on Administrative Server request, getting the objects and their attribute values from the MIB.

    Send late confirmation towards Administrative Server in case of synchronous operation with LXPU.

    Resynchronise on the LXPU resources (object states and status attributes) after a control station switchover.

  • ED 02 RELEASED

    Evolium

    3bk09622jaaapezza-ed2rl.doc

    04/11/2004 3BK 09622 JAAA PEZZA 29/380

    4.3.2.1 LXPU discovery

    The detection of a running LXPU occurs in several phases. Indeed, the LXPU