-
Notifications
You must be signed in to change notification settings - Fork 59
/
Copy pathCISCO-PSD-CLIENT-MIB.mib
563 lines (484 loc) · 20.1 KB
/
CISCO-PSD-CLIENT-MIB.mib
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
-- ********************************************************************
-- CISCO-PSD-CLIENT-MIB.my: MIB file for PSD
--
-- August 2005, Suma Marutirao Sutar
--
-- Copyright (c), 2005 by Cisco Systems, Inc.
-- All rights reserved.
-- ********************************************************************
-- $Endlog$
CISCO-PSD-CLIENT-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
NOTIFICATION-TYPE,
Counter32,
Integer32
FROM SNMPv2-SMI
SnmpAdminString
FROM SNMP-FRAMEWORK-MIB
RowStatus,
TruthValue
FROM SNMPv2-TC
InetAddressType,
InetAddress
FROM INET-ADDRESS-MIB
MODULE-COMPLIANCE,
OBJECT-GROUP,
NOTIFICATION-GROUP
FROM SNMPv2-CONF
ciscoMgmt
FROM CISCO-SMI;
ciscoPsdClientMIB MODULE-IDENTITY
LAST-UPDATED "200508241800Z"
ORGANIZATION "Cisco Systems, Inc."
CONTACT-INFO
" Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: [email protected]"
DESCRIPTION
"This MIB module manages the client side
functionality of the Persistent Storage Device(PSD).
This MIB instrumentation is for configuring
data-store(PSD client) feature on GGSN and monitoring
the state of the PSD server(up/down/full).
The Cisco Persistent Storage Device(PSD) is an
extension to existing storage on the Cisco Content
Services Gateway(CSG).
The GGSN currently allows sending of the CDRs to an
active CG, while allowing up to two standby CG's to
be configured. When all the configured CG's become
unavailable, the CDRs get stored at the GGSN and
start using up GGSN resources such as memory. As the
amount of memory is limited on GGSN and failure of
GGSN shall lead to losing these stored CDRs.
Using PSD as temporary storage, shall avoid losses
due to these problems. When all the configured CG's
are unavailable, GGSN needs to backup the live closed
CDR's to a PSD. When any of the CG's shall become
available, GGSN shall retrieve the stored CDR's
automatically from the PSD and forwards them to the
active CG.
PSD supports the charging protocol(GTP'), version 0
with a few private extensions, which is used to
facilitate the required functionality via UDP.
Acronyms and terms:
CDR Call Detail Record
CID Charging Identification
CG Charging Gateway
CGF Charging Gateway Functionality
DS Data-Store
ETSI European Telecommunications Standards
Institute
Ga Name of the interface between SGSN/GGSN and
CG
Gi Name of the interface between GGSN and PDN
Gn Name of the interface between GGSN and SGSN
G-CDR Gateway GPRS Support Node-Call Detail Record
GGSN Gateway GPRS Support Node
GPRS General Packet Radio Service
GSM Global System for Mobile communication
GTP GPRS Tunneling Protocol
GTP' GTP enhanced for charging
IE Information Element
MS Mobile Station
PDN Packet Data Network
PDP Packet Data Protocol
SGSN Serving GPRS support Node
TOS Type of Service.
PSD Persistence Storage Device."
-- REFERENCE
-- "[1] GSM 09.60: Digital cellular telecommunication
-- system (Phase 2+); General Packet Radio Service
-- (GPRS); GPRS Tunneling Protocol (GTP) across
-- Gn and Gp Interface, ETSI, (V7.3.0)
-- [2] GSM 12.15: 'Digital Cellular telecommunications
-- system (Phase 2+); General Packet Radio Service
-- (GPRS); Charging in GPRS', ETSI, (V7.2.1)
-- [3] 3GPP; Universal Mobile Telecommunications System
-- (UMTS);Telecommunication Management;Charging and
-- billing;3G call and event data for Packet
-- Switched(PS) domain.TS 32.015 version 3.8.0
-- (Release 1999)."
REVISION "200508241800Z"
DESCRIPTION
"Initial version of this MIB module."
::= {ciscoMgmt 495 }
-- Notification Definitions
ciscoPsdClientMIBNotifs OBJECT IDENTIFIER
::= { ciscoPsdClientMIB 0 }
-- Object definitions
ciscoPsdClientMIBObjects OBJECT IDENTIFIER
::= { ciscoPsdClientMIB 1 }
ciscoPsdClientStatistics OBJECT IDENTIFIER
::= { ciscoPsdClientMIBObjects 1 }
ciscoPsdClientNotifMgmt OBJECT IDENTIFIER
::= { ciscoPsdClientMIBObjects 2 }
ciscoPsdClientConfigurations OBJECT IDENTIFIER
::= { ciscoPsdClientMIBObjects 3 }
ciscoPsdClientNotifInfo OBJECT IDENTIFIER
::= { ciscoPsdClientMIBObjects 4 }
-- Conformances definitions
ciscoPsdClientMIBConform OBJECT IDENTIFIER
::= { ciscoPsdClientMIB 2 }
--
-- Statistics
--
cPsdClientDSWriteReq OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Data Record Transfer request (for write)
messages sent to the PSD server.
This counter is incremented when the FIFO write request
is sent to the PSD server from the client."
::= { ciscoPsdClientStatistics 1 }
cPsdClientDSReadReq OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Data Record Transfer request (for read)
messages sent to PSD server.
This counter is incremented when the FIFO read request
message is sent to PSD server."
::= { ciscoPsdClientStatistics 2 }
cPsdClientDSRdWrRetrans OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Data Record Transfer Request
(retransmission) messages sent to the PSD server.
The PSD does not differentiate between a retransmission
and original request. So, this counter together with
the above two counters cPsdClientDSReadReq/
cPsdClientDSWriteReq can be used to tally the number of
messages received by the PSD client.
This counter is incremented when the FIFO read/write
retransmission messages are sent to PSD server."
::= { ciscoPsdClientStatistics 3 }
cPsdClientDSDiskFullTrans OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of state transitions made by the PSD from
state 'disk available' to 'disk full'.
This counter is incremented when client receives the
disk full indication from PSD server."
::= { ciscoPsdClientStatistics 4 }
-- Notification related objects
cPsdClientNotifEnable OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies whether the agent should
generate the notifications defined in this MIB module.
If the value of this object is 'true' it enables the
device to generate the notifications.
If the value of this object is 'false' it disables the
device from generating the notifications."
DEFVAL { false }
::= { ciscoPsdClientNotifMgmt 1 }
--
--Configurations
--
cPsdClientDSTable OBJECT-TYPE
SYNTAX SEQUENCE OF CPsdClientDSEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table consisting of entries for data-store(DS) and
auto-retrieval configurations.
In order to minimize the performance/memory impact on
the PSD client, as well as not to overwhelm the CG
with both live CDRs and retrieved CDRs, the maximum
retrieval rate from PSD server to GGSN is limited and
can be configured by the user."
::= { ciscoPsdClientConfigurations 1 }
cPsdClientDSEntry OBJECT-TYPE
SYNTAX CPsdClientDSEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Each entry contains the configuration for
auto-retrieval and also maximum retrieval value if
auto-retrieval is enabled."
INDEX { cPsdClientDSName }
::= { cPsdClientDSTable 1 }
CPsdClientDSEntry ::= SEQUENCE {
cPsdClientDSName SnmpAdminString,
cPsdClientDSAutoRetrieve TruthValue,
cPsdClientDSMaxRetrieve Integer32,
cPsdClientDSRowStatus RowStatus
}
cPsdClientDSName OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE(1..32))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object contains the name of the configured
data-store"
::= { cPsdClientDSEntry 1 }
cPsdClientDSAutoRetrieve OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object is used to enable/disable the CDR
auto-retrieval functionality.
If value of this object is set to 'true',
auto-retrieval is enabled.
If value of this object is set to 'false',
auto-retrieval is disabled."
DEFVAL { false }
::= { cPsdClientDSEntry 2 }
cPsdClientDSMaxRetrieve OBJECT-TYPE
SYNTAX Integer32(1..6000)
UNITS "messages/minute"
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object used to specify the maximum retrieval
value, when auto retrieve is enabled, i.e when the
value of the corresponding instance of
cPsdClientDSAutoRetrieve is set to 'true'."
DEFVAL { 60 }
::= { cPsdClientDSEntry 3 }
cPsdClientDSRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this conceptual row. This object is
used to create a row or delete a existing row in a
table."
::= { cPsdClientDSEntry 4 }
cPsdClientDSServerTable OBJECT-TYPE
SYNTAX SEQUENCE OF CPsdClientDSServerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The table contains the list of the PSD servers used to
write/retrieve the CDRs."
::= { ciscoPsdClientConfigurations 2 }
cPsdClientDSServerEntry OBJECT-TYPE
SYNTAX CPsdClientDSServerEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This entry contains a description of the PSD server."
INDEX { cPsdClientDSName,
cPsdClientDSServerAddressType,
cPsdClientDSServerAddress }
::= { cPsdClientDSServerTable 1 }
CPsdClientDSServerEntry ::= SEQUENCE {
cPsdClientDSServerAddressType InetAddressType,
cPsdClientDSServerAddress InetAddress,
cPsdClientDSRetrieveOnly TruthValue,
cPsdClientDSServerRowStatus RowStatus
}
cPsdClientDSServerAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This object indicates the type of Internet address of
the PSD server."
::= { cPsdClientDSServerEntry 1 }
cPsdClientDSServerAddress OBJECT-TYPE
SYNTAX InetAddress (SIZE (4..20))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The object specifies the Internet address of the PSD
server. The type of address of an instance of this object
is determined by the value of the corresponding instance
of cPsdClientDSServerAddressType."
::= { cPsdClientDSServerEntry 2 }
cPsdClientDSRetrieveOnly OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The object represents that, the PSD server can be
configured either as write/retrievable or as
retrievable only.
If the value of this object is set to 'true', the PSD
server (the value of the corresponding instance of
cPsdClientDSServerAddress) shall not be used for
writing the CDRs.
If the value of this object is set to 'false', the PSD
server (the value of the corresponding instance of
cPsdClientDSServerAddress) shall be used for writing
the CDRs as well as retrieving the CDRs."
::= { cPsdClientDSServerEntry 3 }
cPsdClientDSServerRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this conceptual row. This object will
create a row or delete a existing row in a table."
::= { cPsdClientDSServerEntry 4 }
--Notif info
cPsdClientNotifDSServerAddrType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"This object indicates the type of Internet address of
the Data-Store server."
::= { ciscoPsdClientNotifInfo 1 }
cPsdClientNotifDSServerAddress OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"This object specifies the Internet address of the
Data-Store server . The type of address of an instance
of this object is determined by the value of
cPsdClientNotifDSServerAddrType."
::= { ciscoPsdClientNotifInfo 2 }
--
-- Notification Definitions
--
cPsdClientDownNotif NOTIFICATION-TYPE
OBJECTS {
cPsdClientNotifDSServerAddrType,
cPsdClientNotifDSServerAddress
}
STATUS current
DESCRIPTION
"A notification of this type is generated when the
PSD server goes DOWN.
If the PSD client was in write/retrieving state, then
that operation shall be be stopped."
::= { ciscoPsdClientMIBNotifs 1 }
cPsdClientUpNotif NOTIFICATION-TYPE
OBJECTS {
cPsdClientNotifDSServerAddrType,
cPsdClientNotifDSServerAddress
}
STATUS current
DESCRIPTION
"A notification of this type is generated when the
PSD server comes UP.
A GTP' path will be created fulfilling all the specific
requirements of the PSD interface."
::= { ciscoPsdClientMIBNotifs 2 }
cPsdClientDiskFullNotif NOTIFICATION-TYPE
OBJECTS {
cPsdClientNotifDSServerAddrType,
cPsdClientNotifDSServerAddress
}
STATUS current
DESCRIPTION
"A notification of this type is generated when the
PSD server's disk become full.
If the disk of writable PSD server becomes full, the
client shall not be able to write any CDR into the
server. It shall then behave as a retrieve only PSD
server."
::= { ciscoPsdClientMIBNotifs 3 }
--
-- Conformances definitions
--
cPsdClientMIBCompliances OBJECT IDENTIFIER
::= { ciscoPsdClientMIBConform 1}
cPsdClientMIBGroups OBJECT IDENTIFIER
::= { ciscoPsdClientMIBConform 2}
-- compliance statements
cPsdClientMIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for entities which implement
the CISCO PSD CLIENT MIB."
MODULE --this module
MANDATORY-GROUPS { cPsdClientMIBStatisticsGroup,
cPsdClientMIBConfigurationsGroup,
cPsdClientMIBNotifGroup,
cPsdClientMIBNotifInfoGroup,
cPsdClientMIBNotifMgmtGroup
}
OBJECT cPsdClientDSRowStatus
SYNTAX INTEGER {
active(1),
createAndGo(4),
destroy(6)
}
DESCRIPTION
"The states notInService(2), notReady(3) and
createAndWait(5) need not be supported."
OBJECT cPsdClientDSServerRowStatus
SYNTAX INTEGER {
active(1),
createAndGo(4),
destroy(6)
}
DESCRIPTION
"The states notInService(2), notReady(3) and
createAndWait(5) need not be supported."
::= { cPsdClientMIBCompliances 1 }
-- units of conformance
cPsdClientMIBStatisticsGroup OBJECT-GROUP
OBJECTS {
cPsdClientDSWriteReq,
cPsdClientDSReadReq,
cPsdClientDSRdWrRetrans,
cPsdClientDSDiskFullTrans
}
STATUS current
DESCRIPTION
"A collection of objects providing Data Store
related statistics."
::= { cPsdClientMIBGroups 1 }
cPsdClientMIBConfigurationsGroup OBJECT-GROUP
OBJECTS {
cPsdClientDSRowStatus,
cPsdClientDSAutoRetrieve,
cPsdClientDSMaxRetrieve,
cPsdClientDSServerRowStatus,
cPsdClientDSRetrieveOnly
}
STATUS current
DESCRIPTION
"A collection of objects providing Data Store related
configurations."
::= { cPsdClientMIBGroups 2 }
cPsdClientMIBNotifGroup NOTIFICATION-GROUP
NOTIFICATIONS {
cPsdClientDownNotif,
cPsdClientUpNotif,
cPsdClientDiskFullNotif
}
STATUS current
DESCRIPTION
"A collection of Notifications."
::= { cPsdClientMIBGroups 3 }
cPsdClientMIBNotifInfoGroup OBJECT-GROUP
OBJECTS {
cPsdClientNotifDSServerAddrType,
cPsdClientNotifDSServerAddress
}
STATUS current
DESCRIPTION
"A collection of notification info objects on PSD."
::= { cPsdClientMIBGroups 4 }
cPsdClientMIBNotifMgmtGroup OBJECT-GROUP
OBJECTS {
cPsdClientNotifEnable
}
STATUS current
DESCRIPTION
"A collection of objects related with notification
management on PSD."
::= { cPsdClientMIBGroups 5 }
END