1-- $ID$
2-- ********************************************************************
3-- CISCO-GPRS-L2RLY-MIB.my: MIB file for GPRS L2RLY
4--
5-- December 1998, Ying He
6--
7-- Copyright (c) 1998 by cisco Systems, Inc.
8-- All rights reserved.
9-- ********************************************************************
10-- $Endlog$
11
12CISCO-GPRS-L2RLY-MIB DEFINITIONS ::= BEGIN
13
14IMPORTS
15        MODULE-IDENTITY,
16        NOTIFICATION-TYPE,
17        OBJECT-TYPE,
18        Integer32,
19        Counter32
20                FROM SNMPv2-SMI
21        TruthValue,
22        RowStatus
23                FROM SNMPv2-TC
24        InterfaceIndex
25                FROM IF-MIB
26        MODULE-COMPLIANCE,
27        OBJECT-GROUP
28                FROM SNMPv2-CONF
29        ciscoMgmt
30                FROM CISCO-SMI;
31
32
33ciscoGprsL2rlyMIB MODULE-IDENTITY
34        LAST-UPDATED    "9812150000Z"
35        ORGANIZATION    "Cisco Systems, Inc."
36        CONTACT-INFO
37                "       Cisco Systems
38                        Customer Service
39
40                Postal: 170 W Tasman Drive
41                        San Jose, CA  95134
42                        USA
43
44                   Tel: +1 800 553-NETS
45
46                E-mail: cs-gprs@cisco.com"
47        DESCRIPTION
48                "The MIB Module for managing the General Packet Radio
49                 Service(GPRS) L2RLY related information on Servicing
50                 GPRS Support Node(SGSN).
51                 In GPRS network, a SGSN is typically implemented as
52                 a single node; in cisco-Alcatel joint development,
53                 it's split into Telecom part (T-node) and Datacom
54                 part (D-node). T-nodes and D-nodes are connected
55                 by two fast ethernets. A simple connectionless protocol
56                 called L2RLY is used to provide service of forwarding
57                 packet between T-unit and D-unit, flow control and
58                 defending against the failure of a FE subnet.
59                "
60        ::= { ciscoMgmt 9993 }
61
62
63--  ******************************************************************
64-- Object definitions
65--  ******************************************************************
66
67ciscoGprsL2rlyObjects     OBJECT IDENTIFIER ::= { ciscoGprsL2rlyMIB 1 }
68
69ciscoGprsL2rlyConfig OBJECT IDENTIFIER ::= { ciscoGprsL2rlyObjects 1 }
70ciscoGprsL2rlyStats  OBJECT IDENTIFIER ::= { ciscoGprsL2rlyObjects 2 }
71
72--  ******************************************************************
73--  L2RLY Configurable  Parameters
74--  ******************************************************************
75
76cgprsL2rlyUid  OBJECT-TYPE
77    SYNTAX              Integer32 (0..64)
78    MAX-ACCESS          read-write
79    STATUS              current
80    DESCRIPTION
81        "L2 Relay unit identification.
82        "
83    DEFVAL { 32 }
84    ::= { ciscoGprsL2rlyConfig 1 }
85
86
87cgprsL2rlyUnitType  OBJECT-TYPE
88    SYNTAX      INTEGER {
89                datacomUnit(1),
90                telecomUnit(2)
91    }
92    MAX-ACCESS          read-write
93    STATUS              current
94    DESCRIPTION
95        " The type can be either a datacom unit, or a telecom unit.
96        "
97    ::= { ciscoGprsL2rlyConfig 2 }
98
99cgprsL2rlyEchoTimer  OBJECT-TYPE
100    SYNTAX              Integer32 (0..1000)
101    UNITS               "seconds"
102    MAX-ACCESS          read-write
103    STATUS              current
104    DESCRIPTION
105        "The frequency of transmission of self_id packet. This packet
106         is transmitted periodically, for keep-alive and auto discovery
107         purposes.
108        "
109    ::= { ciscoGprsL2rlyConfig 3 }
110
111
112cgprsL2rlyFlowControlFlag  OBJECT-TYPE
113    SYNTAX                   TruthValue
114    MAX-ACCESS               read-write
115    STATUS                   current
116    DESCRIPTION
117        "L2 Relay flow control function flag. 'on' means that the
118         flow control has been enabled, and 'off' means the converse.
119        "
120    ::= { ciscoGprsL2rlyConfig 4 }
121
122
123cgprsL2rlyDroppedPktsMonTime  OBJECT-TYPE
124    SYNTAX              Integer32 (0..65535)
125    UNITS               "seconds"
126    MAX-ACCESS          read-write
127    STATUS              current
128    DESCRIPTION
129         "The configurable time duration for monitoring the excessive rate
130          at which packets are dropped by the L2 Relay on SGSN due to traffic
131          congestion problem.
132         "
133    DEFVAL { 300 }
134    ::= { ciscoGprsL2rlyConfig 5 }
135
136cgprsL2rlyNoRespToKeepAliveMsgNotificationEnable  OBJECT-TYPE
137    SYNTAX              TruthValue
138    MAX-ACCESS          read-write
139    STATUS              current
140    DESCRIPTION
141    "The object  indicates  whether  the  system   produces the
142     cgprsL2rlyNoRespToKeepAliveMsgNotification. A false value will prevent
143     the cgprsL2rlyNoRespToKeepAliveMsgNotification  from being generated
144     by this system.
145    "
146    DEFVAL { true }
147    ::= { ciscoGprsL2rlyConfig 6 }
148
149cgprsL2rlyUnitJoinNotificationEnable  OBJECT-TYPE
150    SYNTAX              TruthValue
151    MAX-ACCESS          read-write
152    STATUS              current
153    DESCRIPTION
154    "The object  indicates  whether  the  system   produces the
155     cgprsL2rlyUnitJoinNotification. A false value will prevent
156     the cgprsL2rlyUnitJoinNotificationcgprs  from being generated
157     by this system.
158    "
159    DEFVAL { true }
160    ::= { ciscoGprsL2rlyConfig 7 }
161
162cgprsL2rlyInterfaceTable OBJECT-TYPE
163    SYNTAX              SEQUENCE OF CgprsL2rlyInterfaceEntry
164    MAX-ACCESS          not-accessible
165    STATUS              current
166    DESCRIPTION
167        "The table that lists the interfaces which l2rly is
168         using. Currently the table has just two and always two
169         entries. There is only one l2rly T or D unit on each router.
170         To ensure reliability and do load sharing, there
171         could be two fast ethernets among the l2rly units.
172         Thus each l2rly unit could interface with two fast ethernets.
173         At least one interface should be configured and working
174         in order for l2rly to work.
175        "
176    ::= { ciscoGprsL2rlyConfig 8 }
177
178cgprsL2rlyInterfaceEntry OBJECT-TYPE
179    SYNTAX              CgprsL2rlyInterfaceEntry
180    MAX-ACCESS          not-accessible
181    STATUS              current
182    DESCRIPTION
183        " The l2rly interface table entry.
184        "
185    INDEX    { cgprsL2rlyInterfaceId }
186    ::= { cgprsL2rlyInterfaceTable 1 }
187
188CgprsL2rlyInterfaceEntry ::= SEQUENCE {
189    cgprsL2rlyInterfaceId    InterfaceIndex,
190    cgprsL2rlyInterfaceRowStatus RowStatus
191}
192
193cgprsL2rlyInterfaceId OBJECT-TYPE
194    SYNTAX              InterfaceIndex
195    MAX-ACCESS          not-accessible
196    STATUS              current
197    DESCRIPTION
198        " The ifIndex for the corresponding interface which
199          l2rly is using.
200        "
201    ::= { cgprsL2rlyInterfaceEntry 1 }
202
203cgprsL2rlyInterfaceRowStatus OBJECT-TYPE
204    SYNTAX              RowStatus
205    MAX-ACCESS          read-create
206    STATUS              current
207    DESCRIPTION
208        " The status for row creation and deletion.
209        "
210    ::= { cgprsL2rlyInterfaceEntry 2 }
211
212-- **************************************************************
213-- L2RLY Statistics
214-- These stats are for SGSN only.
215-- **************************************************************
216
217cgprsL2rlyFlowControlTriggerCount  OBJECT-TYPE
218    SYNTAX              Counter32
219    MAX-ACCESS          read-only
220    STATUS              current
221    DESCRIPTION
222        "A running count indicating how many times L2 Relay
223         flow control has been trigerred.
224        "
225    ::= { ciscoGprsL2rlyStats 1 }
226
227
228cgprsL2rlyInputQLen  OBJECT-TYPE
229    SYNTAX              Counter32
230    UNITS               "packets"
231    MAX-ACCESS          read-only
232    STATUS              current
233    DESCRIPTION
234        "The L2 Relay input queue length.
235        "
236    ::= { ciscoGprsL2rlyStats 2 }
237
238
239cgprsL2rlyTotalPacketsDropped  OBJECT-TYPE
240    SYNTAX              Counter32
241    UNITS               "packets"
242    MAX-ACCESS          read-only
243    STATUS              current
244    DESCRIPTION
245        "Total number of packets dropped by L2 Relay due to unknown
246         headers since system startup.
247        "
248    ::= { ciscoGprsL2rlyStats 3 }
249
250cgprsL2rlyDroppedPktsTimeFrame  OBJECT-TYPE
251    SYNTAX              Integer32 (0..65535)
252    UNITS               "seconds"
253    MAX-ACCESS           read-only
254    STATUS               current
255    DESCRIPTION
256         "The time frame within which the number of L2 Relay packets, defined
257          by cgprsL2rlyDroppedPktsCount, are dropped.
258         "
259    ::= { ciscoGprsL2rlyStats 4 }
260
261cgprsL2rlyDroppedPktsCount  OBJECT-TYPE
262    SYNTAX              Counter32
263    UNITS               "packets"
264    MAX-ACCESS          read-only
265    STATUS              current
266    DESCRIPTION
267         "The number of packets dropped by L2 Relay on the SGSN
268          within cgprsL2rlyDroppedPktsTimeFrame.
269         "
270    ::= { ciscoGprsL2rlyStats 5 }
271
272cgprsL2rlyPeerTable OBJECT-TYPE
273    SYNTAX              SEQUENCE OF CgprsL2rlyPeerEntry
274    MAX-ACCESS          not-accessible
275    STATUS              current
276    DESCRIPTION
277        " The table lists all the l2rly units on the peer nodes
278          that directly connect with this l2rly units through
279          two fast ethernets.
280        "
281    ::= { ciscoGprsL2rlyStats 6 }
282
283cgprsL2rlyPeerEntry OBJECT-TYPE
284    SYNTAX              CgprsL2rlyPeerEntry
285    MAX-ACCESS          not-accessible
286    STATUS              current
287    DESCRIPTION
288        " L2rly unit peer entries.
289        "
290    INDEX    { cgprsL2rlyPeerUid, cgprsL2rlyInterfaceId }
291    ::= { cgprsL2rlyPeerTable 1}
292
293CgprsL2rlyPeerEntry ::= SEQUENCE {
294    cgprsL2rlyPeerUid               Integer32,
295    cgprsL2rlyPeerUnitType          INTEGER
296    }
297
298cgprsL2rlyPeerUid OBJECT-TYPE
299    SYNTAX      Integer32 (0..64)
300    MAX-ACCESS  not-accessible
301    STATUS      current
302    DESCRIPTION
303        " The Uid that uniquely identify the peer l2rly unit that
304          connects to the same fast ethernets as this l2rly unit.
305        "
306    ::= { cgprsL2rlyPeerEntry 1 }
307
308cgprsL2rlyPeerUnitType OBJECT-TYPE
309    SYNTAX      INTEGER {
310                datacomUnit(1),
311                telecomUnit(2)
312    }
313    MAX-ACCESS          read-only
314    STATUS              current
315    DESCRIPTION
316        " The type of the peer l2rly on other devices which connects
317          to the same fast ethernets as this one.
318        "
319    ::= { cgprsL2rlyPeerEntry 2 }
320
321
322-- ******************************************************************
323-- Trap definitions
324-- ******************************************************************
325
326ciscoGprsL2rlyNotificationPrefix OBJECT IDENTIFIER ::= { ciscoGprsL2rlyMIB 2 }
327ciscoGprsL2rlyNotifications      OBJECT IDENTIFIER ::= { ciscoGprsL2rlyNotificationPrefix 0 }
328
329cgprsL2rlyUnitJoinNotification  NOTIFICATION-TYPE
330    OBJECTS {
331           cgprsL2rlyUid
332    }
333    STATUS current
334    DESCRIPTION
335    "This trap indicates that a new 'SGSN T-node' joins the service.
336     This happens when a new SGSN node restarts or the network
337     problem (fast ethernets among the units) recovers.
338    "
339    ::= { ciscoGprsL2rlyNotifications 1 }
340
341
342cgprsL2rlyNoRespToKeepAliveMsgNotification  NOTIFICATION-TYPE
343    OBJECTS {
344           cgprsL2rlyUid
345    }
346    STATUS current
347    DESCRIPTION
348    "This trap indicates that the 'SGSN T-node' failed to respond to
349     the L2 Relay 'Keep Alive' message. The cgprsL2rlyUid variable identifies
350     the  'SGSN T-node' that failed to respond.
351    "
352    ::= { ciscoGprsL2rlyNotifications 2 }
353
354
355-- ******************************************************************
356-- Conformances
357-- ******************************************************************
358
359ciscoGprsL2rlyConformances OBJECT IDENTIFIER ::= { ciscoGprsL2rlyMIB 3 }
360
361cgprsL2rlyCompliances      OBJECT IDENTIFIER ::= { ciscoGprsL2rlyConformances 1}
362cgprsL2rlyGroups           OBJECT IDENTIFIER ::= { ciscoGprsL2rlyConformances 2}
363
364-- compliance statements
365
366cgprsL2rlyCompliance MODULE-COMPLIANCE
367    STATUS current
368    DESCRIPTION
369        " The compliance statement for entities which implement the
370          CISCO GPRS L2RLY MIB.
371        "
372    MODULE
373        MANDATORY-GROUPS { cgprsL2rlyConfigGroup,
374                           cgprsL2rlyStatsGroup
375                         }
376        ::= {cgprsL2rlyCompliances 1}
377
378-- units of conformance
379
380cgprsL2rlyConfigGroup OBJECT-GROUP
381    OBJECTS { cgprsL2rlyUid,
382              cgprsL2rlyUnitType,
383              cgprsL2rlyEchoTimer,
384              cgprsL2rlyFlowControlFlag,
385              cgprsL2rlyDroppedPktsMonTime,
386              cgprsL2rlyNoRespToKeepAliveMsgNotificationEnable,
387              cgprsL2rlyUnitJoinNotificationEnable,
388              cgprsL2rlyInterfaceRowStatus
389             }
390    STATUS current
391    DESCRIPTION
392        " A collection of configurable parameters for L2RLY.
393        "
394    ::= { cgprsL2rlyGroups 1}
395
396
397cgprsL2rlyStatsGroup OBJECT-GROUP
398    OBJECTS { cgprsL2rlyFlowControlTriggerCount,
399              cgprsL2rlyInputQLen,
400              cgprsL2rlyTotalPacketsDropped,
401              cgprsL2rlyDroppedPktsTimeFrame,
402              cgprsL2rlyDroppedPktsCount,
403              cgprsL2rlyPeerUnitType
404            }
405    STATUS current
406    DESCRIPTION
407       " A collection of stats for L2RLY."
408    ::= { cgprsL2rlyGroups 2 }
409
410
411END
412