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
|
-- *****************************************************************
-- Juniper Enterprise Specific MIB: EX-MAC-NOTIFICATION
--
-- Copyright (c) 2008-2010, Juniper Networks, Inc.
-- All rights reserved.
--
-- The contents of this document are subject to change without notice.
-- *****************************************************************
JUNIPER-EX-MAC-NOTIFICATION-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, Counter64, NOTIFICATION-TYPE,
Unsigned32, TimeTicks, OBJECT-IDENTITY
FROM SNMPv2-SMI
TruthValue
FROM SNMPv2-TC
jnxMacNotificationRoot
FROM JUNIPER-EX-SMI;
jnxMacNotificationMIB MODULE-IDENTITY
LAST-UPDATED "201004280000Z"
ORGANIZATION "Juniper Networks, Inc."
CONTACT-INFO
"Juniper Technical Assistance Center
Juniper Networks, Inc.
1133 Innovation Way
Sunnyvale, CA 94089
E-mail: support@juniper.net"
DESCRIPTION
"This MIB module is for configuration of the MAC notification
feature. MAC notification is a mechanism to inform monitoring
devices when there are MAC addresses learnt or removed from
the forwarding database of the monitored devices."
--revision history
REVISION "200901200000Z"
DESCRIPTION
"Initial revision."
REVISION "200905270000Z"
DESCRIPTION
"Updated the description of the Objects."
REVISION "201002090000Z"
DESCRIPTION
"Updated the description of jnxHistMacChangedMsg. When next hop gets
changed the port information gets updated and is logged."
REVISION "201004280000Z"
DESCRIPTION
"Added new scalar jnxMacAddressesUpdated which increments for each
mac address updated."
::= { jnxMacNotificationRoot 1 }
-- Juniper MAC Notification MIB object definitions
jnxMacNotificationMIBObjects OBJECT IDENTIFIER
::= { jnxMacNotificationMIB 1 }
jnxMacNotificationMIBGlobalObjects OBJECT IDENTIFIER
::= { jnxMacNotificationMIBObjects 1 }
--**********************************************************************
-- Juniper Mac Notification Global Group
--**********************************************************************
jnxMacGlobalFeatureEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates whether the MAC notification feature is currently
running in the device.
Setting this object to false(2) disables the MAC notification
feature globally.
Setting this object to true(1) will start the MAC notification
feature running in the device. If the feature is already
running, setting to true(1) has no effect. "
::= { jnxMacNotificationMIBGlobalObjects 1 }
jnxMacNotificationInterval OBJECT-TYPE
SYNTAX Unsigned32 (0..4294967295)
UNITS "seconds"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object specifies the maximum interval of time between
jnxMacChangedNotifications being generated by the device.
If the value of jnxNotificationsEnabled is true(1), the
device will send out the generated jnxMacChangedNotifications
and archive the MAC change notification events in the
jnxMacHistoryTable. If the value of jnxNotificationEnabled is
false(2), the device will not send out the generated
jnxMacChangedNotifications but it will archive these events
in the jnxMacHistoryTable.
If the value of this object is equal to 0, the device will
generate jnxMacChangedNotifications and archive the MAC
change notification events in the jnxMacHistoryTable as soon as
there is MAC address learnt or removed by the device.
If the value of this object is greater than 0, the device will
wait for a period of time equal to the value of this object
before generate the jnxMacChangedNotifications and archive
the MAC change notification events in the jnxMacHistoryTable."
DEFVAL { 30 }
::= { jnxMacNotificationMIBGlobalObjects 2 }
jnxMacAddressesLearnt OBJECT-TYPE
SYNTAX Counter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the number of MAC addresses learnt by the
device."
::= { jnxMacNotificationMIBGlobalObjects 3 }
jnxMacAddressesRemoved OBJECT-TYPE
SYNTAX Counter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the number of MAC addresses removed from the
forwarding database."
::= { jnxMacNotificationMIBGlobalObjects 4 }
jnxMacNotificationsEnabled OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates whether jnxMacChangedNotification notifications
will or will not be sent when there are MAC addresses
learnt or removed from the device's forwarding database.
Disabling notifications does not prevent the MAC address
info from being added to the jnxMacHistoryTable."
DEFVAL { false }
::= { jnxMacNotificationMIBGlobalObjects 5 }
jnxMacNotificationsSent OBJECT-TYPE
SYNTAX Counter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the number of jnxMacChangedNotifications sent out
by the device."
::= { jnxMacNotificationMIBGlobalObjects 6 }
jnxMacHistTableMaxLength OBJECT-TYPE
SYNTAX Unsigned32 (0..500)
UNITS "entries"
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The upper limit on the number of entries that the
jnxMacHistoryTable may contain. A value of 0 will
prevent any history from being retained. When this
table is full, the oldest entry will be deleted and
a new one will be created."
DEFVAL { 256 }
::= { jnxMacNotificationMIBGlobalObjects 7 }
jnxMacHistoryTable OBJECT-TYPE
SYNTAX SEQUENCE OF JnxMacHistoryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table will archive the MAC change notification events
generated by this device. The MAC change notification
events are archived here even if jnxMacChangesNotifications
are not actually sent."
::= { jnxMacNotificationMIBGlobalObjects 8 }
jnxMacHistoryEntry OBJECT-TYPE
SYNTAX JnxMacHistoryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A MAC change notification message that was previously
generated by this device. Each entry is indexed by a message
index."
INDEX { jnxHistIndex }
::= { jnxMacHistoryTable 1 }
JnxMacHistoryEntry ::=
SEQUENCE {
jnxHistIndex
Unsigned32,
jnxHistMacChangedMsg
OCTET STRING,
jnxHistTimestamp
TimeTicks
}
jnxHistIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An index that uniquely identifies a MAC change notification
event previously generated by the device. This index starts at
1 and increases by one when a MAC change notification is
generated. When it reaches the maximum value, the agent wraps
the value back to 1."
::= { jnxMacHistoryEntry 1 }
jnxHistMacChangedMsg OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(1..512))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object contains the information of a MAC change
notification event. It consists of several tuples packed
together in the format of '<tuple1><tuple2>...'.
Each tuple consist of 13 octets in the format of
'<operation><VLAN><MAC><dot1dBasePort>' where
<operation> is of size 1 octet and supports the following values
0 - End of MIB object.
1 - MAC learnt.
2 - MAC removed.
3 - MAC updated.
<VLAN> is VLAN number of the VLAN which the MAC address is
belonged to and has size of 2 octet.
<MAC> is the Layer2 Mac Address and has size of 6 octets.
<dot1dBasePort> is the value of dot1dBasePort for the
interface from which the MAC address is learnt and has size
of 4 octets."
::= { jnxMacHistoryEntry 2 }
jnxHistTimestamp OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The value of sysUpTime when the jnxMacChangedNotification
containing the information denoted by the jnxHistMacChangedMsg
object in this entry was generated."
::= { jnxMacHistoryEntry 3 }
jnxMacAddressesUpdated OBJECT-TYPE
SYNTAX Counter64
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the number of MAC addresses updated by the
device."
::= { jnxMacNotificationMIBGlobalObjects 9 }
-- ***********************************************************
-- Mac NOTIFICATIONS
-- ***********************************************************
jnxMacNotifications OBJECT IDENTIFIER ::= { jnxMacNotificationRoot 2 }
jnxMacNotificationsPrefix OBJECT-IDENTITY
STATUS current
DESCRIPTION
"All Mac Notifications are registered
under this branch."
::= { jnxMacNotifications 0 }
jnxMacChangedNotification NOTIFICATION-TYPE
OBJECTS { jnxHistMacChangedMsg, jnxHistTimestamp }
STATUS current
DESCRIPTION
"This notification is generated when there is enough MAC
address information to fully occupy a maximum size SNMP trap
message. This notification is also generated when there
is at least one MAC address changed or removed and the amount
of time elapsed from the previous notification is greater
than the maximum wait time denoted by
jnxNotificationInterval object.
If there are more MAC addresses information than can fit into
one cmmHistTrapContent object, then multiple notifications
will be generated."
::= { jnxMacNotificationsPrefix 1 }
END
|
